Welcome to Singular's Web Onboarding Guide. Note that the process described here differs from that for Mobile App Attribution.
Add your website as an "app" in Singular
To start using Singular reports, you must add your website to the Apps page in Singular.
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.
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:
Checking your Web SDK Integration
You can quickly verify your web SDK integration using Chrome's Developer Tools.
Testing the Web SDK Integration
To test the Web SDK integration:
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.
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.
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.
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.
Create Web Links
To create web links:
» For more details on advanced setup, see the Singular Links FAQ or Creating Website Links.
To set up Facebook:
To set up Adwords:
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.
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.