Statistics API

Cheetah Media Link publishers can login to our website and read the statistics from the tab. This API exists to allow publishers to reach our statistics from their own server.

The API will return data in different raw format that you will be able to manipulate and display as you wish.

Please note that the number of requests, displays and clicks are not in real time. Update frequency is 10 minutes.

 

Here is the basic URL of Cheetah Media Link Statistics API:

  • URL: http://reportapiv2.mobpartner.mobi/report2.php?key=[…]&login=[…]
  • Method: HTTP GET

To access a secured reporting for your publisher account, you need to use your dedicated API key with your publisher ID. You will find them within this page:

http://dashboard.mobpartner.com/en/admin/statistics/api/documentation

 

Please refer to the complete technical documentation here.

 

Here are some of parameters you can use to filter the statistics:

Parameter Name Description Example
date_begin Beginning of the specific period you want to examine. Without setting date_begin and date_end, last 7 days’ statistics is displayed by default.
Format is:
- YYYYMMDD (when date_type is daily)
- YYYYMM (when date_type is monthly)
&date_begin=20160316
or
&date_begin=201603
date_end End of the specific period you want to examine. Without setting date_begin and date_end, last 7 days’ statistics is displayed by default.
Format is:
- YYYYMMDD (when date_type is daily)
- YYYYMM (when date_type is monthly)
&date_end=20160322
or
&date_end=201603
date_type Select how data are aggregated.
Value can be:
- daily (default)
- monthly
&date_type=daily
or
&date_type=monthly
service Traffic Source for which you want to examine statistics.
Value can be:
- ALL
- A list of IDs separated by the plus sign
&service=ALL
or
&service=123
or
&service=123+9865+1174
pool  Pools for which you want to examine statistics.
Value can be:
- ALL
- A list of IDs separated by the plus sign
&pool=ALL
or
&pool=123
or
&pool=123+9865+1174
subid  Examine statistics with the subids.
Value can be:
- ALL
- A list of IDs separated by the plus sign
&subid=ALL
or
&subid=subid1
or
&subid=subid1+subid2
campaign  Campaigns for which you want to examine statistics.
Value can be:
- ALL
- A list of campaign IDs separated by the plus sign
&campaign=ALL
or
&campaign=123
or
&campaign=123+9865+1174
country  Countries for which you want to examine statistics.
Value can be:
- ALL
- A list of country codes separated by the plus sign
&country=ALL
or
&country=FR
or
&country=FR+US+IT 
Detailed list of parameters please refer to the complete technical documentation here.

 

Here are some of parameters you can use to control or to display specific statistics:

Parameter Name Description Example
total Display an additional line with the total or sum of each column.
Value can be:
- 0 (don’t display the total)
- 1 (display the total)
- 2 (display only the total)
&total=0
or
&total=1
or
&total=2
clicks_invalid Number of invalid clicks.
Boolean parameter: 1 or 0
&clicks_invalid=0
or
&clicks_invalid=1
date_ref Set the date of reference for transactions and earnings.
Value can be:
- trx (default, date of transaction)
- clic (date of click)
&date_ref=trx
or
&date_ref=clic
epc Earnings per click.
Boolean parameter: 1 or 0
&epc=0
or
&epc=1
click_earning  Select only stats with clicks or eranings.
Value can be:
- 0 (default, all stats)
- 1 (stats with clicks or earnings)
- 2 (stats with earnings only)
&click_earning=0
or
&click_earning=1
or
&click_earning=2
display_name  Display Name of data.
Boolean parameter: 1 or 0
&display_name=0
or
&display_name=1
format  Chose the format of the data.
Value can be:
- csv (default)
- html
&format=csv
or
&format=html
Detailed list of parameters please refer to the complete technical documentation here.

 

Here are some examples of calling our statistics API:

Example 1

URL:

http://reportapiv2.mobpartner.mobi/report2.php?key=[…]&login=[…]&date_type=daily&date_begin=20160101&date_end=20160103

Results:

  • Date;Impressions;Clicks;Clicks Only;CTR;Transactions;Earnings Validated;Earnings Pending;CR;
  • 20160101;0;4622;4622;0;50;9.38;0;1.08;
  • 20160102;0;4244;4244;0;52;20.58;0;1.23;
  • 20160103;0;4379;4379;0;49;5.6;0;1.12;

 

Example 2

URL:

http://reportapiv2.mobpartner.mobi/report2.php?report2.php?key=[…]&login=[…]&date_type=daily&date_begin=20160101&date_end=20160103&country=CA+US

Results:

  • Date;Country;Impressions;Clicks;Clicks Only;CTR;Transactions;Earnings Validated;Earnings Pending;CR;
  • 20160101;CA;0;14;14;0;2;1.2;0;14.29;
  • 20160102;CA;0;4;4;0;0;0;0;0;
  • 20160103;CA;0;8;8;0;1;0.6;0;12.5;
  • 20160101;US;0;130;130;0;2;2.5;0;1.54;
  • 20160102;US;0;99;99;0;0;0;0;0;
  • 20160103;US;0;146;146;0;3;3.75;0;2.05;

 

Example 3

URL:

http://reportapiv2.mobpartner.mobi/report2.php?key=[…]&login=[…]&date_type=daily&date_begin=20160101&date_end=20160101&country=US&campaign=ALL&click_earning=2&display_name=1

Results:

  • Date;Campaign;Campaign name;Country;Country name;Impressions;Clicks;Clicks Only;CTR;Transactions;Earnings Validated;Earnings Pending;CR;
  • 20160101;4001;Campaign1 - Android App;US;United States;0;11;11;0;1;1.4;0;9.09;
  • 20160101;4003;Campaign2 - Android App;US;United States;0;26;26;0;2;2.8;0;7.69;

 

Should you encounter any issue or have any specific question, feel free to contact our technical support team at help@cmcm.com.

 

Have more questions? Submit a request

Comments

Powered by Zendesk