How to fetch Household Income/Demographic Data through Adwords API?

1,325 views
Skip to first unread message

Ronak Shah

unread,
Aug 22, 2018, 7:05:57 AM8/22/18
to AdWords API and Google Ads API Forum
Hello,

How to download Household Income Report Stats through Adwords API? We Tried CRITERIA_PERFORMANCE_REPORT with CriteriaType INCOME_RANGE but the report comes blank and also we cannot see any Report Types for getting Household Income data?

Please let us know how to get the Income Report data

Regards,
Ronak

Bharani Cherukuri (AdWords API Team)

unread,
Aug 22, 2018, 1:55:17 PM8/22/18
to AdWords API and Google Ads API Forum
Hello Ronak, 

You will be able to use the Criteria Performance Report by specifying the CriteriaType as INCOME_RANGE to pull the Household Income statistics. The Criteria Performance Report aggregates statistics at Ad group criteria level, one row per ad group and criteria combination. Could you please share the report query along with the client customer Id so I can take a closer look? You can reply back via Reply privately to author option. 

Thanks,
Bharani, AdWords API Team

Bharani Cherukuri (AdWords API Team)

unread,
Aug 23, 2018, 2:28:08 PM8/23/18
to AdWords API and Google Ads API Forum
Hello Ronak, 

Thank you for sharing the details privately. I was able to replicate the issue you're describing. Based on this help center article, the household income is only supported for Video campaigns in the old AdWords UI. It is supported for Display, Search and Video campaigns campaigns in the new UI. Currently, the AdWords API is only able to display the same data as the old AdWords UI. In your case, you don't have any video campaigns, that's why you're not seeing income range. I have raised this issue with the team. I will keep you posted as soon as I have an update. 

Thanks,
Bharani, AdWords API Team

On Wednesday, August 22, 2018 at 7:05:57 AM UTC-4, Ronak Shah wrote:

GDZ

unread,
Oct 2, 2018, 5:37:12 PM10/2/18
to AdWords API and Google Ads API Forum
Hello Bharani, 

are their any updates on household income reports? 

Thank you!

Ronak Shah

unread,
Oct 3, 2018, 2:56:37 AM10/3/18
to AdWords API and Google Ads API Forum
Yes, even I am waiting for this update, this is needed I am surprised why this report is not supported?

Bharani Cherukuri (AdWords API Team)

unread,
Oct 3, 2018, 3:09:15 PM10/3/18
to AdWords API and Google Ads API Forum
Hello, 

Currently, we have no new updates from the team. I will update this thread as soon as I have any new updates.

Thanks,
Bharani, AdWords API Team

On Wednesday, August 22, 2018 at 7:05:57 AM UTC-4, Ronak Shah wrote:

James Nixon

unread,
Dec 17, 2019, 11:35:41 AM12/17/19
to AdWords API and Google Ads API Forum
Looking for an update on this specific issue. We need to be able to use the API to match the current version of the UI

Google Ads API Forum Advisor Prod

unread,
Dec 17, 2019, 3:47:50 PM12/17/19
to jni...@condati.com, adwor...@googlegroups.com
Hi James, 

Could you please confirm if you're using AdWords API or Google Ads API? This will help me address this concern. 

Thanks,
Bharani, Google Ads API Team

ref:_00D1U1174p._5001UOEjvh:ref

James Nixon

unread,
Dec 17, 2019, 3:55:15 PM12/17/19
to Google Ads API Forum Advisor Prod, adwor...@googlegroups.com
We are using the Adwords API
--


This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. If you have received this email in error please notify the system manager. This message contains confidential information and is intended only for the individual named. If you are not the named addressee you should not disseminate, distribute or copy this e-mail. Please notify the sender immediately by e-mail if you have received this e-mail by mistake and delete this e-mail from your system. If you are not the intended recipient you are notified that disclosing, copying, distributing or taking any action in reliance on the contents of this information is strictly prohibited.

Google Ads API Forum Advisor Prod

unread,
Dec 17, 2019, 4:42:45 PM12/17/19
to jni...@condati.com, adwor...@googlegroups.com
Hello James, 

Thank you for clarifying this. The AdWords API is only able to display the same data as the old AdWords UI. It is likely that this will be fixed in the AdWords API. You could explore the option of trying this with the new Google Ads API and see if you can fetch the Income/demographic data through the API. 

Regards,

James Nixon

unread,
Jan 21, 2020, 12:55:19 PM1/21/20
to AdWords API and Google Ads API Forum
I've worked through the issues with the google ads API and now have it running, but there is little documentation in terms of mapping available from the UI to the API using AdWords Query Language.. 

In the Google Ads API, how can i get the same information for Demographics (Parental Status, Age, Household Income, Gender) from the UI. What are those fields called: 

Google Ads API Forum Advisor Prod

unread,
Jan 21, 2020, 4:40:33 PM1/21/20
to jni...@condati.com, adwor...@googlegroups.com
Hi James,

Using AdWords API, you can look at the field name's Display name to see what the field should be name in the UI. For example, Criteria for the Age Range Performance Report will show as Age range in the UI. This guide shows what API report maps to what in the UI.

You can use this guide to see what API reports from AdWords API map to which reports in Google Ads API. While there is no Household income report currently, you can use the parental_status_view, age_range_view and gender_view respectively. 

Cheers,
Anthony

James Nixon

unread,
Jan 21, 2020, 4:45:47 PM1/21/20
to Google Ads API Forum Advisor Prod, adwor...@googlegroups.com
this is about the Google Ads API, not the Adwords API. 

Can you provide similar guidance for the Ads API? I was told to switch to the Ads API by someone on the support threads to retrieve household income data. 

Google Ads API Forum Advisor Prod

unread,
Jan 22, 2020, 10:35:48 AM1/22/20
to jni...@condati.com, adwor...@googlegroups.com
Hi James,

As I mentioned, there is no Google Ads API report for household income. You can use the reports I mentioned to get data on parental status, age range and gender.

You can follow our blog for any updates.

Regards,
Reply all
Reply to author
Forward
0 new messages