Web Onboarding Guide

Follow
Avatar
Vaibhav Gupta
Updated

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

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.

1

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. If your corresponding Mobile App is already added, select that Mobile App. If not, click Add New App and name your app.
  3. Under New Site, select Web.
  4. Under "Add an app using", select Store URL and provide your website URL.
  5. Set your bundle ID and click Save. You will use this Bundle ID (AKA Product ID) in the SDK initialization.

web_bundleid.png

Tip: Bundle Id is a name for your website. We recommend using reverse DNS notation, e.g., “com.example.site”. This will be used to identify your website throughout the Singular platform.
2

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:

Notes:

  • The SDK initialization code should be called on every webpage and every time it is loaded.
  • It is not advised to load the Singular SDK following sign-in or any other activity because we will lose track of some of the users' data.
  • You can track post-install user activity by adding events like sign-in, start trial, buy, and subscription on the Website.
  • We recommend adding custom_user_id as part of the implementation, which will help you analyze data at the user-level.
  • Custom events can only track counts, whereas revenue events can track both count & revenue sum.

Checking your Web SDK Integration

You can quickly verify your web SDK integration using Chrome's Developer Tools.

  1. Open your website integrated with the web SDK.
  2. Open the Developer Tools by typing Ctrl+Shift+I (Windows) or Cmd+Option+I (Mac).
  3. 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.
  4. You can also see the SDID, which can be used to test the Web SDK integration in Developer Tools > Testing Console.

check_integration.png
3

Testing the Web SDK Integration

To test the Web SDK integration:

  1. Go to Developer Tools > Testing Console.
  2. Click Add Device.
  3. Select the platform "Web" and select the keyspace Singular Device ID.
  4. Input the SDID you retrieved in the previous step and click Add.
  5. Once the SDID is added, you can reload the webpage and trigger events. The “__PAGE_VISIT__” and other events (if triggered) will be shown in the Testing Console.

testing_sdk.png

Note: The Testing Console only records data while active. It will not display any events that are triggered while it is offline.

You can also verify testing results through Attribution > Export Logs. The export logs let you manually download user-level data such as Conversions (installs), Events, etc.
4

Implementing 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.

To implement this, you'll require a web-to-app base link, which is generated by your Singular Solutions Engineer. Once created and shared, you can go to Attribution > Manage Links and make changes as required.

For your Singular Solutions Engineer to make the link, you need to ensure that Android and iOS deep link schemes are added. You can update them under the App settings. Go to Settings > Apps, select your app, select the platform, and then click Show Advanced Settings.

Deep links provide a better user experience, as you can route your existing customer to your app. If you choose not to use deep links, let your Singular Solutions Engineer know.

webtoapp_implemenetation.png

Important: All the "Download App" buttons on the website must be tagged with the web-to-app tracking link provided by your Singular Solutions Engineer for this feature to work.

For implementation information, see Website-to-App Attribution Forwarding for Mobile Web.
5

Tracking web campaigns

While running Web campaigns, destination URLs should include tracking parameters. If you already use UTM parameters, you can continue using them. If not, you can use our “Create Web Link” feature to create destination URLs with tracking parameters.

When creating website links using Singular, keep your UTM parameter naming conventions intact so that existing reports do not change. If you don't use UTM parameters, you can leave them blank and click on Generate Link.

In the generated Tracking link, Singular adds its own set of parameters, recognized by the “wp” prefix, which we then use for tracking campaigns from Networks. The values of the “wp” parameter include network macros, which are replaced by the network while serving ads.

Note:

  • The “wp” parameters precede UTM parameters for attribution when both exist.
  • If you do not use the Singular “wp” Web Tracking parameters, Singular can not guarantee accurate matching of Web Attribution and Revenue data to Web Campaign Spending from your Ad Networks.
  • You don’t have to generate web tracking links every time you run a campaign. Generate them once per Network and use them for all your campaigns.
Create Web Links

To create web links:

  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.

createWebLinks.png

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

Facebook

To set up Facebook:

  1. After entering your information at the Campaign and Ad set levels, navigate to the Ad level to set your URL parameters.
  2. At the Ad level, click Build a URL parameter under Website URL.
  3. In the tracking link generation screen in Singular, copy the URL generated by the tracking link tool and add it to the website URL.
  4. See this Facebook document for more help.

web_fb_link.png

Google Adwords

To set up Adwords:

  1. If you're not using Google Analytics, then a tracking template needs to be set up similarly to other partners.
  2. To do so, in the tracking link generation screen, copy the URL parameters generated by the tracking link tool, without the base domain.
  3. When configuring an ad on Adwords, navigate to the "URL Options" section and paste the URL parameters in the "Final URL suffix" field.
    Note: This can be done in Account, Campaign, Adgroup, or Ad level as desired.
  4. See this Google document for more help.

web_adwords_link.png
6

Set up events in Singular

While integrating the SDK, you defined events you want to track. To see these events in your aggregated reports, you need to map them in Settings > Events. Note that your reports will only show events that happened after you mapped them.
7

Run a campaign report

After your integration is done and your events are mapped, wait for data to start flowing in. See 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. Be sure to choose the Platform dimension to differentiate between web and app data.

web_report.png