Campaign Performance
Campaign Performance API
Use this API to retrieve aggregated statistics of your Campaign in the Nefta AdNetwork.
Authorisation
To access the app revenue reporting API, authorisation is required. Authorisation is in the form of an API key and is present in every API request in the Authorization
header. Please contact your Nefta account manager to generate an API key for you.
The campaign performance API is accessed via HTTPS POST requests.
$ curl -X POST \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '$REQUEST_BODY' \
https://api.nefta.io/v1.4/reporting/campaigns
Request body
The revenue reporting API uses request body parameters to filter your request. Please note, certain parameters are required and others aren't.
from_date (Required): The starting date for your report data in YYYY-MM-DD format.
to_date (Required): The ending date for your report data in YYYY-MM-DD format.
Please note, the date range cannot exceed 31 days.
metrics (Required): A list of metrics you want to include in the report. Supported metrics are:
spend
impressions
clicks
installs
dimensions (Optional): A list of dimensions you want your data grouped by. Supported dimensions are:
date
campaign_id
creative_id
sdk_version
platform
ad_format
country
app_store
campaign_name
campaign_type
campaign_status
creative_name
creative_content_type
Request Body Example
The following snippet is an example of a request body.
{
"from_date": "2024-10-31",
"to_date": "2024-11-01",
"dimensions": [
"ad_format",
"platform"
],
"metrics": [
"spend",
"impressions",
"clicks"
]
}
This example retrieves data for spend, impressions, and clicks for the period of October 31st, 2024 to November 1st, 2024, grouped by ad format and platform.
Response
The campaign performance AP returns data in the JSON format. The data is an array of JSON objects, as shown below.
[
{
"ad_format": "rewarded_video",
"platform": "android",
"spend": 68.302,
"impressions": 1085,
"clicks": 571
},
{
"ad_format": "banner",
"platform": "ios",
"spend": 20.8581,
"impressions": 25846,
"clicks": 49
},
{
"ad_format": "interstitial",
"platform": "ios",
"spend": 214.362,
"impressions": 4218,
"clicks": 867
}
]
Please note, the currency of spend
is always USD.
Updated 16 days ago