Please note that this feature requires a unique API key and password. Please contact your account representative for more information.

Introduction

Content.ad offers this REST API to make detailed click data available to publishers in either XML or JSON format.

Implementation FAQ

How often is performance data updated?
Performance reports are updated by Content.ad once per hour.

How long can I run the report for?
This report can be run for any period 31 days or less. You can use the “startDate” and “endDate” parameters to specify a date range.

How is reporting data grouped?
Depending on your preferences, you can view the specific country, device type, source, and campaign of each widget click in a given hour, day, or aggregate time period. See the “Optional Query String Parameters” section below for more information. Because of the granularity of this data, impressions are not available via this report, so we recommend joining this information to your analytics data if you need to measure impressions to calculate CTR and eCPM at this level.

Setting Up the API Call

Place the desired parameters into the API call below.

https://rest.content.ad/reports/publisher/click

Optional Query String Parameters

Example JSON Result Set

{
 "rows": [
  {
   "date":"2016-05-01T00:00:00-07:00",
   "domain_id":00001,
   "domain_name":"example.com",
   "widget_id":00001,
   "widget_description":"Widget 1",
   "device":"d",
   "country":"US",
   "source":"organic",
   "campaign":"123",
   "clicks":180,
   "revenue":17.28
  },
  {
   "date":"2016-05-02T00:00:00-07:00",
   "domain_id":00001,
   "domain_name":"example.com",
   "widget_id":00001,
   "widget_description":"Widget 1",
   "device":"d",
   "country":"US",
   "source":"organic",
   "campaign":"123",
   "clicks":180,
   "revenue":17.28
  }
 ]
}
Did this answer your question?