Mocean REST API Documentation

From Mocean Mobile Wiki

Contents 1 Overview 2 URI Structure 3 Response Format 4 Add Site API Methods 4.1 addSiteToNetwork() 4.2 addZoneToSite() 5 Get Publisher Info API Methods 5.1 getNetworkId() 5.2 getPubsiteId() 5.3 getZoneId() 5.4 getNetSiteZoneId() 5.5 getLandingPageData() 5.6 getLandingPageLeadData() 6 API Methods To Retrieve Publisher Statistics 6.1 getSiteInfoByDate() 6.2 getSiteInfoByRange() 6.3 getNetworkSiteInfoByRange() 6.4 getZoneInfoByRange() 6.5 getNetworkZoneInfoByRange() 6.6 getRawRequestsByZone() 7 API Methods To Retrieve Campaign Statistics 7.1 getAdDataByRange() 7.2 getAdInfoByDate() 7.3 getAdInfoByRange() 7.4 getCampaignGoals() 7.5 getCampaignDataByRange() 7.6 getCampaignZoneByRange() 7.7 getAdFeedData() 8 Inventory Forecasting API Methods 8.1 getZoneInventory() 8.2 getInventoryZone() 8.3 getInventoryCampaign() 8.4 getInventoryAd() 8.5 getInventoryZoneCampaigns() 8.6 getInventoryZoneAds() 8.7 getInventoryCampaignDetails() 8.8 getInventoryAdDetails()

Overview

The Mocean Mobile platform provides third party developers with the opportunity of retrieving reporting data by programming means. The range of REST API functions described on this page is intended for this purposes.

Each method request will return specific data, choose the method you need from the list, and generate a request according to the method description below.

To gain access to the REST API functionality, you will need your private key. You can request your private key by email TECHSUPPORT@MOCEANMOBILE.COM.

NOTE: YOU CAN ONLY MAKE ONE API REQUEST AT A TIME.

NOTE: SOME DATA CAN BE CACHED IF THE CURRENT DATE HASN'T BEEN INCLUDED TO THE REQUEST. SO IF YOU WOULD LIKE TO PULL A LARGE AMOUNT OF DATA, PLEASE USE THE CACHED DATA FOR PREVIOUS DAYS AND USE API TO PULL TODAY'S DATA, AS THIS WILL ALLOW FOR FASTER DATA PULLS.

URI Structure

In all cases, the HTTP method used is GET. The general URI structure for all the inventory forecasting API methods is as follows:

api_method_name	the name of the API method called. The detailed description of all API methods is given below.
param1, param2, param3	method parameters each preceded by the '&' symbol. The number of parameters depends on a certain method and may vary. You can specify values for available parameters but DO NOT forget to specify those that are required. The list of all the required and available parameters for each method is provided in a method description.

Response Format

All the inventory forecasting REST APIs return HTTP responses in XML. You can find samples of both successful and failure responses in a description for each method.

Add Site API Methods

There are two methods described below that allow adding a publisher site to a network, as well as setting zones within a created site.

addSiteToNetwork()

This function allows you to add a site to your Mocean network.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
network_id	integer	The ID of the network the site being added to. To query for specific network IDs, the getNetworkId() API method can be used.	required
site_name	string	The name of the site being added to the network.	required
site_url	string	The URL of the site being added to the network.	required
description	string	A description of the site being added.	required
channel_id	integer	The ID of the channel which the site is being categorized in. You can obtain the list of pre-existing channels supported by the Mocean Mobile platform in your network under Publisher Sites & Content navigation.	required

Request Sample:

Here is an example of HTTP request below. DO NOT forget to replace 'key_value' with your real private key value and specify all other required parameters.

Successful Response:

Failure Response:

Possible failures:

Error Message	Possible Reason
Could not save!	An error occurred while saving site info to database.
Site Already Exists	Site with the specified URL already exists in the given network.
Invalid Network ID	There is no network with the specified ID owned by the user.
Invalid API Key	The ’privatekey’ sent as the input parameter is invalid.

addZoneToSite()

This function can be used for adding a certain zone to the Mocean registered site.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
pubsite_id	integer	The ID of the publisher site that the zone is being added to. To get the publisher site ID, the getPubsiteId() method can be used.	required
zone_name	string	The name of the zone that is being added.	required
description	string	Some text information about the zone.	required
zone_type	string	The type of the zone to be added: 'text', 'banner', 'text&banner' or 'all'.	optional
min_cpc	float	The minimal bid for CPC ads that can be displayed on the zone.	optional
min_cpm	float	The minimal bid for CPM ads that can be displayed on the zone.	optional

Example:

Here is an example of HTTP request below. DO NOT forget to replace 'key_value' with your real private key value and specify 'description' of the zone.

Optionally, you can specify 'zone_type', 'min_cpc' and 'min_cpm'. By default, 'min_cpc' and 'min_cpm' ratios will be recorded as 0, 'zone_type' will be set to 'all' (including 'text', 'banner' and 'richmedia').

Successful Response:

Failure Response:

Possible failures:

Error Message	Possible Reason
Could not save zone!	An error occurred while saving zone info to database.
Could not find pubsite	The site ID provided in input is invalid or the site is not owned by the requesting user.
Invalid API Key	The ’privatekey’ sent as the input parameter is invalid.
Improper zone type	Value of ’zone_type’ is incorrect.

Get Publisher Info API Methods

Methods described below can be used for getting information about zones/sites/networks created by a publisher.

getNetworkId()

This function returns the id number of the network with the specified subdomain name.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
subdomain	string	A network subdomain name.	optional
deleted	integer	The flag used for indication deleted networks: set to 1 to retrieve deleted networks; 0 – not deleted networks.	optional

Example:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value.

Optionally, you can specify a certain subdomain and deleted networks indicator to get data for. Otherwise, you will get information on all not deleted networks owned by the requested user.

Successful Response:

The response will contain as many <network> elements as there are networks owned by the user. If 'subdomain' specified, the response will contain one <network> element.

Failure Response:

getPubsiteId()

This function returns the Mocean registered id number of the site with the proper URL; it also returns the id number of the network related.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
siteurl	string	The URL of the site. If not specified, the function returns the data regarding all the publisher’s sites.	optional

Example:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value.

Optionally, you can specify a certain 'siteurl' to get the data for. Otherwise, you will get information regarding all the publisher’s sites.

Successful Response:

The response will contain as many <site> elements as there are sites owned by the user. If 'siteurl' specified, the response will contain one <site> element.

Failure Response:

getZoneId()

This function returns information (id number and name) regarding all the zones of a certain site.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
site_id	integer	The ID of the site to get the zone data for.	required

Example:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value and specify 'site_id' you want to get the zone data for.

Successful Response:

The response will contain as many <zone> elements as there are zones in the site requested.

Failure Response:

getNetSiteZoneId()

This function returns information in relation to all the sites with the corresponding zones created in each of the user’s networks.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required

Example:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value.

Successful Response:

The response will contain as many <network_site_zone> elements as there are different zones, sites and networks owned by the specified user.

Failure Response:

getLandingPageData()

This function returns information in relation to landing pages (or a certain landing page) created by a certain user.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
network_id	integer	The ID of the network to get the data for. If not specified, the statistics for all the networks of a certain user will be returned. To query for specific network IDs, the getNetworkId() API method can be used.	optional
landing_page_id	integer	The ID of the landing page; if not specified, the function returns information about all the landing pages created by a certain user (in the specified network).	optional
date	string	The start date of the range when a customer was redirected from a certain landing page. The format is YYYY-MM-DD.	required
end_date	string	The end date of the range when a customer was redirected from a certain landing page. The format is YYYY-MM-DD.	required

Example:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value and specify a certain date range when the landing pages redirections requested are to be occurred.

Optionally, you can specify a certain network, landing page to get the data for. Otherwise, you will get information regarding all the publisher's landing pages.

Successful Response:

The successful response contains the following elements:

• Landing_page_lead_data:

• lp_id - (integer) the ID of the landing page to get the data for.

• lp_name - (string) a name of the landing page to get the data for.

• url - (string) the url for the user redirection.

• ip - (string) ip of the user been redirected.

• ua - (string) user agent of the user been redirected.

• created - (string) date and time of the user redirection.

The number of the <landing_page_data> elements corresponds to the number of redirections occurred on a certain Mocean Mobile landing page owned by the specified user.

getLandingPageLeadData()

This function returns information in relation to leads that are generated on Mocean Mobile landing pages.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
network_id	integer	The ID of the network to get data for. If not specified, the statistics for all the networks of a certain user will be returned.To query for specific network IDs, the getNetworkId() API method can be used.	optional
landing_page_id	integer	The ID of the landing page; if not specified, the function returns information about all the landing pages created by a certain user (in the specified network).	optional
date	string	The start date of the range when leads returned are to be generated. The format is YYYY-MM-DD.	optional
end_date	string	The end date of the range when leads returned are to be generated. The format is YYYY-MM-DD.	optional

Example:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value.

Optionally, you can specify a certain network, landing page to get the data for. Also you can specify range of dates when lead gen fields of the requested landing page are to be filled in. Otherwise, you will get information regarding all the lead generations of all the publisher's landing pages.

Successful Response:

The successful response contains the following elements:

• Landing_page_lead_data:

• lp_id - (integer) the ID of the landing page to get the data for.

• lp_name - (string) a name of the landing page to get the data for.

• url - (string) the url for the customer redirection.

• fieldN - (string) a text entered into the Nth lead gen textbox.

• created - (string) date and time of the lead generation.

The response will contain as many <field> elements as there are lead gen textboxes in a certain landing page.

The number of the <landing_page_data> elements corresponds to the number of leads been generated on a certain Mocean Mobile landing page owned by the specified user.

API Methods To Retrieve Publisher Statistics

A wide range of publisher statistics can be obtained by using API functions described below.

getSiteInfoByDate()

This function returns statistical information regarding a certain site (or all the user sites) for the specified date. If a user is a network owner, the function returns the statistics for all sites of the network for the specified date. The data returned includes the following parameters: the total number of clicks, impressions and requests, total revenue amount and eCPM value.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
date	string	The date to get the data for. The format is YYYY-MM-DD.	required
site_id	integer	The ID of the site to get the data for; if not specified, the statistics for all the sites of a certain user will be returned. If the user is the network owner, the function returns the statistics for all sites of this network. To get the publisher site ID, the getPubsiteId() method can be used.	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value and specify 'date' you want to get statistics for.

Optionally, you can specify a certain site to get a report for. Otherwise, you will get statistics for all the sites of the specified user.

Successful Response:

The successful response contains the following elements:

• Site:

• name - (string) a name of the site to get the data for.

• site_id - (integer) the ID of the site to get the data for.

• total_impressions - (integer) the total number of ad impressions regarding a certain site delivered for the specified date.

• requests - (integer) the total number of requests regarding a certain site made for the specified date.

• clicks - (integer) the total number of clicks regarding a certain site delivered for the specified date.

• total_revenue - (float) the total number of revenue regarding a certain site received from the campaign delivery for the specified date.

• eCPM - (float) the eCPM value regarding a certain site for the specified date.

The response will contain as many <site> elements as there are sites owned by the specified user. If 'site_id' specified, the response will contain one <site> element.

Failure Response:

getSiteInfoByRange()

This function returns statistical information regarding a certain site (or all the publisher sites) for the specified range of dates. If a user is a network owner, the function returns the statistics for all sites of the network for the specified range of dates.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD.	required
enddate	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD.	required
site_id	integer	The ID of the site to get the data for; if not specified, the statistics for all the sites of a certain user will be returned. If the user is the network owner, the function returns the statistics for all sites of this network. To get the publisher site ID, the getPubsiteId() method can be used.	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value and specify a certain range of dates you want to get statistics for.

Optionally, you can specify a certain site to get a report for. Otherwise, you will get statistics for all the sites of the specified user.

Successful Response:

The successful response contains the following elements:

• Site:

• name - (string) a name of the site to get the data for.

• site_id - (integer) the ID of the site to get the data for.

• total_impressions - (integer) the total number of impressions regarding a certain site delivered for the specified date range.

• requests - (integer) the total number of requests regarding a certain site made for the specified date range.

• clicks - (integer) the total number of clicks regarding a certain site delivered for the specified date range.

• ctr - (float) the CTR value regarding a certain site for the specified date range.

• eCPM - (float) the eCPM value regarding a certain site for the specified date range.

• total_revenue - (float) the total amount of revenue regarding a certain site received from the campaign delivery for the specified date range.

The response will contain as many <site> elements as there are sites owned by the specified user. If 'site_id' specified, the response will contain one <site> element.

Failure Response:

getNetworkSiteInfoByRange()

This function returns statistical information regarding a site (or all the sites) of the specified network for the specified range of dates.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
network_id	integer	The ID of the network to get the data for. To query for specific network IDs, the getNetworkId() API method can be used.	required
date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD.	required
enddate	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD.	required
site_id	integer	The ID of the site to get the data for; if not specified, the statistics for all the sites of a certain user will be returned. To get the publisher site ID, the getPubsiteId() method can be used.	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value and specify a certain range of dates you want to get statistics for.

Optionally, you can specify a certain site to get a report for. Otherwise, you will get statistics for all the sites of the specified user.

Successful Response:

The successful response contains the following elements:

• Site:

• name - (string) a name of the site to get the data for.

• site_id - (integer) the ID of the site to get the data for.

• publisher_id - (integer) the ID of the publisher the site belongs to.

• publisher_name - (string) the name of the site.

• total_impressions - (integer) the total number of impressions regarding a certain site delivered for the specified date range.

• requests - (integer) the total number of requests regarding a certain site made for the specified date range.

• clicks - (integer) the total number of clicks regarding a certain site delivered for the specified date range.

• revenue - (float) the amount of revenue regarding a certain site received from the campaign delivery for the specified date range.

• ctr - (float) the CTR value regarding a certain site for the specified date range.

• eCPM - (float) the eCPM value regarding a certain site for the specified date range.

• external_impressions - (integer) the number of external impressions regarding a certain site delivered for the specified date range.

• external_requests - (integer) the number of external requests regarding a certain site made for the specified date range.

• external_clicks - (integer) the number of external clicks regarding a certain site delivered for the specified date range.

• external_revenue - (float) the amount of external revenue regarding a certain site received from the campaign delivery for the specified date range.

• external_ctr - (float) the external CTR value regarding a certain site for the specified date range.

• external_fillrate - (float)

• external_eCPM - (float) the external eCPM value regarding a certain site for the specified date range.

The response will contain as many <site> elements as there are sites in the specified network. If 'site_id' specified, the response will contain only one <site> element.

Failure Response:

getZoneInfoByRange()

This function returns statistical information in relation to site zones for the specified range of dates.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD.	required
enddate	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD.	required
site_id	integer	The ID of the site to get the zone data for; if not specified, the statistics for all the publisher’s sites will be returned. To get the publisher site ID, the getPubsiteId() method can be used.	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value and specify a certain period of time you want to get data for.

Optionally, you can specify a certain site to get the zone data for. Otherwise, you will get information on all the zones of all the publisher's sites.

Successful Response:

The successful response contains the following elements:

• Zone:

• site_name - (string) a name of the site to get the zone data for.

• site_id - (integer) the ID of the site to get the zone data for.

• zone_id - (integer) the ID of the zone that is belong to a certain site to get the data for.

• zone_name - (string) a name of the zone that is belong to a certain site to get the data for.

• total_impressions - (integer) the total number of impressions regarding a certain zone delivered for the specified date range.

• requests - (integer) the total number of requests regarding a certain zone made for the specified date range.

• clicks - (integer) the total number of clicks regarding a certain zone delivered for the specified date range.

• revenue - (integer) the total number of revenue regarding a certain zone received from the campaign delivery for the specified date range.

• ctr - (float) the CTR value regarding a certain zone for the specified date range.

• eCPM - (float) the eCPM value regarding a certain zone for the specified date range.

The response will contain as many <zone> elements as there are zones in the specified site (or in all the publisher's sites).

Failure Response:

getNetworkZoneInfoByRange()

This function returns statistical information in relation to the zones for the specified network and range of dates.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
network_id	integer	The ID of the network to get the data for. To query for specific network IDs, the getNetworkId() API method can be used.	required
date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD.	required
enddate	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD.	required
site_id	integer	The ID of the site to get the zone data for; if not specified, the statistics for all the publisher’s sites will be returned. To get the publisher site ID, the getPubsiteId() method can be used.	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value and specify a certain period of time you want to get data for.

Optionally, you can specify a certain site to get the zone data for. Otherwise, you will get information on all the zones of all the publisher's sites.

Successful Response:

The successful response contains the following elements:

• Zone:

• site_name - (string) a name of the site to get the zone data for.

• site_id - (integer) the ID of the site to get the zone data for.

• zone_id - (integer) the ID of the zone that is belong to a certain site to get the data for.

• zone_name - (string) a name of the zone that is belong to a certain site to get the data for.

• publisher_id - (integer) the ID of the publisher the zone belongs to.

• publisher_name - (string) the name of the publisher the zone belongs to.

• total_impressions - (integer) the total number of impressions regarding a certain zone delivered for the specified date range.

• requests - (integer) the total number of requests regarding a certain zone made for the specified date range.

• clicks - (integer) the total number of clicks regarding a certain zone delivered for the specified date range.

• revenue - (integer) the total number of revenue regarding a certain zone received from the campaign delivery for the specified date range.

• ctr - (float) the CTR value regarding a certain zone for the specified date range.

• fillrate - (float) the value of zone fillrate.

• eCPM - (float) the eCPM value regarding a certain zone for the specified date range.

• external_impressions - (integer) the number of external impressions regarding a certain zone delivered for the specified date range.

• external_requests - (integer) the number of external requests regarding a certain zone made for the specified date range.

• external_clicks - (integer) the number of external clicks regarding a certain zone delivered for the specified date range.

• external_revenue - (float) the amount of external revenue regarding a certain zone received from the campaign delivery for the specified date range.

• external_ctr - (float) the external CTR value regarding a certain zone for the specified date range.

• external_fillrate - (float) the external value of zone fillrate.

• external_eCPM - (float) the external eCPM value regarding a certain zone for the specified date range.

The response will contain as many <zone> elements as there are zones in the specified network (or in all the publisher's zone).

Failure Response:

getRawRequestsByZone()

This function returns information in relation to the number of raw requests to each zone of a certain site or network.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
network_id	integer	The ID of the network to get the statistics for. If not specified, the statistics for all the networks of a certain user will be returned.To query for specific network IDs, the getNetworkId() API method can be used.	optional
pubsite_id	integer	The ID of the site to get the zone data for. If not specified, the statistics for all the publisher’s sites (in the specified network) will be returned. If the publisher is an owner of the network, the function will return the statistics for all sites of this network. To get the publisher site ID, the getPubsiteId() method can be used.	optional
start_date	string	The start date of the reporting range being accessed. If not specified, the end date will be set to 48 hours back from the current moment.The format is YYYY-MM-DD.	optional
end_date	string	The end date of the reporting range being accessed. If not specified, it will be set to 24 hours back from the current moment. The format is YYYY-MM-DD.	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value.

Optionally, you can specify certain network, site and range of dates to get the data for. Otherwise, you will get information in relation to all the publisher's sites for two days prior to the current one.

Successful Response:

The successful response contains the following elements:

• Zone_requests:

• raw_requests - (integer) the total number of raw requests to a certain zone of a certain site or network made for the specified date range.

• pubsite_id - (integer) the ID of the site to get the zone data for.

• zone_id - (integer) the ID of the zone that is belong to the specified site to get the data for.

• pubsite_name - (string) a name of the site to get the zone data for.

• zone_name - (string) a name of the zone that is belong to the specified site to get the data for.

The response will contain as many <zone_requests> elements as there are zones in the specified site/network or in all the user's sites.

Failure Response:

API Methods To Retrieve Campaign Statistics

getAdDataByRange()

This function returns statistical information (number of impressions, clicks and conversions, amount of cost) in relation to all the user ads for a certain period of time (if specified) or for the start_date.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
network_id	integer	The ID of the network to get data for. If not specified, the statistics for all the networks of a certain user will be returned. To query for specific network IDs, the getNetworkId() API method can be used.	optional
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD.	required
end_date	string	The end date of range. The format is YYYY-MM-DD. If not specified, it will be set to the start_date value.	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value and specify 'start_date' since which you want to get statistics.

Optionally, you can specify a certain network and the end of time period to generate a report for. Otherwise, you will get the report generated for all the user's networks for the start date only.

Successful Response:

The successful response contains the following elements:

• Ad_report:

• ad_name - (string) a name of the ad that is created in a certain network.

• network_name - (string) a name of the network to get the data for.

• advertiser_id - (integer) the ID of the advertiser who has created the ad in the specified network.

• advertiser_name - (string) a name of the advertiser who has created the ad in the specified network.

• activation_date - (string) date and time of the campaign activation.

• expiration_date - (string) date and time of the campaign expiration.

• ad_type - (integer) the type of the ad (1- text; 2 - image; 5 - richmedia; 6 - sms ); if the value is more than 1000, the ad is a third party.

• campaign_id - (integer) the ID of the user's campaign where the ad is running on.

• ad_id - (integer) the ID of the ad that is created in the requested network.

• cost - (numeric) the cost value spent by advertiser in ad clicks and shows.

• impressions - (integer) the total number of ad impressions regarding a certain network shown for the specified date range.

• clicks - (integer) the total number of clicks regarding a certain network made for the specified date range.

• conversions - (integer) the total number of ad conversions made for the specified data range.

• cpa - (integer) cost per actions value.

The response will contain as many <ad_report> elements as there are ads in the network (or in all the user's networks).

Failure Response:

getAdInfoByDate()

This function returns statistical information (country, number of impressions and clicks, amount of cost) in relation to all the user ads for the specified date.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
date	string	The date that the statistics is to be returned for. The format is YYYY-MM-DD.	required

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value and specify a 'date' you want to get statistics for.

Successful Response:

The successful response contains the following elements:

• Ad:

• name - (string) a name of the ad.

• id - (integer) the ID of the ad.

• country - (Country) a list of countries where the ad was shown.

• Country:

• name - (string) a name of the country where the ad was shown.

• impressions - (integer) the total number of ad impressions shown in the certain country per the specified date.

• clicks - (integer) the total number of clicks made in the certain country per the specified date.

• cost - (numeric) the cost value spent by advertiser in the ad delivery in the certain country per the specified date.

The number of <country> elements corresponds to the number of countries where the ad was shown.

The response will contain as many <ad> elements as there are ads in all user's networks.

No-Ads Response:

Failure Response:

getAdInfoByRange()

This function returns statistical information (country, number of impressions and clicks, amount of cost) in relation to all the user ads for the specified date.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD.	required
enddate	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD.	required

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value and specify a certain range of dates you want to get statistics for.

Successful Response:

The successful response contains the following elements:

• Ad:

• name - (string) a name of the ad.

• id - (integer) the ID of the ad.

• country - (Country) a list of countries where the ad was shown.

• Country:

• name - (string) a name of the country where the ad was shown.

• impressions - (integer) the total number of ad impressions shown in the certain country for the specified date range.

• clicks - (integer) the total number of clicks made in the certain country for the specified date range.

• cost - (numeric) the cost value spent by advertiser in the ad delivery in the certain country for the specified date range.

The number of <country> elements corresponds to the number of countries where the ad was shown for the specified date range.

The response will contain as many <ad> elements as there are ads in all user's networks.

No-Ads Response:

Failure Response:

getCampaignGoals()

This function returns the goal and the actual annual statistics (for the previous 12 months) as relates to impressions of the user's campaigns (or a certain campaign) up to the specified month; it includes the following data:

• total number of campaign AdViews;
• the goal number of campaign impressions to be delivered from the activation date till the end of the month specified;
• the actual number of impressions delivered from the campaign activation;
• optimal number of ads to be delivered daily.

This method is available ONLY for campaigns with the total AdViews number set!

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
network_id	integer	The ID of the network to get data for. If not specified, the statistics for all the networks of a certain user will be returned. To query for specific network IDs, the getNetworkId() API method can be used.	optional
campaigngroup_id	integer	The ID of the campaign group to get the optional statistics for; if not specified, function returns the data for all the campaigns of a certain user (in a certain network).	optional
month	integer	A month (default is the current month) up to, but not including, that the annual statistics is to be returned, i.e. statistics will be returned for the previous 12 months of the date specified.	optional
year	integer	A year (default is the current year) up to and including that the statistics is to be returned, i.e. function returns statistics for 12 months up to, but not including, the specified (or current) month of the specified (or current) year.	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value.

Optionally, you can specify certain 'network_id', 'campaigngroup_id', 'month' and 'year' to generate a report for. Otherwise, you will get the annual report generated for all the user's campaigns and networks up to the current month of the current year.

Successful Response:

The successful response contains the following elements:

• Campaign_group:

• network_id - (integer) the ID of the network within which the campaign group is created.

• id - (integer) the ID of the campaign group to get the data for.

• name - (string) a name of the campaign group to get the data for.

• impression_month_goal - (integer) the total number of ad impressions that was planned to be delivered for an year up to the specified month of the specified year.

• optimal_daily_delivered - (integer) the optimal number of ad impressions delivered per day.

• optimal_total_delivered - (integer) the optimal number of total delivered ads impessions.

• delivered_today - (integer) the number of ads impressions delivered on the current day.

• delivered_total - (integer) the total number of ad impressions delivered.

• impression_monthN_goal - (integer) the total number of ad impressions delivered (or expected to be delivered if month specified > the current month) per N-th month. Months are counted from the specified (or current) month of the previous year up to the previous month of the specified (or current) year. (For example, if you have specified month=6, year=2011, impressions number delivered from 6/2010 till 5/2011 inclusive will be returned, i.e. 'month1' will correspond to 6/2010, 'month12' will correspond to 5/2011)

• activation_date - (string) date and time of the campaign activation.

• expiration_date - (string) date and time of the campaign expiration.

• overall_goal - (integer) the total number of ad impressions that was set for the campaign.

The response will contain as many <campaign_group> elements as there are campaign groups in the network (or in all user's networks).

Failure Response:

getCampaignDataByRange()

This function returns statistical information (number of impressions and clicks, amount of cost) in relation to user ads created in the certain campaign of the certain network (if campaign and network are specified) for a certain period of time.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD.	required
campaign_id	integer	The ID of the campaign to get the optional statistics for; if not specified, function returns the data for all the campaigns of a certain user (in a certain network).	optional
network_id	integer	The ID of the network to get data for. If not specified, the statistics for all the networks of a certain user will be returned. To query for specific network IDs, the getNetworkId() API method can be used.	optional
end_date	string	The end date of the reporting range being accessed. If not specified, statistics will be returned for the start_date only. The format is YYYY-MM-DD.	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value and specify 'start_date' which you want to get statistics for.

Optionally, you can specify 'network_id', 'campaign_id' and the end of a data range ('end_date') to generate a report for. Otherwise, you will get the report generated for all user's campaigns and networks for the start_date only.

Successful Response:

The successful response contains the following elements:

• Campaign_stats:

• creative_id - (integer) the ID of the ad created within the certain campaign of the certain network.

• creative_name - (string) a name of the ad created within the certain campaign of the certain network.

• campaign_id - (integer) the ID of the campaign within which the ad is delivered.

• advertiser_id - (integer) the ID of the advertiser who has created the ad.

• advertiser_name - (string) a name of the advertiser who has created the ad.

• company_name - (string) a name of the advertiser's company.

• campaign_name - (string) a name of the campaign within which the ad is delivered.

• network_id - (integer) the ID of the network within which the campaign is created.

• cost - (numeric) the cost value spent by advertiser in the ad delivery for the specified date range.

• impressions - (integer) the total number of ad impressions delivered for the specified date range.

• clicks - (integer) the total number of ad clicks delivered for the specified date range.

The response will contain as many <campaign_stats> elements as there are ads in the user's campaign or network (or in all user's networks).

Failure Response:

getCampaignZoneByRange()

This function returns ads statistics (the number of impressions and clicks delivered and the amount of costs) broken down by zones for the specified date range.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
pubsite_id	integer	The ID of the site to get the zone data for; if not specified, the statistics for all the sites of a certain user (in the specified network) will be returned.	optional
network_id	integer	The ID of the network to get data for. If not specified, the statistics for all the networks of a certain user will be returned. To query for specific network IDs, the getNetworkId() API method can be used.	optional
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD.	optional
end_date	string	The end date of the reporting range being accessed. If not specified, statistics will be returned for the start_date only. The format is YYYY-MM-DD.	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace key_value with your real private key value.

Optionally, you can specify pubsite_id, network_id and the certain range of dates to generate a report for. Otherwise, you will get the report generated for all the user's networks for the current date.

Successful Response:

The successful response contains the following elements:

• Campaign_stats:

• creative_id - (integer) the ID of the creative.

• creative_name - (string) a name of the creative.

• campaign_id - (integer) the ID of the campaign within which the ad is delivered.

• advertiser_id - (integer) the ID of the advertiser who has created the ad.

• advertiser_name - (string) a name of the advertiser who has created the ad.

• company_name - (string) a name of the advertiser's company.

• campaign_name - (string) a name of the campaign within which the ad is delivered.

• zone_id - (integer) the ID of the zone to get the data for.

• zone_name - (string) a name of the zone to get the data for.

• pubsite_id - (integer) the ID of the publisher site relating to the zone.

• network_id - (integer) the ID of the network within which the campaign is created.

• cost - (numeric) the cost value spent by advertiser in the ad delivery for the specified date range (or the current date).

• impressions - (integer) the total number of ad impressions delivered for the specified date range (or the current date).

• clicks - (integer) the total number of ad clicks delivered for the specified date range (or the current date).

The response will contain as many <campaign_stats> elements as there are ads and different zones in the network (or in all user's networks).

Failure Response:

getAdFeedData()

This function returns third party statistics according to the report type selected for the certain period of dates.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
report_type	string	A type of report: hourly, daily or monthly.	optional
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD.	optional
end_date	string	The end date of the reporting range being accessed. If not specified, statistics will be returned for the period from the start_date up to the current date. The format is YYYY-MM-DD.	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace 'key_value' with your real private key value.

Optionally, you can specify certain 'report_type' and range of dates to generate a report for. Otherwise, you will get the daily report generated for the current date.

Successful Hourly Response:

Successful Daily and Monthly Responses:

The successful response contains the following elements:

• Adfeed:

• name - (string) the name of the Ad feed.

• imps - (integer) the total number of ad feed impressions delivered for the specified date range.

• impsThirdParty - (integer) the total number of ad feed impressions delivered for the specified date range.

• impsMojivaFeed - (integer) the local number of ad feed impressions delivered for the specified date range.

• clicks - (integer) the total number of ad feed clicks delivered for the specified date range.

• clicksThirdParty - (integer) the total number of ad feed clicks delivered for the specified date range.

• clicksMojivaFeed - (integer) the local number of ad feed clicks delivered for the specified date range.

• ctr - (float) the CTR value regarding a certain ad feed for the specified date range.

• revenue - (integer) the local value of revenue received from the ad feed delivery for the specified date range.

• ext_clicks - (integer) the number of ad feed clicks imported from the third party site for the specified date range.

• ext_impressions - (integer) the number of ad feed impressions imported from the third party site for the specified date range.

• ext_fillrate - (integer) the ad feed fill rate in percentage terms.

The number of <adfeed> elements corresponds to the ad feeds number of the specified user.

Failure Response:

Inventory Forecasting API Methods

API methods described below provide you with an access to a forecasting information concerned mobile inventory - the sum total of all the impressions available - for a certain campaign as well as ad and zone.

The inventory information returned includes the data for all campaigns without specifying by booked and held campaign types.

getZoneInventory()

Returns the network, site and zone ids with the number of requests expected on the certain zone for the specified date range. A list of campaigns assigned to the zone with expected requests is also returned.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
network_id	integer	The ID of the network to get the forecasting inventory information broken down by zones for.	optional*
pubsite_id	integer	The ID of the publisher site to get the forecasting inventory information broken down by zones for.	optional*
zone_id	integer	The ID of the zone to get the forecasting inventory information for.	optional*
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the current date will be used as a start date.	optional
end_date	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the report will be generated up to the end of the default forecasting period (2 weeks for this function).	optional

^* At least one of parameters (network_id, pubsite_id or zone_id) should be specified.

Request Sample:

Here is an example of HTTP request below. Do not forget to replace ’key_value’ with your real private key value and specify your real zone ID (network ID or pubsite ID) you want to get a forecasting information for.

Optionally, you can specify a certain period in future to generate a forecasting report for. Otherwise, you will get the report generated for 2 weeks from the current moment.

Successful Response:

The successful response contains the following elements:

• Inventory:

• network_id - (integer) the ID of the network to get the zone forecasting inventory information for.

• pubsite_id - (integer) the ID of the site within the network to get the zone forecasting inventory information for.

• zone_id - (integer) the ID of the zone to get the forecasting inventory information for.

• goals - (Goals) campaigns assigned to the zone with requests expected.

• requests - (integer) the total number of requests expected for the specified date range.

• Goals:

• campaigns - (Campaigns) the list of campaigns to be shown.

• sum - the total number of requests expected regarding to campaigns been already assigned to the zone.

• Campaigns:

• campaign:

• id - (integer) the ID of the campaign expected to be shown on the specified zone.

• name - (string) the name of the campaign.

• priority_type - (integer) a priority type of the campaign.

• priority - (integer) DEPRECATED.

The number of <campaign> elements corresponds to the number of campaigns to be shown on the specified zone.

The response will contain as many <inventory> elements as there are zones in the network (if network_id specified) or in the site (if pubsite_id specified). If zone_id has been specified in the request, the amount of the <inventory> elements will be one.

Failure Response:

A failure response could be like this:

OR:

OR like this:

getInventoryZone()

Returns the zone name, the number of impressions (both for booked and held campaigns together) expected to be shown on the specified zone for each day in the specified date range.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique alphanumeric identifier generated for Mocean registered users to be able to use REST API functionality.	required
zone_id	integer	The ID of the zone to get the forecasting inventory information for.	required
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the current date will be used as a start date.	optional
end_date	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the report will be generated up to the end of the default forecasting period (1 year at the moment).	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace ’key_value’ with your real private key value and specify your real zone ID you want to get a forecasting information for.

Optionally, you can specify a certain period in future to generate a forecasting report for. Otherwise, you will get the report generated for a 1 year from the current moment.

Successful Response:

The successful response contains the following elements:

• Inventory:

• date - (string) a day of the specified date range. The format is YYYY-MM-DD.

• zone - (string) a name of the zone to get the data for.

• impressions - (integer) the total number of zone impressions (both for booked and held campaigns) expected on day specified in the <date> element.

The response will contain as many <inventory> elements as there are days in the specified date range.

Failure Response:

A failure response could be like this:

OR like this:

getInventoryCampaign()

Returns the number of impressions expected for the specified campaign (no matter if it is a booked campaign or held).

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
campaign_id	integer	The ID of the campaigngroup to get the inventory forecasting for.	required
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the current date will be used as a start date.	optional
end_date	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the report will be generated up to the end of the default forecasting period (1 year at the moment).	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace ’key_value’ with your real private key value and specify your real campaign ID you want to get a forecasting information for.

Optionally, you can specify a certain period in future to generate a forecasting report for. Otherwise, you will get the report generated for a 1 year from the current moment.

Successful Response:

The successful response contains the following elements:

• Inventory:

• date - (string) a day of the specified date range. The format is YYYY-MM-DD.

• impressions - (integer) the total number of campaign impressions expected on day specified in the <date> element.

The response will contain as many <inventory> elements as there are days in the specified date range.

Failure Response:

A failure response could be like this:

OR like this:

getInventoryAd()

Returns the number of impressions of the specified ad expected on each day of the specified date range.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
ad_id	integer	The ID of the creative to get the inventory forecasting for.	required
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the current date will be used as a start date.	optional
end_date	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the report will be generated up to the end of the default forecasting period (1 year at the moment).	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace ’key_value’ with your real private key value and specify your real ad ID you want to get a forecasting information for.

Optionally, you can specify a certain period in future to generate a forecasting report for. Otherwise, you will get the report generated for a 1 year from the current moment.

Successful Response:

The successful response contains the following elements:

• Inventory:

• date - (string) a day of the specified date range. The format is YYYY-MM-DD.

• impressions - (integer) the total number of ad impressions expected on day specified in the <date> element.

The response will contain as many <inventory> elements as there are days in the specified date range.

Failure Response:

A failure response could be like this:

OR like this:

getInventoryZoneCampaigns()

Returns the number of impressions for each campaign (no matter if it is booked or held) expected to be shown on a certain zone.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
zone_id	integer	The ID of the zone to get the inventory forecasting for.	required
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the current date will be used as a start date.	optional
end_date	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the report will be generated up to the end of the default forecasting period (1 year at the moment).	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace ’key_value’ with your real private key value and specify your real zone ID you want to get a forecasting information for.

Optionally, you can specify a certain period in future to generate a forecasting report for. Otherwise, you will get the report generated for a 1 year from the current moment.

Successful Response:

The successful response contains the following elements:

• Inventory:

• date - (string) a day of the specified date range. The format is YYYY-MM-DD.

• campaigns: - (Campaigns) the list of campaigns to be shown.

• total_impressions - (integer) the total number of impressions expected to be shown on day specified in the <date> element.

• Campaigns:

• campaign:

• id - (integer) the ID of the campaign (booked or held) expected to be shown on the specified zone

• name - (string) the name of the campaign.

• impressions - (integer) the total number of campaign impressions expected on day specified in the <date> element.

The number of <campaign> elements corresponds to the number of campaigns to be shown on the specified zone.

The response will contain as many <inventory> elements as there are days in the specified date range.

Failure Response:

A failure response could be like this:

OR like this:

getInventoryZoneAds()

Returns the number of impressions for each ad expected to be shown on a certain zone.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
zone_id	integer	The ID of the zone to get the inventory forecasting for.	required
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the current date will be used as a start date.	optional
end_date	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the report will be generated up to the end of the default forecasting period (1 year at the moment).	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace ’key_value’ with your real private key value and specify your real zone ID you want to get a forecasting information for.

Optionally, you can specify a certain period in future to generate a forecasting report for. Otherwise, you will get the report generated for a 1 year from the current moment.

Successful Response:

The successful response contains the following elements:

• Inventory:

• date - (string) a day of the specified date range. The format is YYYY-MM-DD.

• ads: - (Ads) the list of campaigns to be shown.

• total_impressions - (integer) the total number of impressions expected to be shown on day specified in the <date> element.

• Ads:

• ad:

• id - (integer) the ID of the ad expected to be shown on the specified zone

• name - (string) the name of the ad.

• impressions - (integer) the total number of ad impressions expected on day specified in the <date> element.

The number of <ad> elements corresponds to the number of ads to be shown on the specified zone.

The response will contain as many <inventory> elements as there are days in the specified date range.

Failure Response:

A failure response could be like this:

OR like this:

getInventoryCampaignDetails()

Returns inventory forecasting report for a certain campaign (booked or held) broken down by zones and days of the specified date range.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
campaign_id	integer	The ID of the campaign to get the inventory forecasting for.	required
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the current date will be used as a start date.	optional
end_date	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the report will be generated up to the end of the default forecasting period (1 year at the moment).	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace ’key_value’ with your real private key value and specify your real campaign ID you want to get a forecasting information for.

Optionally, you can specify a certain period in future to generate a forecasting report for. Otherwise, you will get the report generated for a 1 year from the current moment.

Successful Response:

The successful response contains the following elements:

• Inventory:

• date - (string) a day of the specified date range. The format is YYYY-MM-DD.

• zones: - (Zones) the list of zones that the campaign is expected to be shown on.

• total_impressions - (integer) - the total number of campaign impressions expected to be shown on day specified in the <date> element.

• Zones:

• zone:

• id - (integer) the ID of the zone that the campaign is expected to be shown on.

• name - (string) the name of the zone.

• impressions - (integer) the total number of campaign impressions for that zone expected on day specified in the <date> element.

The number of <zone> elements corresponds to the number of zones that the campaign is to be shown on.

The response will contain as many <inventory> elements as there are days in the specified date range.

Failure Response:

A failure response could be like this:

OR like this:

getInventoryAdDetails()

Returns inventory forecasting report for a certain ad broken down by zones and days of the specified date range.

Parameters:

Parameter	Type	Description	Required?
privatekey	string	The unique identifier generated for Mocean registered users to be able to use REST API functionality.	required
ad_id	integer	The ID of the ad to get the inventory forecasting for.	required
start_date	string	The start date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the current date will be used as a start date.	optional
end_date	string	The end date of the reporting range being accessed. The format is YYYY-MM-DD. If not specified, the report will be generated up to the end of the default forecasting period (1 year at the moment).	optional

Request Sample:

Here is an example of HTTP request below. Do not forget to replace ’key_value’ with your real private key value and specify your real ad ID you want to get a forecasting information for.

Optionally, you can specify a certain period in future to generate a forecasting report for. Otherwise, you will get the report generated for a 1 year from the current moment.

Successful Response:

• Inventory:

• date - (string) a day of the specified date range. The format is YYYY-MM-DD.

• zones: - (Zones) the list of zones that the ad is expected to be shown on.

• total_impressions - (integer) the total number of ad impressions expected to be shown on day specified in the <date> element.

• Zones:

• zone:

• id - (integer) the ID of the zone that the ad is expected to be shown on.

• name - (string) the name of the zone.

• impressions - (integer) the total number of campaign impressions for that zone expected on day specified in the <date> element.

The number of <zone> elements corresponds to the number of zones that the ad is to be shown on.

The response will contain as many <inventory> elements as there are days in the specified date range.

Failure Response:

A failure response could be like this:

OR like this: