|Prerequisites||You've signed up for Singular and have access to the Singular app.|
|For||Advertisers who use mobile app advertising.
If you exclusively use web, see Web Onboarding Guide instead.
Start by watching this video:
Plan Your Setup
This guide has seven sections:
- Plan Your Setup: What is Singular and what can it do for you?
- Set up Singular: The minimum integration requirements to start. This section is mandatory.
- Start with SKAdNetwork: Set up a solution for Apple's SKAdNetwork. Skip if you do not target iOS 14+.
- Create Tracking Links: Integrate with other ad partners, track self-managed channels, and use deep linking. Skip if you only use Facebook Ads / Google Adwords / Apple Search Ads.
- Run Reports: Get Singular's powerful reports and insights.
- Export your Data: Set up automatic notifications and data exports from Singular to your Business Intelligence platforms. Skip if you exclusively use the Singular Dashboard.
- Set up other Singular features: Advanced features from Singular, such as ad monetization, banners, and fraud prevention.
What Singular does:
- Automatically pulls marketing performance data from all your ad networks, agencies, and other sources into one database,
- Combines this data with attribution stats pulled from Singular's native attribution solution or a third-party attribution tracker,
- Presents the combined data in dashboards and reports that provide customized performance and ROI insights.
The data is presented with a high level of granularity, with breakdowns by app, campaign, targeted country, OS, publisher app, creative, and more.
To pull data from all the sources described above, Singular is integrated with over 1000 companies, including ad networks, agencies, self-attributing networks, BI services, and more.
Browse the full list of partners.
What is attribution?
Mobile app attribution is the process of connecting the install of a mobile app and the user's activities inside the app to the marketing campaign that led to the installation.
Singular makes these connections by matching an ad view or ad click that happens on a mobile device to the install (or, more precisely, the first session) of a mobile app on that same device.
Attribution may also be done by self-attributing networks such as Facebook, Snapchat, Twitter, Google, and Apple's SKAdNetwork.
Events are user activities within your app post-install. Define and track events to understand your business activities and user flow. Examples: "Add to Cart", "In-app Purchase", and "Reached Level 4".
You'll need to define events in two places:
- In your app, while integrating the Singular SDK
- In the Singular dashboard
There are three types of events that Singular helps you track:
- Cohort Events: Events defined by you and tracked by the Singular SDK. These events are "cohorted", i.e., measured based on the install date.
- Conversion Events: Events received from your ad networks.
- SKAN Events: SKAN events are automatically created based on the conversion model you create. These events cannot be edited.
Singular also allows you to specify options for events such as "unique", "first" and "actual". See Ways of Measuring Events in the resources below.
Set up Singular
Add your app in Singular
If your app is available on another platform, click the Add Site button and repeat steps 4-5.
Important: Do not add iOS and Android as separate apps. Create two app sites within the same app.
Integrate the SDK/S2S
Singular has SDK versions for iOS, Android, Unity, Flutter, and React, as well as for websites, kids' apps, and a server-to-server integration option.
Use the developers' documentation at Getting Started with the Singular SDK/S2S to get:
To test your integration, you will run your app on a test device and trigger user events. Use the Testing Console in the Singular platform to ensure the SDK is reporting events to Singular servers properly.
You can run an automatic SDK audit report or manually test your apps. See How to Test Your Singular SDK Integration.
During your SDK setup, you should define the business events you want to track.
Set up attribution integrations to push data to partners
Adding your partners to Singular is a two-step process. In this step, you'll configure attribution settings for your partner networks, e.g., add app credentials, decide on attribution windows, and choose post-conversion events to push to the network.
Singular then shares attribution data through these attribution integrations. This is done on the Attribution > Partner Configuration page.
To set up Facebook:
To set up Adwords:
Apple Search Ads
To set up Apple Search Ads:
To set up a partner attribution integration:
Set up data connectors to pull data from partners
Adding your partners to Singular is a two-step process. In this step, you'll set up data connectors that pull cost and other campaign data from your networks. Once you set up your data connectors, you'll be able to start running reports containing cost, creatives, clicks, etc.
If you set up Facebook and Google Adwords in Partner Configuration above, adding their data connectors will complete their setup.
Set up a data connector for each of your network partners:
Start with SKAdNetwork
SKAdNetwork (SKAN) is Apple's attribution solution for iOS that aims to preserve its users' privacy. Data that can be used to uniquely identify a device or user is never available through SKAN.
SKAN introduced conversation values, a 6-bit value, to track post-install events and measure how valuable a user is. See Introduction to Singular's SKAdNetwork Solution.
Our SDK integration guides already address how to set up SKAN. However, you may want to see if our SKAdNetwork Integrated Partners have special limitations.
Probabilistic Attribution is Disabled
In probabilistic attribution, Singular's tracking URL is used to collect basic information about the device, such as IP address and model. However, starting with iOS 14.5, Apple prohibits probabilistic attribution methods for privacy concerns.
To protect advertisers and partners, Singular has disabled probabilistic matching by default for iOS 14 and above. As a technology provider, Singular is committed to helping our advertisers and partners comply with Apple policies. See SKAdNetwork Partners FAQ.
The conversion value, being a 6-bit value, is simply a number between 0 and 63. By itself, the number is meaningless. We assign meaning to the number by creating a conversion model.
A conversion model is a way to encode as much information as possible about the user and their post-install activity into the limited space of the conversion value. For a more detailed explanation, see Understanding Singular's Conversion Value Management.
If you've already understood and planned a model, you can configure it in the Singular app. To configure a new conversion model:
- In your Singular account, go to SKAdNetwork > Model Configuration.
- Select an app from the list on the left.
- Click Add Conversion Model.
- Select the Measurement Period. [?]
- Select the model type. [?]
- Enter a name for the model and configure the additional settings. These settings depend on the model type you selected.
- Expand the Analyze Model section to see a simulated report of how the model with the current configured settings would perform with your data. [?]
- Click Save. The new conversion model is added to the list.
- To start using the model, toggle it on.
See the SKAdNetwork Model Configuration FAQ.
Once you've set up SKAdNetwork in your app, configured a conversion model, and allowed some time for data to start coming in, you can start to analyze your results. Singular offers two reports for SKAdNetwork:
- SKAdNetwork Raw Data: Analyze the raw SKAdNetwork install data as received in SKAdNetwork postbacks before it's decoded. Go to SKAdNetwork > Raw Data. See SKAdNetwork Raw Data FAQ.
- SKAdNetwork Reports: See SKAdNetwork data combined with ad network cost and impressions stats and CPI calculation. Go to SKAdNetwork > Reports. See SKAdNetwork Reports FAQ and Troubleshooting.
- It takes Apple 24-72 hours to send SKAdNetwork data for Singular to show.
- Apple Search Ads does not use SKAdNetwork. The data for ASA campaigns is available in your regular reports (Analytics > Reports), even for iOS 14.5+ devices.
- Twitter and Google share SKAdNetwork data with Singular through special APIs, not by forwarding the actual postback. Therefore, you can't download postback-level SKAdNetwork data for these networks in Export Logs.
- The SKAdNetwork framework doesn't support web-to-app installs or installs based on probabilistic attribution (such as cross-promo).
Create Tracking Links
Tracking links let Singular know when a user clicks on one of your ads (or views an ad if it's an impression-based campaign). Links can include additional parameters - such as the user's device platform or the ad creative asset - which can be leveraged in your reporting.
- Go to Attribution > Manage Links.
- Click on Manage Link Domains and create a new subdomain for yourself. Use something simple that represents your brand well, e.g., "gamesco.sng.link" where GamesCo is the name of your company. You can reuse the subdomains you've created.
- From the management screen, click on the app for which you want to create a tracking link and click Create Link.
- Under Link Type, select "Partner".
- Choose your network partner under Source Name and give your link a name under Tracking Link Name.
- In the Link Settings and Redirects section, select your subdomain under Link Sub-Domain.
- If your network partner supports Android and iOS tracking, you can enable them. Choose the appropriate site for your app and provide a link to where you want to direct your viewer (usually the store URL).
- Under For other platforms, go to, provide a backup destination URL, and create your tracking link by clicking the Generate button.
See Singular Links FAQ.
Singular allows you to track user activity in your custom sources, such as email and text message campaigns, as well as cross-promotional or influencer marketing campaigns.
- Use the same steps as above by going to Attribution > Manage Links > Create Link.
- Under Link Type, instead of "Partner" select "Custom Source".
- Under Source Name, choose from "Crosspromo", "Email", "SMS", "Social", or "Custom". The value you choose here will be reflected in your reports under the Source dimension.
If you want to direct existing users to specific parts of your app, you can configure a tracking link to be a deep link. This is what you use for re-engagement and retargeting campaigns.
With a deep link, if a user clicks the ad and they already have your app installed, not only will the app open - but it will show the app content of your choice, not the app's default screen.
Once your campaigns are up, you can start running reports in Singular to analyze your ROI and measure campaign KPIs.
- In the Singular app, go to Analytics > Reports.
- At the top of the reports tab, use the date picker to select your desired date range.
- Under Dimensions, select the values you want to see in your report. For example, select "App", "Source", and "OS".
- Under Metrics, select the metrics you want to see in your report. For example, select "Impressions", "Clicks", "Installs", and "Cost".
- Under Cohort Metrics, select the metrics you want to see. For example, select "Revenue" and "ROI".
- Select other values and filters to refine your report. For example, select "7d" under Cohort Periods, and "All Time" under Time Breakdown.
- Click the Run Report button to generate your report.
You can also try these sample reports:
If your ad network supports creative data, you can set up Singular to report on the performance of individual creative assets and their performance. You can also set up custom dimensions to run aggregated reports. This will help you understand and optimize your campaigns.
For a full guide, see How to Set Up and Run Creative Reports.
User-level data is useful for many reasons, such as cross-checking the data in aggregated reports in case there is a discrepancy or sharing fraud-related data with your partner networks.
You can export user-level logs up to the beginning of last month . We recommend keeping the date range as narrow as possible to avoid exceeding the record limit per download.
- Go to Attribution > Export Logs.
- Choose the relevant date range.
- Select the app, the app site, and the type of log you want to export (clicks, installs, events, or postbacks).
Drag the fields you want into the Selected Fields box.
- Optionally, you can filter the log by Attributed Partners, Countries, Device ID, and Device Type. For event logs, you can also filter by specific events, and for conversion logs, you can filter by conversion type. We recommend filtering the log as much as possible to avoid exceeding the record limit.
- Click the Export Log button.
To define events:
- Go to Settings > Events.
- Choose either the Cohort Events or Conversion Events tab, as appropriate. You may not see both options.
- If you plan to use your event across multiple apps, select Global Events. Otherwise, select App Specific Events and choose your app from the dropdown.
- Click the New Event button.
- Give your event an indicative name and choose what event it maps to in your advertising platform.
- To add the cost-per-event calculation to your reports, select the Cost Per Event (CPE) checkbox.
- To add a metric for installs-to-event ratio, select the Event Conversion Rate (ECVR) checkbox.
- Click Save.
-  While you can define any number of events in the SDK, you can only create 12 events in the Singular Dashboard for aggregation.
-  You may have defined "count" events (total events) or "sum" events (dollar value). If you want to aggregate both, you need to create separate conversion events.
-  If you don't see your event in the dropdown, that means Singular isn't receiving it in the SDK.
When you visit the Dashboards page, you will see a pre-configured basic dashboard for your data. You can customize this dashboard or create a new one:
- Go to Dashboards.
(Optional) Create a new dashboard by clicking the New Dashboard button.
- Create new widgets to suit your needs.
Your dashboard will be updated automatically as new data becomes available.
See Dashboard FAQ.
Export your Data
If Data Destinations are enabled for your account:
- Set up a destination for your service of choice. Step-by-step instructions for each service are available in our Data Destinations section.
- Log into your Singular account and go to Settings > Data Destinations.
- Click Add a New Destination to display a list of the supported destinations for your account.
The destinations marked "User-Level" are used to export user-level data. The others are used to export aggregated data. Ensure Singular IP addresses are whitelisted.
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.
- Log into your Singular account, go to Attribution > Partner Configuration, and select the Internal BI partner.
- In the configuration window, provide a postback URL (e.g., https://my_company_name.com/bi/event_endpoint?app=12). This is where Singular will send the postback through a POST request.
- Configure the other postback settings the same way you would a partner postback (see How to Configure an Attribution Partner).
Set up Other Singular Features
Singular's Fraud Prevention Engine protects your marketing efforts 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.
If you have it enabled for your account:
- If you've already added apps for campaign performance reports, you do not need to modify anything. However, if you're monetizing different apps than the ones you're marketing, add those apps in Settings > Apps.
- Go to Settings > Data Connectors and add an ad monetization data connector for each ad network through which you monetize apps. These data connectors have "(Ad Monetization)" in the name.
- Allow 24 hours for Singular to pull data. See your Ad monetization reports in Analytics > Ad Monetization.
Singular Banners allow your brand to quickly and easily design, deploy, and maintain brand-relevant banners on your mobile website.
These banner experiences include call-to-actions, which, when engaged with, give mobile-web users a seamless experience with the most relevant mobile app content.
See Singular Banners.