Apple Ads
Exact Apple Ads attribution from the AdServices token, with no ATT prompt, plus an Apple Ads Platform API connection for spend.
Apple Ads (formerly Apple Search Ads) has two separate parts in Fictura: attribution, which says which campaign and keyword brought each install, and spend, which says what you paid.
Attribution: the AdServices token
- On first launch, the latest SDK asks Apple's AdServices framework for an attribution token and sends it with the first event batch.
- Fictura's server exchanges the token with Apple (
POST https://api-adservices.apple.com/api/v1/). Apple can answer404for a few seconds after the token is made, so Fictura retries up to 3 times about 5 seconds apart, as Apple advises. - When Apple says the install came from an ad, Fictura stores the org, campaign, ad group, keyword, ad and claim type on the install's attribution row.
The match type is apple_ads, an exact match. It replaces any weak answer the install had.
- No ATT prompt. The token needs no tracking permission and no IDFA.
- Tokens last 24 hours. An install whose first batch reaches Fictura more than a day after launch can't be matched this way.
- No match is normal. Apple returns no campaign when the install didn't come from an ad, or when the ad group uses age or gender targeting.
See Apple's docs: attributionToken().
Spend: the Apple Ads Platform API
Connect your Apple Ads account in Dashboard → Attribution → Settings (/dashboard/attribution/settings). Fictura then reads spend and campaigns once a day, so Apple Ads installs get a cost and a ROAS.
What you need from Apple Ads:
- An account admin invites an API user with read access.
- That user creates a key and pastes the public key in Apple Ads.
- Apple Ads shows the client id, team id and key id. Paste those and the private key into Fictura.
Apple's older Campaign Management API stops working on January 26, 2027. See Apple's docs: Implementing OAuth for the Apple Ads Platform API.
Apple's own reports
Apple Ads installs also arrive through SKAdNetwork and AdAttributionKit copies, as counts per campaign. Those are a second view of the same ads; they don't add installs.
Reading the attribution dashboard
What each tile, panel and column means, how sure each number is, and when a number is withheld instead of shown wrong.
SKAdNetwork and AdAttributionKit
Get Apple's own install reports for every iOS ad network, with conversion values Fictura sets from real trials and revenue.