How to Get Started with SKAdNetwork


This guide will give you a general overview of the steps to set up SKAdNetwork with Singular. Inside you will find links to more specific guides and FAQ articles.

Note: This guide is for users of Singular's attribution tracker. If you're using AppsFlyer as your tracker, see Getting Started with SKAdNetwork (For AppsFlyer Users) instead.

Guide for Project Managers
  • Singular's attribution tracker is configured.
  • Data connectors are configured for all the partner networks from which you want to get SKAdNetwork data.


If you're new to SKAdNetwork or SKAN, we recommend reading these guides first:

Step by Step


Integrate SKAN Support in Your App

The development team has to update the Singular SDK/S2S integration in your app to support SKAN (Singular's secure SKAdNetwork solution).

To add SKAN support:

  1. Upgrade your SDK to the latest version to take advantage of the latest improvements to SKAN support. Find the latest versions: iOS SDK, Unity SDK, React Native SDK, Unreal Engine SDK.

  2. Add code to have the app enable SKAdNetwork before initializing Singular. For details, see the appropriate guide for the SDK or S2S integration you are using:

    iOS SDK: Adding SKAdNetwork Support
    Unity SDK: Adding SKAdNetwork Support 
    React Native SDK: Adding SKAdNetwork Support
    Unreal Engine SDK: Adding SKAdNetwork Support 
    SKAdNetwork S2S Implementation Guide

Note: By default, the SDK will use SKAN managed mode, in which the app updates the conversion value automatically based on the conversion model you configure in the back end in Singular.

The manual mode (in which you update the conversion value yourself based on your own logic) is provided for customers who don't want to use Singular's conversion models.


Configure a Conversion Model for Your App

When tracking installs and user activity through SKAdNetwork, we rely on the conversion value - a single number in the range of 0 to 63 that is sent from the app to the ad network some time after the app is installed.

A conversion model is a way to encode as much information as possible about the install and post-install activity into the limited space of the conversion value. For more information, see SKAdNetwork Model Configuration: General Concepts and Planning.

To configure a conversion model:

  1. Go to SKAdNetwork > Model Configuration, choose the app from the list, and click Add Conversion Model.Screen_Shot_2021-02-11_at_18.47.40.png
  2. Choose the Model Type. There are different types of conversion models, each emphasizing a specific type of information, such as engagement or revenue, and leaving out other data. For full details on all the models, see Types of Conversion Models.

  3. Configure the model as explained in SKAdNetwork Model Configuration FAQ: Configuring a new Model. The properties you configure depend on the type of the model you've chosen.


    • For a Conversion Events or Engagement model, you have to define a group of events that you want to measure. These events have to be defined in your SDK integration.
    • For a Funnel model, you have to define a list of events in the order in which they occur. For example, in a game app, the events may be "Reaching Level 2", "Reaching Level 5", and "Reaching Level 10".
  4. After saving the model, remember to activate it in the Model Configuration page and then click Submit.

Your model is now active and will be used with all partner networks in which you run SKAdNetwork-enabled campaigns for this app. For the majority of our SKAdNetwork partners, no further configuration is needed. For the few partners that do require special setup, see the next step.


Configure Facebook and Other Special Partners

A few partner networks do require additional configuration to work with Singular's SKAdNetwork solution. 

If you plan to run SKAdNetwork campaigns with these partners, see the instructions in our integration guides:

Facebook Ads SKAdNetwork Integration: Setup Instructions
Snapchat Ads SKAdNetwork Integration: Setup Instructions
TikTok for Business SKAdNetwork Integration: Setup Instructions
Google Ads SKAdNetwork Integration: Setup Instructions

Enable SKAdNetwork on the Partner's Side for Relevant Partners

Singular has SKAdNetwork integrations with many major ad networks, and new integrations are added regularly. For an up-to-date list, see Singular SKAdNetwork Integrated Partners.

Before Singular can get SKAdNetwork data from a partner, you usually need to go into the partner dashboard and activate postback forwarding to Singular (or contact your partner account manager). For example, see the integration setup instructions for Snapchat Ads and Twitter Ads.


Start Running SKAdNetwork-Enabled Campaigns for Your App


Use Singular's SKAdNetwork Reporting to Analyze Your Data

Once you've activated a conversion model, Singular starts pulling SKAdNetwork data from all your partner networks.

Due to the limitations of SKAdNetwork, it takes about 2 days after the start of the campaign to start seeing data.

Singular offers two SKAdNetwork-specific reports:

  • SKAdNetwork Raw Data: Analyze the raw SKAdNetwork install data as received in SKAdNetwork postbacks. Break down the installs by SKAN Campaign ID, SKAN Publisher ID, and conversion value.
  • SKAdNetwork Reports: This is your main analytics tool for SKAdNetwork. It lets you see SKAdNetwork data with the conversion value decoded into events, revenue, etc. Where possible, the SKAdNetwork data is joined to ad network data such as cost, allowing you to see your CPI and ROI.

Learn more in the SKAdNetwork raw Data and Reports FAQ.

These reports are also available via API.


[Optional] Set Up Data Destinations to Export SKAdNetwork Data

You can use Singular Data Destinations (ETL) to export SKAdNetwork reporting data from Singular automatically. SKAdNetwork data is available in several schemas: