v201003 beta , ReportDefinitionService- Structure report not included ?

60 views
Skip to first unread message

Alex Parij

unread,
May 26, 2010, 10:21:26 AM5/26/10
to AdWords API Forum
Hi ,

I just read the new docs for 201003 beta and I could not find
Structure report .
Are there any plans to include it in the next version or is it going
to be deprecated with v13 ?

Thanks !


Alexander Parij

Alex Parij

unread,
May 26, 2010, 10:28:43 AM5/26/10
to AdWords API Forum
Also just general comment on the docs , for the fields you ask to
"To find out which report fields are available based on report type
and your account features, call getReportFields."
It would be nice if you included a list of all possible fields and
just stated that the availability of some fields depends on the
account.

Thanks

Clay

unread,
May 26, 2010, 3:49:21 PM5/26/10
to AdWords API Forum
More generally, how do we keep our list of accounts/campaigns/adgroups/
ad/keywords in sync with yours in the new API? In the past, it hasn't
been feasible to do this via individual API calls.

Keep in mind that there are times when we need the account structure
before there are any impressions for automated URL tagging, so
performance reports are not an option in this case.

-Clay

Alex Parij

unread,
May 28, 2010, 10:42:00 AM5/28/10
to AdWords API Forum
Any contact at google where I can get these questions answered ?

AdWords API Advisor

unread,
May 28, 2010, 12:39:52 PM5/28/10
to AdWords API Forum
Hi All,

The v201003 ReportDefinitionService beta doesn't include an
AccountStructure report. However, the new reports by default include
zero-impression rows for keywords, ad groups, etc, which allows you to
get the account structure data using the performance reports.

As for the report fields, I'll discuss listing these in the
documentation with our tech writer.

Best,
- Eric Koleda, AdWords API Team

Alex Parij

unread,
May 28, 2010, 1:27:36 PM5/28/10
to AdWords API Forum
Thanks Eric !

I just hope that the KeywordIsNegative field from AccountStructure is
included in v2010 otherwise Keyword Performance is not fully replacing
AccountStructure.


On May 28, 12:39 pm, AdWords API Advisor

Reed

unread,
Jun 2, 2010, 3:08:20 PM6/2/10
to AdWords API Forum
Any updates on how we should expect to handle negative keywords in
V2010 when we use the zero-impressions option to try and mimic the
results of the V13 structure reports? Structure Reports have turned
out to be a great feature, especially at the keyword level, for
getting all of the data for an account in a cheap, easy, manner. I'd
hate to see them go away, but if they do I need to know how to handle
negatives.

BTW, is the only way in V2010 to get the list of report fields for the
reporting service SOAP calls to perform the getReportFields API call?
Is that information not in the docs anywhere? Does this mean that the
data items are named the same (including case) in both the SOAP
request and the returned XML doc? How would we know when new fields
are added, without doing periodic calls and comparing the results?

thanks,
-reed

Alex Parij

unread,
Jun 2, 2010, 3:31:14 PM6/2/10
to AdWords API Forum
Hey Reed ,

From what I understand reading the docs regarding the negatives
We will have to call for 2 reports instead of one
KEYWORDS_PERFORMANCE_REPORT
ADGROUP_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT :(

On the positive note they offer another report which did not exist
before
CAMPAIGN_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT

But of course it's better to get the official response

AdWords API Advisor

unread,
Jun 7, 2010, 4:01:44 PM6/7/10
to AdWords API Forum
Hi All,

As for negative keywords, the KEYWORDS_PERFORMANCE_REPORT includes a
field called IsNegative, which you can use to determine if a keyword
is negative or not. You can filter out negative keywords or zero
impression keywords by using an appropriate predicate.

Best,
- Eric

Peter

unread,
May 26, 2011, 11:05:20 PM5/26/11
to adwor...@googlegroups.com
Hey Eric,

Sorry to revive an old thread, but can you confirm that this actually works in the v201008 API. I've been requesting keyword performance reports on an account which has negative keywords and not been receiving any results. Your help would be appreciated. Here is an example of the report selector.

{
        'operator': 'ADD',
        'operand': {
            'xsi_type': 'ReportDefinition',
            'reportName': 'keyword performance report',
            'dateRangeType': 'CUSTOM_DATE',
            'reportType': 'KEYWORDS_PERFORMANCE_REPORT',
            'downloadFormat': 'GZIPPED_CSV',
            'selector': {
                'fields': ['Date', 'KeywordText', 'KeywordMatchType', 'IsNegative', 'QualityScore', 'Impressions', 'Clicks', 'Cost', 'Conversions'],
                'predicates': [{'field': 'CampaignStatus', 'operator': 'EQUALS', 'values': ['ACTIVE']},
                               {'field': 'AdGroupStatus', 'operator': 'EQUALS', 'values': ['ENABLED']},
                               {'field': 'IsNegative', 'operator': 'EQUALS', 'values': ['TRUE']}],
                'dateRange': {
                    'min': start_date,
                    'max': end_date
                }
            }
        }

And the resulting report which contains no data

"keyword performance report (Feb 26, 2011-May 27, 2011)"
Day,Keyword,Match type,Is negative,Quality score,Impressions,Clicks,Cost,Conv. (1-per-click)
Total, --, --, --, --,0,0,0.00,0

Please let me know what I'm doing wrong. Thanks.

Peter

Eric Koleda

unread,
May 27, 2011, 4:00:43 PM5/27/11
to adwor...@googlegroups.com
Hi Peter,

Including a segmentation field such as "Date" removes any zero-impression rows from your report.  You have a predicate which is filtering for IsNegative = TRUE, but negative keywords can't receive impressions, so an empty result would be expected.

Best,
- Eric

Peter

unread,
May 27, 2011, 8:15:35 PM5/27/11
to adwor...@googlegroups.com
Hey Eric,

Thanks for letting me know about the segmentation field "Date" being the cause for the negatives / 0 impression data from not showing up. Just to clarify I've tested with isNegative = TRUE and only the negative keywords are coming back now, which is what I was hoping for so that's great. Thanks again for the quick response and clarifying that.

Peter

Alexander Parij

unread,
May 30, 2011, 11:29:58 AM5/30/11
to adwor...@googlegroups.com
Hi Eric ,

Removing  Date and Impression fields will not return me zero impressions keywords,  it returns something but can't figure out what it returns. It's less keywords than the report with Impressions field but the keywords that are returned are in fact with impressions.
Report Id is 61819852

Thanks

Alexander Parij

Alexander Parij

unread,
May 31, 2011, 9:56:03 AM5/31/11
to adwor...@googlegroups.com
Nvm , I got it.
Just removing network predicate will give me the zero impression keywords. Not sure why it's related but this type of knowledge should be documented because the new api is a bit unintuitive .

Thanks!

Alexander Parij
Reply all
Reply to author
Forward
0 new messages