Overview

Our API requires POST requests to be made with all fields as POST data. Fields with multiple values should be passed as JSON arrays (eg. [“value1”, “value2”]).

Responses can be in either JSON or CSV format.

Reporting

The report method can be used to view delivery and earnings data across a specific publisher's placement groups and placements. You can choose what data you want to see. Note that the data will be grouped on, and the metrics aggregated by, the dimensions that you specify.

The API endpoint is:

https://dashboard.mobilefuse.com/api/v2/report

Table of Contents

Request Parameters

Field	Required	Default	Description
key	Yes	n/a	Found in your account settings
format	No	json	“json” or “csv”
start_date	No	(yesterday)	YYYY-MM-DD format
end_date	No	(yesterday)	YYYY-MM-DD format
dimensions	No	["date", "placementorder_id", "placementorder_name"]	JSON array of dimensions
metrics	No	["mobilefuse_clicks", "mobilefuse_imps", "mobilefuse_video_starts", "mobilefuse_video_completes", "billable_clicks", "earningsbillable_imps", "billable_video_starts", "billable_video_completes"]	JSON array of metrics
filters	No	{}	JSON object of filters (note any of the supplied ids can match), eg. {"placement_id": ["first_id”, “second_id"]}

Available Dimensions

Dimension	Type	Example	Description
country (data available for the last 7 days)	string	Canada	Name of the country
date	date	2016-07-01	YYYY-MM-DD format
hour	datetime	2016-07-31 02:00:00	YYYY-MM-DD HH:00:00 format
week	date	2016-07-03	YYYY-MM-DD format of the first Sunday in that week
month	string	2016-07	YYYY-MM formatplacement
year	int	2016	YYYY format
creative_id	int	400000700000	MobileFuse ID of individual placementthe creative
placementcreative_name	string	BobsApp_300x250_SP_Android_App	Name of the individual placement	year	int	2016	YYYY format	300x250Mindset	Name of the creative
line_item_id	int	300000	ID of the line item, also referred to as a placement. It is a grouping of creatives
line_item_name	string	ABC2016JanMindset	Name of the line item, also referred to as a placement. It is a grouping of creatives
order_id	int	100000	ID of the order, encompassing all stats for a campaign
order_name	string	ABC2016	Name of the order, encompassing all stats for a campaign

Available Metrics

Metric	Type	Example	Description
mobilefuse_clicks	int	26500	Number MobileFuse’s recorded number of ad clicks on adsctr
mobilefuse_conversions	int	30	MobileFuse’s recorded number of conversions
mobilefuse_ctr	double	1.25	Click Through Rate based on mobilefuse_imps and mobilefuse_clicks, expressed as a decimal
mobilefuse_imps	int	25000	MobileFuse’s recorded number of impressions
mobilefuse_installs	int	150	MobileFuse’s recorded number of installs
mobilefuse_vcr	double	0.0015	Clickthrough rate expressed as a decimal
earnings	currency	$15.2505	Earnings in USD
254	Video Completion Rate based on mobilefuse_video_starts and mobilefuse_video_completes, expressed as a decimal
mobilefuse_video_starts	int	50	MobileFuse’s recorded number of video starts
mobilefuse_video_first_quartiles	int	50	MobileFuse’s recorded number of first quartile events (25% completion)
mobilefuse_video_midpoints	int	50	MobileFuse’s recorded number of midpoint events (50% completion)
mobilefuse_video_billable_quartiles	int	50	MobileFuse’s recorded number of third quartile events (75% completion)
mobilefuse_video_completes	int	50	MobileFuse’s recorded number of video completion events (100% completion)
billable_clicks	int	500	Billable number of ad clicks
billable_conversions	int	30	Billable number of conversions
billable_ctr	double	1.25	Click Through Rate based on billable_imps and billable_clicks, expressed as a decimal
billable_imps	int	25000	Number Billable number of impressions delivered
ecpmbillable_installs	currencyint	1.5455	Effective Cost Per Thousand Impressions	150	Billable number of installs
billable_vcr	double	0.853254	Video Completion Rate based on billable_video_starts and billable_video_completes, expressed as a decimal
billable_video_starts	int	2500050	Number of videos that started playing	Billable number of video starts
billable_video_first_quartiles	int	2500050	Number of videos which played for at least 25% of their duration	Billable number of first quartile events (25% completion)
billable_video_midpoints	int	2500050	Number of videos which played for at least 50% of their duration	video_thirdBillable number of midpoint events (50% completion)
billable_video_billable_quartiles	int	2500050	Number of videos which played for at least 75% of their duration	Billable number of third quartile events (75% completion)
billable_partner_video_completes	int	2500050	Number of videos which played to completionBillable number of video completion events (100% completion)

Available Filters

Dimension	Type	Example	Description
creative_id	int	600000	ID of the creative
line_item_id	int	600000	ID of the line item, also referred to as a placement. It is a grouping of creatives
order_id	int	400000600000	MobileFuse ID of placementthe order, encompassing all stats for a campaign

Example JSON Response

Given the following request:

Code Block

curl -X POST -H "Content-Type: multipart/form-data;" -F "key=[INSERT_KEY_HERE]" -F "format=json" -F "start_date=2016-08-01" -F "end_date=2016-08-02" -F "dimensions=[\"date\"]" -F "metrics=[\"mobilefuse_imps\", \"mobilefuse_clicks\", \"earningsmobilefuse_video_starts\", \"ctrmobilefuse_video_completes\", \"ecpm\"]" "https://dashboard.mobilefuse.com/api/v2/report"

Or the following request, if you want to query for a specific placement:

Code Block

curl -X POST -H "Content-Type: multipart/form-data;" -F "key=[INSERT_KEY_HERE]" -F "format=json" -F "start_date=2016-08-01" -F "end_date=2016-08-02" -F "dimensions=[\"date\"]" -F "metrics=[\"mobilefuse_imps\", \"mobilefuse_clicks\", \"earningsmobilefuse_video_starts\", \"ctrmobilefuse_video_completes\", \"ecpm\"]" -F "filters={\"placementorder_id\": [12345,23456100000]}" "https://dashboard.mobilefuse.com/api/v2/report"

You will receive a response similar to the following (note for errors, “status” will be “error” and there will be a description in the “message” field):

Code Block

{
 
  "status": "success",
 
  "data": [
        {
            "date": "20162022-0806-01",
   
        "mobilefuse_imps": "1000",
            ""mobilefuse_clicks": "10",
            "earnings"mobilefuse_video_starts": 1.0,
     "1000",
      "ctrmobilefuse_video_completes": "0.01900",
            "ecpm": 1.0
        },

       {
            "date": "20162022-0806-02",
     
      "mobilefuse_imps": "1000",
   
        "mobilefuse_clicks": "10",
            "earnings"mobilefuse_video_starts": 1.0,
     "1000",
      "ctrmobilefuse_video_completes": "0.01",
            "ecpm": 1.0900"
         }
    ]
}

Example CSV Response

Given the following request:

Code Block

curl -X POST -H "Content-Type: multipart/form-data;" -F "key=[INSERT_KEY_HERE]" -F "format=jsoncsv" -F "start_date=2016-08-01" -F "end_date=2016-08-02" -F "dimensions=[\"date\"]" -F "metrics=[\"mobilefuse_imps\", \"mobilefuse_clicks\", \"earningsmobilefuse_video_starts\", \"ctr\", mobilefuse_video_completes\"ecpm\"]" "https://dashboard.mobilefuse.com/api/v2/report"

You will receive a response similar to the following (not for errors, the output will start with “Error:” followed by a description of the error.:

Code Block
date,mobilefuse_imps,mobilefuse_clicks,earnings,ctr,ecpmmobilefuse_video_starts,mobilefuse_video_completes 2016-08-01,1000,10,1.0,0.01,1.01000,900 2016-08-02,1000,10,1.0,0.01,1.01000,900

Note: All strings are enclosed in “double quotes”.

Get a List of

Placements

Orders

The placements orders method can be used to retrieve a list of all active placements and their associated placement groups. Please note this report is limited to Publishers.orders.

The API endpoint is:

https://dashboard.mobilefuse.com/api/v2/placementsorders

Request Parameters

Field	Required	Default	Description
key	Yes	n/a	Found in your account settings
format	No	json	“json” or “csv”

Example JSON Response

Given the following request:

Code Block
curl -X POST -H "Content-Type: multipart/form-data;" -F "key=[INSERT_KEY_HERE]" -F "format=json" "https://dashboard.mobilefuse.com/api/v2/placementsorders"

You will receive a response similar to the following:

Code Block
{ "status": "success", "statusdata": [ "success",{ "id": 100000, "dataname": ["ABC2022" }, { "id": 100001, "placement_idname": 400000 "ABC2021" }, ] }

Example CSV Response

Given the following request:

Code Block
curl -X POST -H "Content-Type: multipart/form-data;" -F "key=[INSERT_KEY_HERE]" -F "placement_name": "BobsApp_300x250_SP_Android_App" "format=csv" "https://dashboard.mobilefuse.com/api/v2/orders"

You will receive a response similar to the following:

Code Block
order_id,order_name 400000,"ABC2022" 400001,"ABC2021"

Note: All strings are enclosed in “double quotes”.

Get a List of Line Items

The orders method can be used to retrieve a list of all active line items.

The API endpoint is:

https://dashboard.mobilefuse.com/api/v2/line-items

Request Parameters

Field	Required	Default	Description
key	Yes	n/a	Found in your account settings
format	No	json	“json” or “csv”

Example JSON Response

Given the following request:

Code Block
curl -X POST -H "Content-Type: multipart/form-data;" -F "key=[INSERT_KEY_HERE]" -F "format=json" "https://dashboard.mobilefuse.com/api/v2/line-items"

You will receive a response similar to the following:

Code Block

{
  "status": "success",
  "data": [
    {
      "order_id": 600000,
      "order_name": "OrderNumber1",
      "id": 630000,
      "name": "LineItemNumber1"
    },
    {
      "order_id": 600001,
      "order_name": "OrderNumber2",
      "id": 640000,
      "name": "LineItemNumber2"
    }
  ]
}

Get a List of Creatives

The orders method can be used to retrieve a list of all creatives.

Example CSV

The API endpoint is:

https://dashboard.mobilefuse.com/api/v2/creatives

Request Parameters

Field	Required	Default	Description
key	Yes	n/a	Found in your account settings
format	No	json	“json” or “csv”

Example JSON Response

Given the following request:

Code Block
curl -X POST -H "Content-Type: multipart/form-data;" -F "key=[INSERT_KEY_HERE]" -F "format=csvjson" "https://dashboard.mobilefuse.com/api/v2/placement-groupscreatives"

You will receive a response similar to the following:

Code Block
placement_id,placement_name 400000,"BobsApp_300x250_SP_Android_App" 400001,"BobsOtherApp_300x250_SP_Android_App"

Note: All strings are enclosed in “double quotes”.

{
  "status": "success",
  "data": [
    {
      "order_id": 600000,
      "order_name": "OrderNumber1",
      "line_item_id": 630000,
      "line_item_name": "LineItemNumber1"
      "id": "600050",
      "name": "CreativeNumber1"
    },
    {
      "order_id": 600001,
      "order_name": "OrderNumber2",
      "line_item_id": 640000,
      "line_item_name": "LineItemNumber2",
      "id": "600060",
      "name": "CreativeNumber2"
    }
  ]
}

Versions Compared

Old Version 1

New Version 2

Key

Overview

Reporting

Request Parameters

Available Dimensions

Available Metrics

Available Filters

Example JSON Response

Example CSV Response

Get a List of

Orders

Request Parameters

Example JSON Response

Example CSV Response

Get a List of Line Items

Request Parameters

Example JSON Response

Get a List of Creatives

Request Parameters

Example JSON Response

Page Comparison

Versions Compared

Old Version 1

New Version 2

Key

Overview

Reporting

Request Parameters

Available Dimensions

Available Metrics

Available Filters

Example JSON Response

Example CSV Response

Get a List of

Orders

Request Parameters

Example JSON Response

Example CSV Response

Get a List of Line Items

Request Parameters

Example JSON Response

Get a List of Creatives

Request Parameters

Example JSON Response