Reporting has changed significantly with AdWords API v201109. Google recommends using “Ad Hoc reports” to download new reports.
“With this new feature, there is no need for stored ReportDefinitions. The XML describing a Report Definition is sent directly with report download. A developer token is required, but the API call accrues no costs (report downloads are now free!),” explains Kevin Winter, AdWords API Team.
“Another benefit of downloading reports in this fashion is you get data more quickly than with legacy cross-client reports. As soon as a report download succeeds, you can start processing the data by putting it into a database or performing further logic on the results,” added Winter.
He said, “To download reports for a large number of client accounts, we recommend requesting the download of these reports simultaneously — ‘no more than 10 reports concurrently and to use one thread for each concurrent download’.”
“If for some reason the report download fails, you should check the specific reason the download failed and only retry if it was a transient error (such as exceeding the rate limit) instead of retrying if the report definition XML was invalid.” The HTTP Status of the response provides useful information:
- “HTTP Status 500 indicates there is a transient server side issue and the request can be retried after a delay. We retrying no more than 5 times for any given report.
- HTTP Status 400 indicates there was a problem with the request (or the report itself) and retrying will not help.
- HTTP Status 200 means the report download was successful,” explains Winter.
In other AdWord related news,
Google announced that “By the end of this year, advertisers accessing the AdWords web interface using Internet Explorer 6, will be required to use Internet Explorer 7 or 8, or any other compatible browser to log in into their account.
As, accessing AdWords with IE6, you’ll see a notice in your account encouraging you to upgrade as soon as possible.”