Retrieve Report By Zone Id

From wiki.taptica.com
(Difference between revisions)
Jump to: navigation, search
(End Point)
Line 68: Line 68:
 
       <FillRate>0</FillRate>
 
       <FillRate>0</FillRate>
 
       <Impressions>0</Impressions>
 
       <Impressions>0</Impressions>
 +
      <OfferId>0</OfferId>
 
       <Profit>39.00000</Profit>
 
       <Profit>39.00000</Profit>
 
       <RPC>0</RPC>
 
       <RPC>0</RPC>
Line 76: Line 77:
 
   </data>
 
   </data>
 
  </response>
 
  </response>
 +
 +
XML Error Example
 +
 +
<?xml version="1.0"?>
 +
<response>
 +
  <data i:nil="true"/>
 +
  <error>
 +
  Unknown zoneId=7c2bfe27-6262-4942-b4e-660fa0f95bd1
 +
  </error>
 +
</response>
 +
  
 
JSON
 
JSON
Line 86: Line 98:
 
     "Requests":4072698,
 
     "Requests":4072698,
 
     "Impressions":4000034,
 
     "Impressions":4000034,
 +
    "OfferId":0,
 
     "FillRate":0.98,
 
     "FillRate":0.98,
 
     "Clicks":14446,
 
     "Clicks":14446,
Line 104: Line 117:
 
  ZoneId,Date,Requests,Impressions,FillRate,Clicks,CTR,Conversions,ConversionRate,Cost,CPC,RPC,Profit,Revenue
 
  ZoneId,Date,Requests,Impressions,FillRate,Clicks,CTR,Conversions,ConversionRate,Cost,CPC,RPC,Profit,Revenue
 
  a6f5bec4-53ed-482a-ac09-69d41f6d1f6c, 2013-01-31, 4072698, 3118472, 76.57, 14446, 0.463, 66, 0.456, 132.00, 0.00913, 0.0068531, 23433.00,99.00
 
  a6f5bec4-53ed-482a-ac09-69d41f6d1f6c, 2013-01-31, 4072698, 3118472, 76.57, 14446, 0.463, 66, 0.456, 132.00, 0.00913, 0.0068531, 23433.00,99.00
 +
 +
CSV Error Example:
 +
Unknown zoneId=7c2bfe27-6262-4942-b4e-660fa0f95bd1

Revision as of 09:59, 6 February 2013

Audience

This document is intended for software engineers, product or project managers responsible for the implementation of Taptica's API for reports.

Retrieve Report By Zone Id

This method is used to send request to Taptica's Core servers for retrieving ads reports. The method will pass to Taptica's Core servers unique IDs identifying the Zone Id and a set of metadata describing the request.

End Point

Ad requests to the Taptica's API comprise:

A simple HTTP GET request of the form:

http://api.reports.taptica.com/v2/data?zoneid=ABC&token=to be provided by Taptica&from=20130120&to=20130122&format=json

Parameters Description

Parameter Description
token Authentication token provided by Taptica's Core
zoneid Zone Id as provisioned by Taptica's Core.
from Date , start date to begin the report. (format:YYYYMMDD)
to Type: Date , end date to end the report. (format:YYYYMMDD)
format xml, json or csv responses.



Return Value
XML, JSON or CSV dependent on the format value, default value XML

Reporting Examples

XML

<?xml version="1.0"?>
<response>
  <data>
    <Item>
      <CPC>0</CPC>
      <CTR>0</CTR>
      <Clicks>0</Clicks>
      <CR>0</CR>
      <Conversions>0</Conversions>
      <Cost>91.00000</Cost>
      <Date>2013-01-31</Date>
      <FillRate>0</FillRate>
      <Impressions>0</Impressions>
      <OfferId>0</OfferId>
      <Profit>39.00000</Profit>
      <RPC>0</RPC>
      <Requests>0</Requests>
      <Revenue>130.00000</Revenue>
      <ZoneId>ABC</ZoneId>
    </Item>
  </data>
</response>

XML Error Example

<?xml version="1.0"?>
<response>
 <data i:nil="true"/>
 <error>
  Unknown zoneId=7c2bfe27-6262-4942-b4e-660fa0f95bd1
 </error>
</response>


JSON

{ 
 "Reports":[
 {
   "ZoneId":"a6f5bec4-53ed-482a-ac09-69d41f6d1f6c",
   "Date":"2013-01-31",
   "Requests":4072698,
   "Impressions":4000034,
   "OfferId":0,
   "FillRate":0.98,
   "Clicks":14446,
   "CTR":0.463,
   "Revenue":99.0,
   "Conversions":1600,
   "CR":0.5,
   "Cost":132.0,
   "CPC":0.0091,
   "RPC":0.0068,
   "Profit":123343.00
 }],
 "Error":null
}

CSV

ZoneId,Date,Requests,Impressions,FillRate,Clicks,CTR,Conversions,ConversionRate,Cost,CPC,RPC,Profit,Revenue
a6f5bec4-53ed-482a-ac09-69d41f6d1f6c, 2013-01-31, 4072698, 3118472, 76.57, 14446, 0.463, 66, 0.456, 132.00, 0.00913, 0.0068531, 23433.00,99.00

CSV Error Example:

Unknown zoneId=7c2bfe27-6262-4942-b4e-660fa0f95bd1
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox