Audience Performance Report, UserListName showing ' --' instead of real value

[Oksana Sulyma]

Hi guys!
I pull 'Audience Performance Report' https://developers.google.com/adwords/api/docs/appendix/reports/audience-performance-report. The fields are:
                "CampaignId",
                "AdGroupId",
                "Criteria",
                "Id",
                "AdNetworkType1",

                "ClickType",
                "Device",
                "CriteriaDestinationUrl",
                "Status",
                "BidType",

                "Date",
                "ActiveViewImpressions",
                "Clicks",
                "ConversionValue",
                "Conversions",
                "Cost",
                "Impressions",
                "UserListName"

The UserListName (User list name) is different from what I see on Google Adwords side.

In report I see two kinds of 'User list names': ' --' and 'All visitors', while on Adwords side there are 'User list names' like 'All visitors', 'Real Estate', 'New Houses (For Sale)', etc.

Is there any idea why I receive ' --' User list names in 'Audience Performance Report' instead of real names? Any issues with fields grouping or fields view permissions?

Thanks to everybody who can bring some light on this issue!


[Shwetha Vastrad (AdWords API Team)]

Hi, 

If you have added In-market or affinity categories (uservertical), the UserListName for these audiences will be null. Could you provide your clientCustomerId and some sample rows where UserListName is " --" so I can take a look? 

Thanks,
Shwetha, AdWords API Team.

[Oksana Sulyma]

Thanks Shwetha! I've sent you clientCustomerId and some sample rows to check in private message. Looking forward to hearing from you!

[Shwetha Vastrad (AdWords API Team)]

Hi Oksana,

The rows where the UserListName is " --" in the API report correspond to In-market categories, not UserLists. You need to use ConstantDataService.getUserInterestCriterion method to retrieve the userInterestName for the In-market categories. For example, uservertical::80131 corresponds to "Real Estate" and uservertical::80166 corresponds to "New Houses (For Sale)". You can also use the CSV file provided here to get this data. We highly recommended that you cache the results of this call as the data set is large and changes infrequently.

Regards,

Shwetha, AdWords API Team.

[Oksana Sulyma]

Thanks Shwetha!

So my goal is to have the same User List Names which are shown on Adwords site.

Please confirm if I understand the rule correct: 
If I see Criteria (Audience) like uservertical::80131 in Adwords Report, I can assume that User List Name is "Real Estate"  which is correspondent value from here. Is there one to one relation between Criteria (Audience) and User List Name?

Thanks so much!
Oksana



[Shwetha Vastrad (AdWords API Team)]

Hi Oksana,

Yes, if the Criteria (Audience) in Audience Performance Report is in the form "uservertical::#####", this corresponds to CriterionUserInterest and you need to get the name of this user interest using ConstantDataService. There is a 1-1 mapping between UserInterestName and Criterion. 

[Oksana Sulyma]

Thanks for your complete answers Shwetha!

[Oksana Sulyma]

Hi Shwetha!
One more question.
You write: "You can also use the CSV file provided here to get this data. We highly recommended that you cache the results of this call as the data set is large and changes infrequently." How can I know that the data was updated? Is this something updated with new API versions? Or how frequently would you recommend to me to renew this info in my application?
Thanks!

[Shwetha Vastrad (AdWords API Team)]

Hi Oksana,

I'm afraid there isn't a way to check if the data was updated. This data doesn't necessarily change with each new API version. You can renew this data maybe once a week. This data changes infrequently, when new criteria are added. 

[Oksana Sulyma]

Thanks Shwetha, this helps much!

[Oksana Sulyma]

Hi guys,
I have another question related to this topic.
So I faced the case when UserListName is empty for affinity categories.
Is there any way to get this information https://developers.google.com/adwords/api/docs/appendix/affinity_categories.csv from Adwords API?
Also is there any way to get list of Custom affinity audiences mentioned here https://support.google.com/adwords/answer/2497941?
Thanks!

[Shwetha Vastrad (AdWords API Team)]

Hi Oskana,

Yes, the UserListName will be empty in the Audience Performance Report for affinity categories as well. The Affinity categories are not yet supported in ConstantDataService. You'll need to use the CSV file provided here to retrieve the complete name of these affinity categories. AdWords API doesn't support custom affinity audiences at the moment. Please keep any eye on our blog for any updates regarding this feature.

[Oksana Sulyma]

Thanks Shwetha, this information helps. How often the content of file provided here changes? Thanks!

[Oksana Sulyma]

Thanks Shwetha, this information helps. How often the content of file provided here changes? Thanks!

[Shwetha Vastrad (AdWords API Team)]

Hi Oksana, 

The Affinity categories reference codes changes infrequently. Please keep an eye on our blog for any updates about new category codes being added. 

[Oksana Sulyma]

Thanks for your help Shwetha!

[za...@wavo.me]

4 years later and this is still unresolved isn't it....

You cannot expect users to make an 2nd API call just to get the name of an audience in the audience report?

[Google Ads API Forum Advisor Prod]

Hi Za,

Thanks for reaching out. With regards to your concern, can you please provide the customer id ans screenshot of the UI so that i can further investigate issue. Please reply privately to the author option while sharing details.

Thanks,
Nirmita Patel Google Ads Team

ref:_00D1U1174p._5004Q23IH4o:ref