New to Singular's attribution service? Read this guide for an overview of everything you have to do to get up and running.
|Prerequisites||Singular's attribution service has been enabled for your organization.|
Note: If this is your first time using an attribution provider (tracker), or you want to be clear on Singular's offering and definitions, we recommend reviewing the Mobile App Attribution guide, particularly the section about Singular's attribution process.
Plan your SDK integration:
The first step in setting up Singular attribution is integrating the Singular SDK into all of your apps. But before you or your development team starts tackling the integration, take a minute to think about what user actions and events you want Singular to measure.
Simply put, the SDK's job is to notify the Singular servers when any of the following occur in your app, so that Singular can track and measure it:
While sessions and purchases are relevant to all apps, the choice of other in-app events you want to measure depends on your market segment and KPIs. You may want to measure how many users registered to your platform, completed a tutorial, or leveled up in your game app - any data that can help your marketing team optimize campaigns based on user quality.For more details and examples, see Defining In-App Events.
[DEVELOPERS] Integrate the SDK/S2S:
Singular has SDK versions for iOS, Android, Unity, and React, as well as for websites, and a server-to-server integration option. The developers' documentation at Getting Started with the Singular SDK/S2S to point you to:
[DEVELOPERS] Test your SDK/S2S integration:
For some customers and implementations, it's easier to test the SDK integration after every step of development (i.e., implement sessions and test them, then revenue events and test them). Other customers prefer to test the integration after it's done.Regardless, to test your integration, you will be running your app on a test device and triggering sessions, purchases, and other user events. You will use Singular's SDK Console (a testing tool available inside the Singular web app) to make sure the SDK is reporting events to the Singular servers properly. For full instructions, see our SDK integration testing guides.
Configure your app settings in Singular:
After you integrate the Singular SDK and send events to Singular, your app should be added automatically to the Apps page in the Singular web app. This is where Singular keeps an up-to-date list of all your apps and their configuration.
Before you start running marketing campaigns for your app, go to the Apps page (Settings > Apps), find your app site, and configure the Store URL and other optional settings, such as alternative tracking link destinations and deep links. For a detailed guide, see Setting Up Your App for Attribution Tracking.
See the App Configuration FAQ for more information.
Configure Google Ads as a partner (if relevant):
Singular can track how many times your app is installed as a result of advertising in Google Ads (that includes Adwords UAC campaigns and YouTube campaigns).
To set up Google Ads as a partner:
For more details, see our Google Ads guide.
Note: Google Ads is a “Self-Attributing Network” (SAN), meaning you don’t need to create Singular tracking links and embed them in your ads. For more information about how Singular works with SANs, see Singular's Attribution Methods.
Configure Facebook as a partner (if relevant):
Singular can track how many times your app is installed as a result of advertising in Facebook and Instagram.
To set up Facebook as a partner:
For more details, see our guide to setting up Facebook.
Note: Facebook is a “Self-Attributing Network” (SAN), meaning you don’t need to create Singular tracking links and embed them in your ads. For more information about how Singular works with SANs, see Singular's Attribution Methods.
Configure other networks as partners:
Start tracking installs with the rest of your advertising networks by configuring attribution settings for each network.
To configure a network as a partner:
Depending on the partner, settings may include:
For more details, see the Partner Configuration guide.
Configure Internal Postbacks (optional):When you configured your partners, you configured what postbacks (automatic notifications) you want Singular to send to them about attribution decisions and other events. But you can also have Singular send automatic postbacks to your own internal BI system, for tracking purposes. For details, see Configuring Internal BI Postbacks.
Create tracking links (Singular Links):
For networks that aren't "self-attributing networks" (SANs), you need to create a tracking link to run a marketing campaign.
Tracking links are the URLs that are triggered when the user clicks an ad (or views it, if it's an impression-based campaign). They lead the user to the app store, but they also let Singular know that the user interacted with the ad. If the user then downloads and installs the app, Singular uses the information in order to attribute the install to the correct ad network (a similar process happens with re-engagement attribution).
Tip: Tracking links can include additional parameters, such as the user’s device platform or the ad creative asset. You insert placeholders for these parameters when you create the tracking link, and the ad network fills them in automatically when the ad is clicked or viewed. This information is received by Singular and used to enrich your reporting with additional breakdowns and segmentations.
To create tracking links, go to Attribution > Manage Links. For help, see the Singular Links FAQ.
Test your tracking links (Optional):After you create a tracking link, you can test it to see how it helps Singular reach an attribution decision. For details, see How to Test a Tracking Link.
Configure Fraud Prevention Settings:
Singular’s Fraud Prevention Engine protects your marketing efforts using a mixture of out-of-the-box detection methods and custom user-defined rules to prevent attribution fraud. The Engine evaluates installs before finalizing the attribution or reporting it to the partner, thus preventing excessive billing for CPI/CPA campaigns.
For an introduction to Singular's fraud prevention mechanism, see Singular Fraud Prevention. To configure your fraud prevention settings, see Configuring Fraud Settings and Configuring User-Defined Fraud Rules.
Run campaign performance reports:
Once your campaigns are up and running, you can start running reports in Singular to analyze your ROI and measure campaign KPIs. Try these sample reports to get a taste:
For more details, see the Reports FAQ.
You can also run creative reports to see your actual creative assets, including images and videos, next to their performance metrics. Try these sample reports:
Learn more in the Creative Reports FAQ.