Apple SKAdNetwork

When you finish, Apple posts signed install postbacks to Datalyr and Datalyr stores each one with its signature result.

Stored postbacks don’t feed Reports or Overview yet. Keep your existing mobile measurement partner as your SKAdNetwork reporting source.

Before you start

Requirement	Detail
iOS Bundle ID	Xcode: Target → General → Bundle Identifier
Plist access	You can edit `Info.plist` and ship a build
Datalyr SDK	The iOS or React Native SDK already sends events. An Expo app needs a development build, because Expo Go cannot load the SKAdNetwork module

Register the source

Open Sources

Open Sources. Find the Apple SKAdNetwork card. Select connect.

Enter the Bundle ID

Fill the iOS Bundle ID. Use the exact reverse-DNS string from Xcode.

Pick a template

Pick E-commerce, Gaming, or Subscription. This sets the conversion-value mapping.

Save

Select connect.

Point Apple at Datalyr

Apple fixes the postback path. It reads only the domain from your app, then posts to /.well-known/skadnetwork/report on that domain.

Set the plist value to the bare domain https://ingest.datalyr.com. A path or query string in that value ships with the build. Apple then sends nothing until you ship again.

Open Info.plist

Open your app’s Info.plist in Xcode.

Add the endpoint key

Add the key NSAdvertisingAttributionReportEndpoint. Set its value to https://ingest.datalyr.com.

Ship a build

Archive the app. Submit the build to App Store Connect.

<key>NSAdvertisingAttributionReportEndpoint</key>
<string>https://ingest.datalyr.com</string>

Set the conversion value

Call the helper at each milestone you want Apple to encode. Fine values run from 0 to 63.

import DatalyrSDK

try await AdAttributionKitBridge.shared.updatePostbackConversionValue(
    fineValue: 56,
    coarseValue: .high,
    lockWindow: true
)

import { ConversionValueEncoder, ConversionTemplates } from '@datalyr/react-native';

const encoder = new ConversionValueEncoder(ConversionTemplates.subscription);
const fineValue = encoder.encode('subscribe', { revenue: 49.99 });

Set skadTemplate at initialization and call trackWithSKAdNetwork() to let the SDK encode the value for you. On iOS 17.4 and later the SDK sends each value to both SKAdNetwork and AdAttributionKit. On iOS 18 and later it also sends re-engagement values. See iOS SDK for the per-version table and the two optional Info.plist keys, EligibleForAdAttributionKitReengagementPostbackCopies and AttributionCopyEndpoint. The three templates map these event names to fine values.

Template	Event names
`ecommerce`	`view_item`, `signup`, `add_to_cart`, `begin_checkout`, `subscribe`, `purchase`
`gaming`	`session_start`, `ad_watched`, `level_complete`, `tutorial_complete`, `achievement_unlocked`, `purchase`
`subscription`	`cancel`, `signup`, `payment_method_added`, `trial_start`, `upgrade`, `subscribe`

Ad network IDs

SKAdNetworkItems is a key for apps that show ads. An advertised app does not need it to receive postbacks. Some ad networks ask advertisers to list their IDs anyway. In an Expo app, the networks option of the config plugin writes them. In a native app, add them to your own Info.plist. See React Native SDK.

Reference

Item	Value
Receiver	`POST https://ingest.datalyr.com/.well-known/skadnetwork/report`
Method	`POST` only. Anything else returns HTTP 405
Body limit	16 KB. A larger body returns HTTP 413
Postback versions parsed	`2.1`, `2.2`, `3.0`, `4.x`
Signature check	ECDSA P-256 over SHA-256, against Apple’s published public key
Signature failure	The row is stored with `signature_valid = 0`. We never drop it

Fields we store

version, ad_network_id, campaign_id, source_identifier, app_id, source_app_id, source_domain, conversion_value, coarse_conversion_value, did_win, redownload, postback_sequence_index, transaction_id, signature_valid, receiving_host, raw_payload. Version 4 postbacks carry no campaign-id, so we derive campaign_id from the last two digits of source-identifier.

Rejections

HTTP	Cause
400	The body is not JSON, is not an object, or omits `ad-network-id` or `transaction-id`
405	The request method is not `POST`
413	The body is over 16 KB

Verify

Open a terminal.
Run the command below.
Confirm the response body reads {"ok":true}.
Ship the build with the plist key set.
Wait for Apple’s postback window. Apple sends the first postback 24 to 48 hours after an install.

curl -i -X POST https://ingest.datalyr.com/.well-known/skadnetwork/report \
  -H 'Content-Type: application/json' \
  -d '{"version":"4.0","ad-network-id":"example.skadnetwork","transaction-id":"doc-check-1","app-id":"123456789"}'

When it does not work

Symptom	Cause	Check	Fix
The check returns 404	The request path is wrong	The path in your request	Use `/.well-known/skadnetwork/report`
The check returns 400	The body omits `ad-network-id` or `transaction-id`	The JSON you sent	Add both fields
The check returns 413	The body is over 16 KB	The payload size	Send a smaller body
Apple sends nothing after a week	The plist value carries a path, or the build predates the change	`NSAdvertisingAttributionReportEndpoint` in the shipped build	Set the value to the bare domain. Ship again

iOS SDK: the conversion-value helper signature.
React Native SDK: the template encoder.
Conversion delivery: how server-side conversions reach ad platforms.

Get started

Installation

Revenue

Leads

Using Datalyr

Advanced

Integrations

Account & billing

Troubleshooting

Before you start

Register the source

Point Apple at Datalyr

Set the conversion value

Ad network IDs

Reference

Fields we store

Rejections

Verify

When it does not work

Next

​Before you start

​Register the source

​Point Apple at Datalyr

​Set the conversion value

​Ad network IDs

​Reference

​Fields we store

​Rejections

​Verify

​When it does not work

​Next

Before you start

Register the source

Point Apple at Datalyr

Set the conversion value

Ad network IDs

Reference

Fields we store

Rejections

Verify

When it does not work

Next