Once you've made a request, it's essential to understand the response format and data points returned. Whether you prefer JSON or CSV, this guide breaks down the structure of the response to help you interpret the campaign metrics effectively.
Response
The Response can be either in csv or json format.
The response will always be broken down by “day” and sorted by day and spend (descending).
In case of additional data that exceeds the count parameter passed in the request, the response will contain a “next” link that will retrieve the next batch of records.
In a JSON response, the “next” link is in the “paging” property of the response body object.
In a CSV response, the “next” link is in the “Link” header of the response.
In case of an empty response, in which no data exists for the requested filters:
JSON format will result in an empty “data” array.
CSV format will lead to a 204 response (no content).
Response example – CSV format
"Day","app_name","package_name","campaign_id","campaign_name","cost_model","publisher_id","publisher_name","country","state","city","language","gender","age","device_manufacturer","device_model","os","sim_operator","impressions","clicks","launches","installs","spend"
"2019-07-05","App Name"
,"com.example",2341,"123_Aura_campaign_name","CPI","OOBE",125342,"sprint”,"US",”California”,”San Francisco”,"English","Female",”25-34”,"LGE","LG-Q710AL","android","Boost Mobile",441,203,149,268.2
Response example – JSON format
{
"Data":
[
{
"day": "2019-07-05",
"app_name": "App Name 123",
"package_name": "com.example",
"Campaign_id": 2341,
"cost_model": "CPI",
"Publisher_id": "125342",
"publisher_name": "sprint",
"country": "US",
"state": "California",
"city": "San Francisco",
"language": "English",
"gender": "Female",
"age": "25-34",
"device_manufacturer": "LGE",
"device_model": "LG-Q710AL",
"os": "android",
"sim_operator": "Boost Mobile",
"impressions": 50,
"clicks": 20,
"launches": 5,
"completions": 5,
"spend": 2.5
},
],
"paging":
{
"next":"https://reporting.isappcloud.com/advertisers/v1/reports?start_date=2019-07-10&end_date=2019-07-13&metrics=impressions,clicks,launches,completions,installs,spend&breakdowns=day,app_name,package_name,campaign_id,campaign_name,cost_model,publisher_id,publisher_name,country,state,city,language,gender,age,device_manufacturer,device_model,os,sim_operator&format=json&cursor=8fd1a34d-26a6-4bd0-b5cc-e1666b67bb17"
}
}