Developing Document: This is a dynamic document that will be updated as Kochava adjusts to changes and updates that come from Apple.

Integration Steps

1. Choose your subdomain — This will be your unique and secure repository of your SKAdNetwork conversion data.

You will be provided a postback endpoint for sending SKAdNetwork data: {yoursubdomain}.adsmeasurement.com/v1/skad/postback

2. Provide your SKAdNetwork Ad Network ID to Kochava.

Your Ad Network ID is assigned and provided to you by SKAdNetwork when completing their registration process.

3. Send SKAdNetwork data to your custom postback endpoint.

NOTE: Regardless of which method you choose to share SKAdNetwork data with Kochava, be sure to send every data point included on the original payload sent to you from SKAdNetwork. Kochava will verify each postback through Apple. If there are any missing data points, the postback will be dropped and not reflected in the Kochava system.

Required Data Points:

*Only required on version 3.0+
**Not included on version 3.0+ when did-win=false or when Apple’s privacy thresholds are not met.
***Only required on version 4.0+

Option 1: Recommended — Configure an HTTP 307 Redirect

• For postbacks received from SKAdNetwork, implement a 307 redirect, routing to your custom Kochava-assigned endpoint (see step 1).
• Append query parameters to the redirect endpoint in order to enrich the original postback with Campaign Name, Campaign ID, etc, as represented in your system. Use the parameter names provided in the table below.

Option 2: Forward postbacks directly from your server

• If you are ingesting the data directly from SKAdNetwork into your internal systems, you can forward those signals to the postback endpoint (provided above, step 1) using the below format. Before forwarding to Kochava, add additional campaign information to the original payload you received from SKAdNetwork.

Postback Fields for Option 2:

Postback Ingestion:

HTTPS Post Request —

Header
Content-Type: application/json
Accept: application/json

Endpoint
{yoursubdomain}.adsmeasurement.com/v1/skad/postback

HTTPS Get Request —

Endpoint
{yoursubdomain}.adsmeasurement.com/v1/skad/postback?version={string}&ad-network-id={string}&campaign-id={integer}&transaction-id={string}&app-id={integer}&attribution-signature={string}&redownload={boolean}&source-app-id={integer}&conversion-value={unsigned integer}&skad_ip={string}&skad_ts={integer}&partner_campaign_name={string}&partner_campaign_id={string}

Example
{yoursubdomain}.adsmeasurement.com/v1/skad/postback?version=2.0&ad-network-id=1abc12a2a1.skadnetwork&campaign-id=42&transaction-id=6aafb7a5-0170-41b5-bbe4-fe71dedf1e28&app-id=525463029&attribution-signature=MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi%2Bixk%2FOiRysCGQDZZ8fpJnuqs9my8iSQVbJO%2FoU1AXUROYU%3D&redownload=false&source-app-id=1234567891&conversion-value=20&skad_ip=49.206.2.68&skad_ts=1607346100&partner_campaign_name=campaign%20name%20example&partner_campaign_id=123456789

Confirm the details above with Integrations@kochava.com and we will get to work establishing your domain. As soon as it is complete we will confirm once it is ready to receive data.

Impression/Click Counts and Related Metrics

The following guidance pertains to cases where the media partner is using Option 2 (forwarding SKAdNetwork postback from their own server after enriching with campaign data). Nuances for cases where the media partner is using Option 1 (having SKAdNetwork data sent directly from SKAdNetwork to Kochava) are noted where applicable.

SKAdNetwork reporting in Kochava includes impression/click counts and related metrics. In order to associate this data to SKAdNetwork data, you must pass the same list of campaign enrichment fields on your real-time impressions and clicks as you did on your forwarded SKAdNetwork payloads. In addition, on real-time impression and clicks, you must pass a “skad_mapping” field that is a comma-separated list of campaign enrichment key names. By doing so, Kochava will be able to report on impression/click counts and related metrics to the same level of grouping granularity as your aggregated SKAdNetwork payloads.

CAUTION: You must pass the same list of campaign enrichment parameters on your SKAdNetwork payloads as you pass on real-time impressions and clicks, otherwise your impression/click counts will show as zero and related metrics will not be populated.

If you are using Option 1 from above (having SKAdNetwork data sent directly from SKAdNetwork to Kochava), you must also pass the SKAdNetwork campaign ID on your real-time impressions and clicks. This allows Kochava to associate campaign data, impression/click counts, and related metrics to your SKAdNetwork data. Mapping for a single skad_campaign_id must be kept consistent for a minimum of 24 hours.

skad_mapping=partner_campaign_name,partner_campaign_id,site_id

NOTE: The skad_mapping parameter SHOULD NOT include the actual partner_campaign_name, partner_campaign_id, etc. This needs to be populated with the key name being used to send these values.

{
   "version":"2.0",
   "ad-network-id":"1abc12a2a1.skadnetwork",
   "campaign-id":42,
   "transaction-id":"6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
   "app-id":525463029,         "attribution-signature":"ABCCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
   "redownload":true,
   "source-app-id":1234567891,
   "conversion-value":20,
   "skad_ip":"49.206.2.68",
   "skad_ts":1607346100,
   "partner_campaign_name":"summer_july_campaign",
   "partner_campaign_id":"13579"
}

{
   "version":"2.0",
   "ad-network-id":"1abc12a2a1.skadnetwork",
   "campaign-id":42,
   "transaction-id":"6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
   "app-id":525463029,         "attribution-signature":"ABCCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
   "redownload":true,
   "source-app-id":1234567891,
   "conversion-value":20,
   "skad_ip":"49.206.2.68",
 	  "skad_ts":1607346100,
	"partner_campaign_name": "summer_july_campaign",
	"partner_campaign_id": "13579",
            "sub_campaign_name": "summer_independence_day_promo",
            "sub_campaign_id": "2468",
            "site_id": "11223344"     
}

Please contact integrations@kochava.com to get your iOS template updated.

SKAdNetwork Reporting

To access aggregated data relating to Kochava advertisers, you can pull from the Kochava reporting API or the Kochava dashboard via your Media Partner account. For more information, please refer to this support documentation.

AdMeasurement (Recommended)

Kochava for Publishers is a SaaS solution for facilitating first-party ad measurement. Kochava for Publishers sits outside and independent of Kochava’s MMP services, and allows for integration with any party granted access as a self-attributing/self-reporting platform with configurable lookback windows and attribution rules, including cross-device & cross-platform attribution.

If you are interested in utilizing Kochava for Publishers for first-party ad measurement in conjunction with SKAdNetwork support, please contact us to learn more.