Viewing Sample Actuals Request & Response

Learn how to create a service request and view a listing of all available fields including which are recommended for best coverage of results.

This information was taken from Attribution Analytic's Actuals Report:

platform_reporting_of_actuals

 

Servicing TUNE Reporting API Requests and Responses

Count Records: /advertiser/stats/count.json

tune_reporting_api_action_count-600x155 (1)

URL Request

https://api.mobileapptracking.com/v2/advertiser/stats/count.jsonp?
callback=jQuery18303470250559039414_1423157874603
&api_key=YOUR_API_KEY_HERE
&filter=((publisher_id > 0) 
  AND ((debug_mode=0 OR debug_mode is NULL) 
  AND (test_profile_id=0 OR test_profile_id IS NULL)))
&group=site_id,publisher_id
&start_date=01/29/2015
&end_date=02/05/2015
&response_timezone=America/Los_Angeles
&_=[Cache refresh Timestamp]

JSON Response

jQuery18303470250559039414_1423157874603
(
{  
   status_code:200,
   response_size:"52",
   data:3126 << Count
}
)

Stream Report: /advertiser/stats/find.json

tune_reporting_api_action_find-600x183 (2)

URL Request

https://api.mobileapptracking.com/v2/advertiser/stats/find.jsonp?
callback=jQuery18306392995368223637_1422810089195
&api_key=YOUR_API_KEY_HERE
&page=1
&limit=2
&fields=site_id,site.name,publisher_id,publisher.name,
  ad_clicks_unique,installs,events,payouts,revenues_usd
&sort[installs]=desc
&filter=((publisher_id > 0) 
  AND ((debug_mode=0 OR debug_mode is NULL) 
  AND (test_profile_id=0 OR test_profile_id IS NULL)))
&group=site_id,publisher_id
&start_date=01/25/2015
&end_date=02/01/2015
&response_timezone=America/Los_Angeles
&_=[Cache refresh Timestamp]

JSON Response

jQuery18306392995368223637_1422810089195(
{  
   status_code:200,
   response_size:"516",
   data:[  
      {  
         site_id:3002,
         publisher_id:46872,
         installs:"64713",
         events:"183",
         payouts:"0.00000",
         ad_clicks_unique:"129919",
         revenues_usd:"0.00000",
         site:{  
            name:"Vestibulum faucibus lorem (Google)"
         },
         publisher:{  
            name:"Aliquam pellentesque - Curabitur"
         }
      },
      {  
         site_id:3002,
         publisher_id:85622,
         installs:"56546",
         events:"5",
         payouts:"0.00000",
         ad_clicks_unique:"144440",
         revenues_usd:"0.00000",
         site:{  
            name:"Vestibulum faucibus lorem (Google)"
         },
         publisher:{  
            name:"Maecenas fringilla - Vivamus"
         }
      }
   ]
}
)

Export Report: /advertiser/stats/find_export_queue.json

tune_reporting_api_action_find_export_queue

URL Request

https://api.mobileapptracking.com/v2/advertiser/stats/find_export_queue.jsonp?
callback=jQuery18306083544725552201_1423159766900
&api_key=YOUR_API_KEY_HERE
&fields=site_id,site.name,publisher_id,publisher.name,ad_clicks_unique,installs,events,payouts,revenues_usd
&sort[installs]=desc
&filter=((publisher_id > 0) AND ((debug_mode=0 OR debug_mode is NULL) AND (test_profile_id=0 OR test_profile_id IS NULL)))
&group=site_id,publisher_id
&start_date=01/29/2015
&end_date=02/05/2015
&response_timezone=America/Los_Angeles
&format=csv
&_=[Cache refresh Timestamp]

JSON Response

jQuery18306083544725552201_1423159766900(
{
   status_code: 200,
   response_size: "83",
   data: "dummyr7ndr6w43y25reqpfnqu83dummy"  << Job ID of Report on Export Queue
}
)

Export Report Status and Download: /export/download.json

tune_reporting_api_export_action_download

URL Request

https://api.mobileapptracking.com/v2/export/download.jsonp?callback=
jQuery18306083544725552201_1423159766900
&api_key=YOUR_API_KEY_HERE
&job_id=dummyr7ndr6w43y25reqpfnqu83dummy   << Job ID of Report on Export Queue
&_=[Cache refresh Timestamp]

JSON Response

jQuery18306083544725552201_1423159766900(
{  
   status_code:200,
   response_size:"408",
   data:{  
      status:"complete",      << Status of Report on Export Queue
      percent_complete:100,   << Percent Completion of Report on Export Queue
      data:{  
         format:"csv",
                              << Report Download Link when Report Status is "complete"
         url:"https://s3.amazonaws.com/hasfiles/tmp/#######-#######-dummy.csv?response-content-disposition=attachment%3B%20filename%3D%22tmp%2F#######-#######-dummy.csv%22&AWSAccessKeyId=dummy&Expires=1423764571&Signature=QMs%dummy%dummy%3D"
      }
   }
}
)

Mapping Platform Reporting to Record’s Fields of Endpoint

This is a complete listing of all available data points, also referred to as the fields, provided by the StatAdvertiser model, which endpoint the TUNE Reporting API’s Actuals is bound.

Group By

actuals_group_by

Reporting Actuals Group By Fields
Label Field Name
Agency ID agency_id
Agency agency.name
Attribution Method match_type
Campaign ID campaign_id
Campaign campaign.name
Country ID country_id
Country country.name
Currency currency_code
Destination URL ID campaign_url_id
Destination URL campaign_url.name
Event ID site_event_id
Event site_event.name
Integration ID ad_network_id
Integration ad_network.name
Is Re-Engagement is_reengagement
Is View-Through is_view_through
Mobile App ID site_id
Mobile App site.name
Partner ID publisher_id
Partner publisher.name
Purchase Validation Status purchase_validation_status
Region ID region_id
Region region.name

Show

actuals_show

Reporting Actuals Show Fields
Label Field Name
Attributed Events paid_events
Attributed Installs paid_installs
Campaign Count campaign_count
Clicks Unique ad_clicks_unique
Clicks ad_clicks
Event Assists paid_events_assists
Events events
Impressions Unique ad_impressions_unique
Impressions ad_impressions
Install Assists paid_installs_assists
Installs installs
Margin profit
Non-Windowed Event Contributions non_events_assists
Non-Windowed Install Contributions non_installs_assists
Opens opens
Organic Installs organic_installs
Payouts payouts
Publisher Count publisher_count
Revenues Local revenues
Revenues USD revenues_usd
Updates updates

Audience

actuals_audiences

Reporting Actuals Audience Fields
Label Field Name
Age age
Device Brand wurfl_brand_name
Device Model wurfl_model_name
Device OS wurfl_device_os
Device Type device_type
Gender gender
OS Jailbroke os_jailbroke
Test Profile ID test_profile_id
Test Profile test_profile.name

Partner

actuals_partner

 

Reporting Actuals Partner Fields
Label Field Name
Partner Ad publisher_sub_ad.name
Partner Ad ID publisher_sub_ad_id
Partner Ad Group publisher_sub_adgroup.name
Partner Ad Group ID publisher_sub_adgroup_id
Partner Campaign publisher_sub_campaign.name
Partner Campaign ID publisher_sub_campaign_id
Partner Campaign Reference publisher_sub_campaign.ref
Partner Keyword publisher_sub_keyword.name
Partner Keyword ID publisher_sub_keyword_id
Partner Placement publisher_sub_placement.name
Partner Placement ID publisher_sub_placement_id
Partner Publisher publisher_sub_publisher.name
Partner Publisher ID publisher_sub_publisher_id
Partner Site publisher_sub_site.name
Partner Site ID publisher_sub_site_id
Reference ID publisher_ref_id

Mine

actuals_mine

Reporting Actuals Mine Fields
Label Field Name
My Ad ID advertiser_sub_ad_id
My Ad advertiser_sub_ad.name
My Adgroup ID advertiser_sub_adgroup_id
My Adgroup advertiser_sub_adgroup.name
My Campaign ID advertiser_sub_campaign_id
My Campaign Reference advertiser_sub_campaign.ref
My Campaign advertiser_sub_campaign.name
My Keyword ID advertiser_sub_keyword_id
My Keyword advertiser_sub_keyword.name
My Partner ID advertiser_sub_publisher_id
My Partner advertiser_sub_publisher.name
My Placement ID advertiser_sub_placement_id
My Placement advertiser_sub_placement.name
My Site ID advertiser_sub_site_id
My Site advertiser_sub_site.name
User ID user_id
Have a Question? Please contact support@tune.com for technical support.