The following document describes the steps necessary to facilitate SKAdNetwork data ingestion to a custom clear-labeled endpoint. The SKAdNetwork signals will be aggregated and can be made available as summary reports to your Advertising partners via their MMPs. Doing so allows your Advertising partners to retain a holistic view of their marketing efforts.

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

Integration Steps

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

Send SKAdNetwork data to your custom postback endpoint.

Option 1: Recommended — Have SKAdNetwork data sent directly from SKAdNetwork. Use the provided postback URL as the conversion postback destination when registering with SKAdNetwork. The attribution signature will be used to validate the postback with Apple and the transaction-id will be used for deduplication.

NOTE: Upon registering with SKAdNetwork, you will receive an email from Apple requesting a URL to send conversion postbacks to. This is the URL you should supply.

Option 2: If you are ingesting the data directly from SKAd into your internal systems, you can forward those signals to the postback endpoint (provided above, step 1) using the below format. The attribution signature will be used to validate the postback with Apple and the transaction-id will be used for deduplication.

Required Fields for Option 2:

Name	Description	Type
version	The SKAdNetwork API version.	String
ad-network-id	Your SKAdNetwork Identifier.	String
campaign-id	SKAdNetwork Campaign ID.	Integer
transaction-id	Unique ID for deduplication.	String
app-id	The Advertiser app ID in iTunes.	Integer
attribution-signature	SKAdNetwork signature as specified by Apple. Used for postback validation.	String
redownload	A boolean flag that indicates if the customer reinstalled the app.	Integer ( 0 or 1 )
source-app-id	The Publisher app ID in Itunes.	Integer
conversion-value	Unsigned 6-bit value that the installed app provided. The conversion-value appears only if the installed app provides it, and if providing the parameter meets Apple’s privacy threshold. A value between 0-63.	Unsigned Integer

Postback Ingestion:

HTTP Post Request —

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

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

Body

{
    "version": "string",
    "ad-network-id": "string",
    "campaign-id": integer,
    "transaction-id": "string",
    "app-id": integer,
    "attribution-signature": "string",
    "redownload": integer,
    "source-app-id": integer,
    "conversion-value": unsigned integer
}

{

"version": "string",

"ad-network-id": "string",

"campaign-id": integer,

"transaction-id": "string",

"app-id": integer,

"attribution-signature": "string",

"redownload": integer,

"source-app-id": integer,

"conversion-value": unsigned integer

}

Example

{
    "version": "2.0",
    "ad-network-id": "com.example",
    "campaign-id": 42,
    "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
    "app-id": 525463029,
    "attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
    "redownload": 1,
    "source-app-id": 1234567891,
    "conversion-value": 20
}

{

"version": "2.0",

"ad-network-id": "com.example",

"campaign-id": 42,

"transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",

"app-id": 525463029,

"attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",

"redownload": 1,

"source-app-id": 1234567891,

"conversion-value": 20

}

HTTP 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={integer}&source-app-id={integer}&conversion-value={unsigned integer}

Example
{yoursubdomain}.adsmeasurement.com/v1/skad/postback?version=2.0&ad-network-id=com.example&campaign-id=42&transaction-id=6aafb7a5-0170-41b5-bbe4-fe71dedf1e28&app-id=525463029&attribution-signature=MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=&redownload=1&source-app-id=1234567891&conversion-value=20

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

SKAdNetwork Reporting API

A separate, reporting-focused spec will be provided pending potential changes introduced by Apple during the beta. The document will outline how to make SKAdNetwork data available to MMPs, who can in turn make it available to advertisers.

SKAd Certified Partner

For networks who are sending SKAd data and who wish to be SKAdNetwork Certified, Kochava will need to receive the skad_campaign_id and partner_campaign_id on the clicks and impressions we receive from that partner. Please contact integrations@kochava.com to get those parameters added to your template.

AdsMeasurment(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.

SKAdNetwork Integration