SKAdNetwork integration guide for ad networks

Using this method, ad networks forward each postback received from the device to AppsFlyer.

The ad network:

• Receives the postback from the iOS device
• Enriches the postback with:
  • Ad network campaign ID and campaign name
  • IP address received from the device, required mainly for geo resolution purposes. 
  • The timestamp of the postback sent from the iOS device
• Sends the postback to AppsFlyer.

Curl example—enriched SKAd postback

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks' \
--header 'Content-type: application/json' \
--data-raw '{
    "version":"2.0",
    "app-id": 888707086,
    "ip": "192.0.2.0",
    "ad-network-campaign-name": "skadnetwork_abc_campaign",
    "source-app-id": 888707074,
    "ad-network-id": "abcabcabc.skadnetwork",
    "transaction-id": "68eb3d91-15f5-44ee-9267-25c7655c20b6",
    "redownload": false,
    "attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
    "timestamp": "1597156649200",
    "ad-network-campaign-id": "222222",
    "conversion-value": 63,
    "campaign-id": 99
}'

Using this method, the ad network responds to the device with an HTTP redirect command (307), requesting the device to send the postback directly to AppsFlyer. 

The redirect method has the following advantages:

• Increased advertiser trust: The MMP acts on behalf of an advertiser. By providing AppsFlyer access to the postback firsthand, advertisers are confident that postbacks are not manipulated in transit.
  
• No processing required by the ad network: Ad networks respond with the redirect command (to the device), thus eliminating the need to process postbacks. In comparison, the enrich and forward method requires that ad networks consume the postback, enrich it with additional parameters, and finally forward it to AppsFlyer.

Implementation

1. Configure your server to respond with an HTTP 307 response redirecting the postback to https://skadredirect.appsflyer.com/api/redirects
2. Append query params that contain campaign details using the query params listed in the table that follows. Regard the sending of your campaign details as mandatory. Campaign details enable us to enrich SKAdNetwork data with cost and other campaign data and enable advertisers to effectively optimize campaigns.

Example redirect URL

https://skadredirect.appsflyer.com/api/redirects?
&ad-network-campaign-id=243232&ad-network-campaign-name=yarg_campaign_name
&ad-network-adset-name=dsdsa

• For each postback sent from the ad network to AppsFlyer, AppsFlyer sends:
  • One install postback. Redownloads are signaled by the redownload parameter. 
  • Zero to several in-app event postbacks. The exact number depends on the translation of the conversion value. See simulated postbacks.
• When you consume postbacks, the same install or event can be attributed by more than one AppsFlyer attribution solution. Use the attribution_source parameter to differentiate between postback types. 

Example of an install SKAd postback sent by AppsFlyer

http://YourCompanyDomain.com/event?site_id=(publisher-id)&install_time=(timestamp)
&skan_ad_network_time=(timestamp)
&skan_af_received_time=(timestamp)
&attribution_provider=skadnetwork
&app_id=(id123456789)&country=(ZA)&campaign=(campaign-name)
&campaign_id=(campaign-id)&skad_ambiguous_event=(boolean)
&redownload=(boolean)
&af_skad_nonce=(uuid)

Example of an in-app SKAd postback sent by AppsFlyer

http://YourCompanyDomain.com/event?site_id=(publisher-id)&install_time=(timestamp)
&skan_ad_network_time=(timestamp)
&skan_af_received_time=(timestamp)&revenue=(value)
&currency=(code)&event_name=(event-name)&attribution_provider=skadnetwork
&app_id=(id123456789)&country=(ZA)&campaign=(campaign-name)
&campaign_id=(campaign-id)&skad_ambiguous_event=(boolean)
&redownload=(boolean)
&af_skad_nonce=(uuid)

• Using this method, the ad network sends AppsFlyer preprepared postbacks to AppsFlyer test apps, as detailed in the table below. AppsFlyer replies with decoded postbacks to the ad network.
• Each test app has a different conversion value mapping, as detailed in the table.

Using this method, the ad network sends AppsFlyer actual SKAd postbacks from live apps.