Audience Performance Report

[edu...@raccoon.ag]

Hi, I am using the Audience Performance Report in the Adwords scripts. I was able to get the report data successfully: CampaignName, AdGroupName and Cost. I also know how to manipulate the data. Unfortunately I am not being able to get the audience names. I have 4 remarketing lists by adgroup and I need to get the name of them by the row of the report. How can I do that ? I wasn't able to find the name in the table at https://developers.google.com/adwords/api/docs/appendix/reports#audience.

I read something about implicit segmentation but I didn't understand so well.

Thanks!

[Alexander Wang]

Hi there,

I think you may want to request the "Criteria" field? It's row in that table is:

Criteria

Audience

audience

String

True

True

Attribute

Descriptive string for the Criterion.

The only other field that looks like it might be of use is the "Id" field.

You shouldn't worry about segmentation (none of the fields you're requesting are "segmentation" fields). You can read up on it here if you're interested. Basically it's a way of making your data more granular. If you want to see how your audiences perform by day of the week, you can request the "DayOfWeek" column. Including this column would "segment" your report. Each audience in your account would then show up 7 times (once per day of the week). This allows you to see if certain audiences do better on weekends than on Wednesdays (for example). I believe that any fields that show up on that reports page in red are segmentation fields (blue are attributes while green are stats). If you want your report to contain one row per audience, then you'll want to avoid requesting any segmentation fields.

Cheers,

Alex

[edu...@raccoon.ag]

Hello Alex!

I forgot to mention that I tried "Criteria" but instead of getting the name of the audience's lists that has been created, I get a string like this:

boomuserlist::5776946

I need the name of the audiences to follow the stats and to change the bids later.

Thank you!

[Alexander Wang]

Ah I see,

Unfortunately, I don't think this is easily doable then. I think you'd need to do the mapping yourself. That ID can be found in the UI. If you go to the audiences table in the shared library and click on an audience you can see its "List ID" in the "Summary" panel at the top. One of your audiences will have a List ID of 5776946. I don't know how many audiences you have, but if the number is small, you could hard-code this mapping somewhere in your script and convert the Criteria strings into meaningful names.

I'll take a look and see if we can convert these strings automatically, but not sure how long that will take. I think it makes sense for us to do it since if you download this same report from the UI, it prints out the name of the audience rather than "boomuserlist::LIST_ID".

Cheers,

Alex

[edu...@raccoon.ag]

Thanks Alex! I did this today and it was no trouble because I had only 4 audiences, so I've used a simple switch/case and converted the number after parsing the string. There is a way to suggest to the Google Development team to include this attribute? Thanks!

[Alexander Wang]

Nice! Happy to hear that works for you.

Considering I work at Google on the AdWords scripts product I can certainly make sure to record that as a suggestion :)

Cheers,

Alex

[Diego Casabe]

Hi @Alexander Wang, 

Is there a way to solve this nowadays? For a big amount of audiences, its complicated to link the list ID to the Audience Name. Is there a way to automate this process?

Best

Diego Casabe

[Alexander Wang]

Hi Diego,

Sorry, but there's still not a great way to automate that. Something you could do is download the report from the UI (i.e. go to the audiences tab or the Display Network > Interests & Remarketing tab and click download). You can include the column 'Criterion ID' (It's currently under "Attributes" in the column customization widget). If you save this report to your google Drive, you could parse the report and map Criterion Id -> Audience Name and then when you fetch the AUDIENCE_PERFORMANCE_REPORT, you can request Id (this is the same as Criterion ID in the UI) you can map it to Audience name.

I realize this isn't great since you'd need to re-download the UI report whenever audiences are added to new ad groups, but it's the best that can be done via Scripts at the moment. I'll make sure to update this thread when we have a truly automate-able solution for this problem.

Cheers,

Alex

[David Cabanillas]

I believe that right now we can use

UserListName

[Tyler Sidell (AdWords Scripts Team)]

Thank you David.  If you have any any questions, feel free to open a new thread.

Regards,

Tyler Sidell

AdWords Scripts Team