Updated: Publisher Reports API now available with Country-wise data

Note:  A minor edit in the URL was done to rectify the mistake in the earlier post

The Publisher Reports API which delivers a XML feed for the reporting data now has country wise reporting available for your convenience.

http://reports.zestadz.com/country_xml_reports?key=key_value&cid=cid_value&report_date=09-mar-2009

The XML reports request consists of 3 parameters

Key: It’s a unique value and should not be changed. If any changes are made, the request cannot be completed.

cid: This is the site id for Site & App. This Id is available for each Site or App that you have created within your console and can be changed to get XML reports for a different Site & App

Date: The date can be changed to generate the XML reports for the required date.

For Eg, to get the XML feeds for January 20, 2009, the above mentioned URL has to be modified as follows. I.e. in the URL the date has to be modified (Date format – DD-MMM-YYYY). The resultant response will be as follows

Note the slight difference in the request URL as opposed to regular reports. The report data is delivered in the format below.

Would you rather see  graphical reports?.

Log on to ZestADZ analytics (http://analytics.zestadz.com) with the same account information (its free) and view detailed reporting including country wise reporting, unique user data and more.

All above numbers are just Indicative samples and do not represent actual data. Please write to support [at] zestadz.com if you have any queries relating to Advertiser Reports API.

ZestADZ Engineering Team

ZestADZ Standard Error Messages / Responses Explained

When you use ZestADZ through an API such as the Android SDK / iPhone SDK or Adwhirl SDK, you will get well structured responses that have probably handled by the SDK itself. But in case you got a cryptic message that is not very clear then either you can write to us – support@zestadz.com or use the following guide to understanding what could be your error.

The following are typical responses with the last one being to display an Ad. As said earlier, most API or Site Install Code can handle these responses appropriately. But  if you do encounter such messages directly then use the below information to understand what is the message and how to process it.

Message:  16%7CALL-~NO ADS TO DISPLAY

Explanation: ZestADZ has no ads to display for your request. You can choose to route the request to another network if desired.

Message: %7CALL-~ERROR: CID IS INCORRECT. NO ADS TO DISPLAY

Explanation: Your Client Id (Site Id) is incorrect. Log into your account at http://zestadz.com and either configure a new Client or use the default client id to request for Ads. Please change the name of the Ad Client (App or Site) so that ZestADZ admins can review and approve it. An Approved ad client can view list of available ads.

Message: 16%7CALL-~ERROR: IP ADDRESS IS INVALID. NO ADS TO DISPLAY

Explanation: The IP Address that you sent was invalid OR ZestADZ failed to recognize your IP Address.  Please do write to us with the list of IPs which failed to deliver an Ad request and we will review it immediately.

Message: 16%7CALL-8309~2~Dynamic_house~1284490411-8309

Explanation: This is a typical ad response which is parsed by your API or Site Install Code to display a linked banner or text ad.


Minor Publisher Upgrades – Sept 2010

Automated Data collection and updates to improve ad targeting:

We have been doing many behind the screen upgrades with the targeting system at ZestADZ where we are building a fairly large scale data collection system to collect key data such as Device / IP / Carrier data where we are currently unable to serve ads and immediately process it into system so that it is available for campaigns shortly thereafter.

Through this upgrade we hope that we can increase publisher fill rates.

Dynamic Bot / Crawler Db + Prevention System

A minor upgrade enabling us to maintain and continuously update our database of identified bots to filter clicks so that the advertiser spend is not unnecessarily wasted due to bots.  Newer bots also are automatically identified by using the above system and then updated into a database of bots. Bots can be blocked with keywords or both user-agent strings or by any suspicious activity on ZestADZ.

Country-wise Reports

We are upgrading the standard XML reporting feed for publishers by adding country-wise breakdown of data.  Watch this space tomorrow for more updates as to how to use this system.

Enhanced Analytics

Watch this space for more information in the near future.