SKAdNetwork and AdAttributionKit
Get Apple's own install reports for every iOS ad network, with conversion values Fictura sets from real trials and revenue.
SKAdNetwork (SKAN) and AdAttributionKit (AAK) are Apple's privacy-safe install reports. When an ad on any network leads to an install, the iPhone sends a report (a "postback") to that network a day or more later. You can ask Apple to send you a copy of the winning postback too. Fictura receives those copies and sets the conversion value they carry.
Postbacks are counts per network and campaign, never per person. They don't change any install's match type.
1. Add the copy endpoints to Info.plist
| Framework | Info.plist key | Copies are posted to |
|---|---|---|
| SKAdNetwork | NSAdvertisingAttributionReportEndpoint (string) | /.well-known/skadnetwork/report-attribution/ |
| AdAttributionKit | AttributionCopyEndpoint (string), inside the AdAttributionKit dictionary | /.well-known/appattribution/report-attribution/ |
In Expo, set both in app.json:
{
"expo": {
"ios": {
"infoPlist": {
"NSAdvertisingAttributionReportEndpoint": "https://fictura.co",
"AdAttributionKit": {
"AttributionCopyEndpoint": "https://fictura.co"
}
}
}
}
}Set both keys to https://fictura.co, the same value for every app. Don't use your own domain or a branded link domain.
Apple posts copies only to the registrable root of a domain (it ignores subdomains like go.yourapp.com) and adds the /.well-known/... path itself. fictura.co answers both paths and forwards each POST, unchanged, to Fictura's receivers, which match the copy to your app by its App Store id.
An app has one copy URL per framework. If another attribution tool already gets your copies, Fictura can't get them too.
See Apple's docs: Configuring an advertised app (AdAttributionKit), Configuring an advertised app (SKAdNetwork) and NSAdvertisingAttributionReportEndpoint.
2. What Fictura does with each copy
- Stores it as received: framework, version, ad network, campaign or source identifier, conversion values, postback sequence, whether it won, redownload and fidelity.
- Checks Apple's signature when Apple's public key for that version is known, and marks the copy verified or not.
- Never fails on a bad copy. A malformed body is logged, not answered with a server error.
3. Conversion values, set by the server
Conversion values tell the network what happened after install. Fictura sets them from what your app really did, so you don't hard-code a schema in the app.
The latest SDK calls GET /api/v1/skan/value when the app opens and after trial_started and purchase_completed. The answer is { fine, coarse, lock_window }, or 204 when nothing should change. The SDK then calls SKAdNetwork's updatePostbackConversionValue(_:coarseValue:lockWindow:) and, on iOS 17.4 and later, AdAttributionKit's Postback.updateConversionValue.
The default schema:
| Value | Meaning |
|---|---|
| Fine value (6 bits) | Trial started (1 bit), paid (1 bit), revenue bucket (3 bits), retained on day 1 (1 bit). |
Coarse low | Opened the app. |
Coarse medium | Started a trial. |
Coarse high | Paid. |
Change the schema in Dashboard → Attribution → Settings (/dashboard/attribution/settings). A new schema applies to installs from then on.
4. Read the report
Dashboard → Attribution → SKAN (/dashboard/attribution/skan) shows postbacks by ad network and campaign, with their conversion values. Apple delays every postback by at least a day, and hides values when a campaign is too small, so these numbers trail the rest of the dashboard.