Web Onboarding Guide

Welcome to Singular's Web Onboarding Guide. Note that the process described here differs from that for Mobile App Attribution customers.

Web-only Onboarding Guide

Singular performs attribution for websites using an SDK that uses a Javascript tag. When the tag is implemented in your website, Singular can determine if a certain user, identified by their browser, is visiting your website for the first time or returning to the website following a web campaign.


Add your website as an "app" in Singular

To start using Singular reports, you must add your website to the Apps page in Singular.

  1. Go to Singular > Settings > Apps.
  2. Click Add New App.
  3. Name your app and under New Site, select Web.
  4. Select Add an app using URL and provide your website URL.
  5. Set your bundle ID and click Save. You will use this Bundle ID in the SDK initialization.

Integrate the SDK into your website

The Singular Website SDK allows you to attribute your user activity to marketing touchpoints and to track user events within your website.

Follow the instructions to integrate the SDK:


  • The SDK initialization code should be called on every webpage and every time it is loaded.
  • Both guides include a section on tracking revenue and events. Ensure you set up any custom events you'd like to track.
  • We recommend adding custom_user_id as part of the implementation.

Checking your Web SDK Integration

You can quickly verify your web SDK integration using Chrome's Developer Tools. Open them with Ctrl+Shift+I (Windows) or Cmd+Option+I (Mac).

In the Network tab of the Developer Tools, type "Singular" in the filter box. If the Web SDK is implemented correctly, you'll see the "__PAGE_VISIT__" event.



Add your data connectors to get network data

Note: If you're an existing customer, you may have already added the necessary data connectors.

Data connectors are the integrations through which Singular pulls 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.

Set up a data connector for each of your network partners:

  1. Go to Settings > Data Connectors.
  2. Click New Data Connector and in the search box that appears, find your network partner.
  3. In the panel that opens, provide the details required (usually an API key and a username). The panel will guide you on where to find the relevant details in your partner dashboard.
  4. For Facebook and Google Ads (Adwords), you may need to log in using a Facebook/Google account with relevant access.

Creating Web-to-App Links

By implementing web-to-app links on your website, you can track app installs back to the Web Ad source from where the user has arrived. For implementation information, see Website-to-App Attribution Forwarding for Mobile Web.

Note that all the "Download App" buttons on the website need to be tagged with Singular links only for this feature to work.


Create your tracking links

Tracking links let Singular know when a user clicks on one of your ads. Links can include additional UTM parameters which can be leveraged in your reporting.

  1. Go to Attribution > Create Web Link.
  2. Under Target (App), choose the app you're advertising. The Domain field is auto-filled.
  3. Modify Domain and Landing Page (optional) to create your links to your liking.
  4. Select an ad partner or common source name under the Partner dropdown.
  5. If you selected an ad partner, a "how-to" link appears under the Partner field. Click it to learn about any partner-specific instructions and best practices.
  6. Once the partner is selected, the Attributes section appears. Enter your UTM parameters, if any.
  7. Click Generate Link and copy your new tracking link.

» For more details on advanced setup, see the Singular Links FAQ or Creating Website Links.


Set up events in Singular

While integrating the SDK, you defined events you want to track. User-level data, including each instance of these events, can be found in Attribution > Export Logs.

To aggregate these events and create meaningful KPIs, you need to define your Cohort events within Singular. Doing so shows aggregated event data in your campaign reports. Set them in Settings > Events. You can then see aggregated reports in the Analytics section.


Run a campaign report

After your integration is set up, wait for data to start flowing in. You may be interested in Data Freshness Rates and Update Times.

To see your aggregated data, go to Analytics > Reports. Choose the Dimensions and Metrics you want to see in your report and click Run.


(Optional) Set up a Data Destination to export your data

Singular can feed data directly into your data warehouse, storage service, or BI platform, where you can use your own BI and visualization tools to process and analyze the data. See Supported Platforms.

Data Destinations are an Enterprise feature. If Data Destinations are enabled for your account:

  1. Set up a destination for your service of choice. Step-by-step instructions for each service are available in our Data Destinations section.
  2. Log into your Singular account and go to Settings > Data Destinations.
  3. 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.

» See Singular Data Destinations (ETL) FAQ and Troubleshooting for more help.

Cross-Device Onboarding Guide

Note: This is an enterprise feature. Contact your Singular representative to see if it has been enabled for your account.

To set up cross-device attribution, ensure you pass your Singular custom_user_id to every platform you want to set up. Once you've done this, contact your Singular representative to take care of the rest.