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 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:

1. Log in to Kochava.
2. Select the desired Account and App.
3. Select Links > Campaign Manager.

 



 

4. Locate the desired tracker and Select Tracker Tools (⋮) > Edit.
5. 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. Enter network specific authentication data.
5. Toggle Collect Cost > On.

NOTE: If available, multiple account IDs may be associated with cost collection.

6. Toggle Collect Restated Cost > On (optional).
7. 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 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.

 

---

Apple Search Cost Credentials

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

 



 

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

 



 

8. Click Actions > Download certificate.

 



 

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

9. Add the PEM and key to Kochava.

 

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