• New postbacks: SKAdNetwork 4.0 sends three postbacks per install.
• Two types of conversion values: 
  • Fine conversion value: the 0-64 conversion value used until now
  • Coarse conversion value: only has three possible values - low, medium, and high.
• Source ID: Instead of a campaign ID, SKAdNetwork now supports a 4-digit Source ID that can be used to encode additional information. For example, you can use 2 digits to encode the campaign ID, the 3rd digit to encode country, and the 4th digit to encode creative or publisher.
• Depending on the level of anonymity (as determined by Apple's privacy thresholds), the Source ID actually included in a postback may include only the first 2 or 3 digits.

The following table summarizes the functionality of the 3 postbacks sent for each install.

Instead of the Campaign ID, SKAN 4.0 postbacks include a Source ID field that can include up to 4 digits.

You can choose what information to encode in the digits of the Source ID.

The actual number of digits included in the postback may be 2, 3, or 4, determined by Apple's privacy thresholds. Low-volume campaigns may be considered low anonymity and therefore yield only 2 digits of the Source ID. High-volume campaigns provide a high level of anonymity and therefore are expected to yield the full 4 digits of information in the first postback sent after an install.

Example:

In the following example, provided by Apple, 2 digits of the Source ID are used to encode the campaign ID, the 3rd digit is used to encode location, and the 4th encodes ad placement. Based on the anonymity level of the campaign (low, medium, or high), postbacks may include 2, 3, or 4 digits.

(Graphic: Apple)

Integrating with Singular's SKAdNetwork solution is a separate process from the normal attribution integration with Singular. Having a working attribution integration with Singular is a prerequisite before following the steps below to integrate with Singular's SKAdNetwork solution.

https://skadnetwork.singular.net/api/v1/skan_postback?adn_campaign_id=102&adn_campaign_name=My%20Campaign

{
  "version": "4.0",
  "ad-network-id": "com.example",
  "source-identifier": "5239",
  "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
  "app-id": 525463029,
  "attribution-signature":
    "MDYCGQCsQ4y8DZZ8fpJnuqs9my8iSQVbJO\/oU1AXUROYU=",
  "redownload": true,
  "source-app-id": 1234567891,
  "fidelity-type": 1,
  "did-win": true,
  "coarse-conversion-value": "high",
  "postback-sequence-index": 0,
  "skan_ip": "136.25.2.194",
  "skan_timestamp": 1601555400,
  "adn_campaign_id": "102",
  "adn_campaign_name": "My Campaign"
}

{
  "version": "3.0",
  "ad-network-id": "com.example",
  "campaign-id": 42,
  "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
  "app-id": 525463029,
  "attribution-signature":
    "MDYCGQCsQ4y8DZZ8fpJnuqs9my8iSQVbJO\/oU1AXUROYU=",
  "redownload": true,
  "source-app-id": 1234567891,
  "fidelity-type": 1,
  "conversion-value": 20,
  "did-win": true,
  "skan_ip": "136.25.2.194",
  "skan_timestamp": 1601555400,
  "adn_campaign_id": "102",
  "adn_campaign_name": "My Campaign"
} 

Apple's introduction of App Tracking Transparency limits the use of traditional user-level mobile measurement. Starting with iOS 14.5, the iOS Advertising Identifier (IDFA) is available only for end-users who consent to share their data (opt-in).

The alternative offered by Apple is SKAdNetwork, a privacy-centric framework for aggregate campaign measurement, which was originally introduced with iOS 11.3 but has been updated significantly for iOS 14. Ad network partners who are registered with SKAdNetwork can receive automatic "SKAdNetwork postbacks" when there is an app install, whether the end-user opted in to sharing their data or not.

Singular's SKAdNetwork solution, SKAN, gathers the data that advertisers need using an information exchange between the end-user's device, the ad network, and Singular (as the MMP).

• The SKAdNetwork postback is sent from the device to the ad network + to the MMP.
• The conversion value and its meaning are sent from the MMP to the ad network.
• The campaign ID and its meaning are sent from the ad network to the MMP.

Data flow diagram for Singular's Secure SKAN

Prerequisites:

• Ensure your ad network is already integrated with Singular attribution.
• Register for SKAdNetwork and have an "ad network ID" issued by Apple.

1. Gather requirements: Review What is a Singular SKAdNetwork Integration? to understand the integration details and options available.
2. Fill out the integration form for Singular's SKAdNetwork solution.
3. Receive our integration team's reply: The Singular integration team will review your form and let you know if we have any questions or if we have all the information we need.

4. Test the Integration: After Singular finishes creating the integration, we will contact you to let you know how you can test the integration on your end.

Once you've completed the SKAdNetwork integration with Singular and have received confirmation that your skadnetwork ID is configured, you can test the integration by simply forwarding a SKAN postback for either a live app or a sample app.

In case you are already working with a live app by a Singular customer and have shared access to their account, you can simply send a test postback for their app and check Singular's Export Logs or SKAN Reports to confirm it's been received.

If you don't have a live app yet and would like to test a sample app, you can send a simulated postback for Singular's Device Assist app located here:

https://apps.apple.com/us/app/singular-device-assist/id1441750662

Our support can validate if the postback has been processed successfully. To receive that confirmation, open a support ticket with the postback details and when it was sent.

Note: if you've forwarded a simulated SKAN postback (not a genuine one received from Apple), make sure to toggle "SKAN Validation Status" to "Show Both" in the report:

Singular automatically processes SKAdNetwork postbacks as they are received. If postbacks are delayed, we recommend running reports using the Estimated install date date type instead of Postback date.

This section documents the API endpoint and parameters that Singular supports for inbound SKAdNetwork postbacks to Singular (device → Singular, Ad Network → Singular).

Endpoint: https://skadnetwork.singular.net/api/v1/skan_postback
Method: POST
Parameters:
*indicates a required value

Use conversion_info to retrieve Singular’s record of conversion model information about a specific advertiser's SKAdNetwork conversion value.