KeywordIsNegative column in Keyword Structure reports

33 views
Skip to first unread message

AdWords API Advisor

unread,
Sep 29, 2008, 3:27:15 PM9/29/08
to AdWords API Forum
A bit of good news for all the Structure reports users out there who
have been patiently awaiting enhanced functionality: an additional
column has just been added to Structure reports with aggregationTypes
set to "Keyword" (i.e. Keyword Structure reports). This column can be
used to determine whether a given keyword in the report is "normal" or
negative, and resolves a long-standing deficiency that made it
impossible to distinguish normal and negative keywords in Keyword
Structure reports.

This new column isn't reflected in the docs quite yet, but it is live
for reports scheduled with v12 of the AdWords API. To request this
column in your Keyword Structure reports, include KeywordIsNegative as
one of your selectedColumns. The response XML in the report will refer
to this column's values as "kwisnegative".

For example:

<scheduleReportJob xmlns='https://adwords.google.com/api/adwords/
v12'>
<job xsi:type='DefinedReportJob'>
<name>Keyword Structure</name>
<aggregationTypes>Keyword</aggregationTypes>
<selectedReportType>Structure</selectedReportType>
<selectedColumns>CampaignId</selectedColumns>
<selectedColumns>AdGroupId</selectedColumns>
<selectedColumns>Keyword</selectedColumns>
<selectedColumns>KeywordIsNegative</selectedColumns>
</job>
</scheduleReportJob>

will result in reports whose rows look like:

<row campaignid="12345" adgroupid="123456" keyword="normal keyword
test" kwisnegative="False">
<row campaignid="12345" adgroupid="123456" keyword="negative keyword
test" kwisnegative="True">

We've heard a lot from developers about reports in general and
Structure reports in particular, and this additional column is just
the first step being made to address that feedback.

Cheers,
-Jeff Posnick, AdWords API Team
Reply all
Reply to author
Forward
0 new messages