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.
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 Facebook Campaign Name or Group 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:
- Log in to Kochava.
- Select the desired Account and App.
- Select Links > Campaign Manager.
- Locate the desired tracker and Select Tracker Tools (⋮) > Edit.
- Locate the Pricing section and select a Price Type:
- CPC (Cost per Click)
- CPI (Cost per Install)
- CPM (Cost per Mille)
- CPA (Cost per Action)
- CPC/CPI (Cost per Click and Cost per Install)
- CPM/CPI (Cost per Mille and Cost per Install)
- 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.
Enter Network Credentials:
- Click Apps & Assets > Partner Configuration.
- Locate the desired network.
- Select Network Tools (⋮) > Credentials.
- Enter network specific authentication data.
- Toggle Collect Cost > On.
- Toggle Collect Restated Cost > On (optional).
- Click Save.
NOTE: If available, multiple account IDs may be associated with cost collection.
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 | ✔ | ✔ | ||
✔ | ✔ | |||
Fyber | ✔ | ✔ | ||
Google Adwords | ✔ | ✔ | ||
GlobalWide Media | ✔ | ✔ | ||
Headway Digital | ✔ | |||
Iconpeak | ✔ | |||
Inagral | ✔ | ✔ | ||
Inmobi | ✔ | |||
✔ | ✔ | |||
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 | ✔ | ✔ | ✔ | ✔ |
TikTok | ✔ | ✔ | ||
✔ | ✔ | |||
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 |
---|---|
Comma separated account IDs. | |
Google Adwords | Comma separated client customer IDs. |
Nanigans | Comma separated site IDs. |
Apple Search Cost Credentials
- Log in to Apple Search Ads.
- Click on the Account > Settings.
- Click the API tab.
- Click Create API Certificate
- Enter a API certificate name.
- Select an Account Level:
- Account admin
- Account Read only
- Click Create.
- Click Actions > Download certificate.
- Add the PEM and key to Kochava.
NOTE: The PEM and key are located within the zip file.
Google AdWords Cost Credentials
NOTE: For more information about collecting Cost within Kochava, refer to our Campaign Cost Measurement support documentation.
- Log in to Kochava.
- Select the desired Account and App.
- Select Apps & Assets > Partner Configuration.
- Locate the Google AdWords Partner Configuration.
- Click Partner Configuration Tools (⋮) > Credentials.
- Click Sign into Google and enter credentials.
- Enter the Google Client Customer ID.
- Select the Time Zone.
- Toggle Collect Cost to ON.
- Toggle Collect Restated Cost to ON. (optional)
- Click Save.
NOTE: The Public Key is not required in order to collect Cost data. For more information on Google’s Public Key, refer to Google’s support documentation.
NOTE: The Google Client Customer ID is located in the upper right hand corner of the screen.