Support Home > Campaign Management > Campaign Cost Measurement

Campaign Cost Measurement


Feature Summary: The following document defines the methods to include cost collection and aggregation for networks within a new or existing campaign.

NOTE: A list of cost integrated partners is provided within this document. If a network you are looking for is not listed, please contact your Client Success Management team to initiate the network integration process.

NOTE: Kochava does not currently support currency conversion for cost.


How Networks Pass Cost Data

Method 1 — Cost Data is Passed on the Click/Impression URL:

Parameters to be included in the click/impression URL: bid_type={IO terms}&bid_won={amount}

bid_type: indicates the pricing type, such as cost per install (bid_type=CPI), cost per impression (CPM), cost per click (CPC) and cost per action (CPA).

bid_won: indicates the cost amount in USD. For example, if a user clicks on an ad and the click URL is populated with bid_type=CPI&bid_won=5, once that user installs the install_cost associated to that install will be $5.

NOTE: Network partners not listed as passing cost data on the click/impression URL may be able to support it. The listed partners are those who have opted to include the two cost parameters (bid_type and bid_won) in their tracking template. This integration step is not required as the two cost parameters can be manually appended to each tracking url after it has been exported from the dashboard.

 

BEST PRACTICE: If you do not see the network listed as passing cost data on the click/impression url, we recommend confirming with them if they are able to support passing bid_type and bid_won.

BEST PRACTICE: If a network is listed as passing cost data on the click/impression URL, we recommend reaching out to them prior to launching your campaigns to ensure they start populating the cost macros on your impression and click URLs.


Method 2 — Cost Data is Passed through API Integration:

An integration can be built where Kochava will make hourly requests to the partner’s reporting API in order to retrieve cost data.

API Detail: A request for hour 7 returns a CPI value of $5 for campaign_id=123, ad_id=abc, country_code=US. If we receive an install in hour 7, which matched to a click/impression where the click/impression URL contains campaign_id=123, ad_id=abc, country_code=US, then we will assign that install a cost amount of $5.

NOTE: campaign_id, ad_id and country_code were arbitrarily chosen parameters for this example. The integration can specify any list of parameters for matching which provide sufficient granularity for accurate cost data assignment, as long as the list of matching parameters are available both via the API and on the click/impression urls.

API Summary: A rolling daily total cost amount is tracked and updated on an hourly basis. This does not get tied to individual impression, click, install, or event records in Kochava, hence is available only in summary reports and summary query tables. This data can be split to the tracker and country level. In addition, the calls will be repeated in order to collect restated amounts 1 day, 2 days, 7 days, 14 days, 30 days, and 60 days later to account for any adjustments made by the partner.

NOTE: The API summary integration requires that the Kochava tracker ID be included in the campaign name within the network dashboard, with the exception of Facebook where the tracker ID should be included in the ad set name. The tracker id value is a numeric string available within the campaign manager in your account. (i.e., 13033304537).


Enabling Cost Tracking for API Integrated Partners

Update Tracker Information:

  1. Log in to Kochava.
  2. Select the desired Account and App.
  3. Select Apps & Assets > Campaign Manager.
  4.  

     

  5. Locate the desired tracker and Select Tracker Tools () > Edit.
  6. Locate the Pricing section and select a Price Type:
    1. CPC (Cost per Click)
    2. CPI (Cost per Install)
    3. CPM (Cost per Mille)
    4. CPA (Cost per Action)
    5. CPC/CPI (Cost per Click and Cost per Install)
    6. CPM/CPI (Cost per Mille and Cost per Install)
    7. CPM/CPC (Cost per Mille and Cost per Click)

     

    NOTE: When Price Override in this section is left at $0.00, the price type will determine the price type applied for the API integrated partner.

     

    BEST PRACTICES: Any dollar amount that is added into the Price Override field will override any cost data that is sent by the network. Price data can vary. To obtain the most accurate cost data leave the Price Override field at $0.00.

 

Enter Network Credentials:

  1. Click Apps & Assets > Partner Configuration.
  2. Locate the desired network.
  3. Select Network Tools () > Credentials.
  4.  

     

  5. Enter network specific authentication data.
  6. Toggle Collect Cost > On.
  7. NOTE: If available, multiple account IDs may be associated with cost collection.

  8. Toggle Collect Restated Cost > On (optional).
  9. Click Save.

How Cost Data is Reported

Kochava reports on cost using two different methods:

 

Detail Cost Data:

Gathered via click/impression urls and API detail. A cost amount is assigned to each record (e.g., each install in the case of CPI), which can then be reported on in detail or summary format.

Analytics:

  • Analytics Overview — Metric: Cost
  • Cost & ROI — Metric: Cost
  • Explorer — Metrics List — Metric: Cost

Row Level Query Tables:

  • installs_primary — Fields: cost, cost_type
  • event_primary — Fields: cost, cost_type
  • clicks_primary — Fields: cost, cost_type
  • impressions_primary — Fields: cost, cost_type

Row Level Reports:

  • Click Report — Fields: click_price
  • Install Report — Fields: install_price

Summary Reports:

  • Network Summary Report — Field: total_cost_on_traffic_selected

Rolling Daily Total Spend:

Gathered via API summary. A rolling daily total cost amount is collected from the partner, which can then be reported on in summary format with tracker and country level granularity.

Summary Query Tables:

  • network_cost Table
  • network_cost_restated Table

Summary Reports:

  • Network Summary Report — Field: total_spend_network_reported, total_spend_network_restated_1_Day, total_spend_network_restated_2_Day, total_spend_network_restated_7_Day, total_spend_network_restated_14_Day, total_spend_network_restated_30_Day, total_spend_network_restated_60_Day
  • NOTE: The above listed fields under Summary Reports are not included by default and can be added by selecting network spend and network spend_restated under Traffic options on the report request page. Group by options are also limited when adding Network Spend to your report due to the level of granularity available.


Collect Cost & Restated Cost Enabled Networks

 

Network Name
Click Parameters
Impression Parameters
API Detail
API Summary
3S Studio
A4G DSP
Aarki
Ad Attraction
AdAction
AdColony
AdColony Performance Media
Aditor
adjoe
AdMarvel
Adperio
Advolution
Altrooz
Amazon
Apple Search Ads
AppLift
AppLovin
AppNext
Apponboard
ApproachX
Aura ironSource
Bidalgo
BidMotion
BidMotion
Blind Ferret
Blue Water Ads
Brusmedia
Captify
Chartboost
CrossChannel
CrossInstall
DataLift
DigitalTurbine
eyeonX AG
Facebook
Fyber
Google Adwords
GlobalWide Media
Headway Digital
Iconpeak
Inagral
Inmobi
Instagram
internemo
ironSource
Jampp
JuicyAds
Kenshoo
Kixer
Lifestreet
Manage
Marketit
MindGeek
Mistplay
MoBrain
Mobpartner
Motive Interactive
Nanigans
Oauth Ad Platforms
Performance Advertising
Performance Revenues
Phunware/Tapit
Pinsight
PowerInbox – General
Raftika
Remerge
RevMob
RevX
Rocket10
Saut Media
SearchAdsHQ Analytics
Sirok
Smadex
Smart.bid
SmartNews
Snapchat
Tapjoy
Taptica
Twitter
UnityAds
Urban Connection
Valuepotion
VideoAmp
Vungle
Wagawin
WeQ
Wangle Network

Network Specific Instructions on Cost Credentials Entry

The following table provides the schemas for customers who have multiple accounts with the identified partner platforms.

NOTE: In some cases, cost is requested from a partner API based upon a unique ID. In these cases, Kochava supports comma delimited values in the relevant UI field to ensure that cost is gathered from all active partner accounts.

 

Partner Schema
Facebook Comma separated account IDs.
Google Adwords Comma separated client customer IDs.
Nanigans Comma separated site IDs.

Apple Search Cost Credentials

  1. Log in to Apple Search Ads.
  2. Click on the Account > Settings.
  3.  

     

  4. Click the API tab.
  5. Click Create API Certificate
  6. Enter a API certificate name.
  7. Select an Account Level:
    1. Account admin
    2. Account Read only
  8. Click Create.
  9.  

     

  10. Click Actions > Download certificate.
  11.  

     

    NOTE: The PEM and key are located within the zip file.

  12. Add the PEM and key to Kochava.
  13.  

    BEST PRACTICES: Include the header and footer lines when the values are pasted into Kochava (—–BEGIN CERTIFICATE—–, —END CERTIFICATE—–, etc.).

     

 
 

Last Modified: Oct 16, 2019 at 1:24 pm