Publisher Report

List campaigns of the given media

GET /medias/:media_id/campaigns

Response

Status: 200 OK
[
  {
    "id": 10185,//Campaign ID
    "name": "Testing Campaign",//Campaign Name
    "start_date": "2012-01-03",
    "end_date": "2012-06-23",
    "created_at": "2012-09-06T20:39:23Z"
  }
]

Get daily report of the given campaign

GET /medias/:media_id/campaigns/:campaign_id/daily_reports

Parameters

start_time
Optional date - Beginning date to retrieve data in format YYYY-MM-DD. Listing campaigns which beginning date earlier than start_date.
end_time
Optional date - Final date to retrieve data in format YYYY-MM-DD. Listing campaigns which final date later than end_data.
sort
Optional string - The order to retrieve the results.
  • time - Sorting occurs by time.
  • imp - Sorting occurs by impression.
  • clk - Sorting occurs by click.
  • uimp - Sorting occurs by unique impression.
  • uclk - Sorting occurs by unique click.
direction
Optional string - The direction to retrieve the results.
  • asc Ascend (Default)
  • desc Descend

Response

Status: 200 OK
[
  {
    "time": "2012-08-01", 
    "imp": 23, 
    "uimp": 20, 
    "clk": 20, 
    "uclk": 10, 
  }
]

Get daily report of the given code

GET /medias/campaigns/daily_reports/codes

Parameters

code
Required string - Monitoring code

Response

Status: 204 No Content
Location: http://track.admasterapi.com/medias/1308/campaigns/10256/daily_reports
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999

Get campaign report of the given code

GET /medias/campaigns/reports/codes

Parameters

code
Required string - Monitoring code

Response

Status: 204 No Content
Location: http://track.admasterapi.com/medias/1308/campaigns/10256/reports
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999

Get IES report

GET /medias/:id/ies_reports

Response

Status: 200 OK
Link: <http://track.admasterapi.com/medias/1/ies_reports?page=2>; rel="next",
  	  <http://track.admasterapi.com/medias/1/ies_reports?page=10>; rel="last"

Parameters

pub_id
Optional string - pub_id
date
Optional date - YYYY-MM-DD page
Optional integer - the start index

If not supplied, the page is 1. (Feed pages are 1-based. That is, the first entry is entry 1, not entry 0.) Use this parameter as a pagination mechanism along with the per_page parameter for situations when totalResults exceeds 30 and you want to retrieve entries indexed at 31 and beyond.

per_page
Optional integer - the max-results

You can use this in combination with page to retrieve a subset of elements, or use it alone to restrict the number of returned elements, starting with the first. If you do not use the per_page parameter in your query, your feed returns the default maximum of 30 entries.

[{
  	"id": 30,
  	"media_id":100,
  	"geo_id": 1100000000,  		
  	"pub_id": "PUB_IMloxn12345",
  	"imp": 12039423,
  	"clk": 43432
}]

Get parameters from code

GET /medias/:id/code_params

Parameters

code
Required string - Code
{
  	"campaign_id": "100",
  	"placement_id":"100",
  	"creative_id":"0"
}

Get campaign report of the given medium

GET /medias/:media_id/campaigns/:campaign_id/reports

Parameters

time
Required string
It is connected with start_time and end_time.
  • hourly Get hourly unique data
  • daily Get daily unique data.
dims
Optional string - The dimensions parameter defines the primary data keys for your Campaign report. Use dimensions to segment your metrics. If you want to ask for several dimensions, you should use ‘,’. Example : media , placement, time.
  • time- The result will contains date messages.
  • placement
  • keyword
  • creative
  • province
placement_id
Optional integer - Placement ID
keyword_id
Optional integer - Keyword ID
creative_id
Optional integer - Creative ID
geo_id
Optional integer - Geography ID
start_time
Optional hour - Listing campaigns which beginning time date earlier than start_date. The format of start_time is connected with time.The parament start_time is formatted according to the ISO 8601 standard.
time start_time description
hourly YYYY-MM-DDThh:mm:ss+08:00 2012-11-06T01:00:00+08:00
daily YYYY-MM-DD 2012-11-06
end_time
Optional hour - Listing campaigns which final date later than end_time. The format of end_time is connected with time.The parament end_time is formatted according to the ISO 8601 standard.
time end_time description
hourly YYYY-MM-DDThh:mm:ss+08:00 2012-11-06T01:00:00+08:00
daily YYYY-MM-DD 2012-11-06
sort
Optional string - The order to retrieve the results.
  • time - Sorting occurs by time.
  • imp - Sorting occurs by impression.
  • clk - Sorting occurs by click.
  • uimp - Sorting occurs by unique impression.
  • uclk - Sorting occurs by unique click.
  • placement_id - Sorting occurs by placement_id
direction
Optional string - The direction to retrieve the results.
  • asc Ascend (Default)
  • desc Descend

Response

Status: 200 OK
Link: <http://track.admasterapi.com/medias/1/campaigns/12/reports?page=2>; rel="next",
      <http://track.admasterapi.com/medias/1/campaigns/12/reports?page=10>; rel="last"
[
  {
    "campaign_id": 10185,
    "time": "2012-08-03",
    "imp": 9,
    "uimp": 6,
    "clk": 3,
    "uclk": 3,
  }
]

Dimensions Description

Field Type Description
imp integer Impression
uimp integer Unique Impression
clk integer Click
uclk integer Unique Click

Valid Combinations Description

Not all combinations can be queried together. Only certain combinations can be used together to create valid combinations.

Valid Combinations
time=daily
time=daily&dims=province
time=daily&dims=creative
time=daily&dims=placement
time=daily&dims=placement,province
time=daily&dims=placement,keyword
time=daily&dims=placement,creative
time=hourly
time=hourly&dims=creative
time=hourly&dims=province
time=hourly&dims=placement
time=hourly&dims=placement,creative
time=hourly&dims=placement,province