Skip to main content

Installation: Install the Sona SDK manually

Updated this week

This guide walks you through manually installing the Sona SDK on your website to enable account identification and multi-touch attribution tracking. For the Sona SDK, we recommend direct installation on the website as it bypasses ad blockers and ensures more reliable data collection.With this guide, you'll be ready to confidently implement tracking and start de-anonymizing your website traffic.

When to Use This / Prerequisites

  • You want to ensure maximum tracking reliability while bypassing ad blockers

  • You have direct access to your website's code

Prerequisites:

  • Access to your Sona account

  • Ability to edit and publish your website's HTML code (specifically the <head> section)

  • Someone on your team who can implement code changes on your website

Step-by-Step Instructions

Step 1: Access Your Tracking Code

  1. Log in to your Sona account Navigate to your Sona dashboard using your account credentials.

  2. Find the Tracking Pixel settings Click on Settings > General > Tracking Pixel in the left navigation bar.

  3. Configure CNAME (optional but recommended)

    Set up a CNAME to improve tracking effectiveness. This loads the script from your own website domain instead of a Sona domain, further enhancing reliability.

Step 2: Choose Your Tracking Configuration

  1. Select your form capture preference On the Tracking Setup page, you'll see two options:

    • With Form Capture: Choose this if you want Sona to automatically gather form data and send it to your destination

    • Without Form Capture: Select this for basic tracking without form data collection

Step 3: Implement the Code

  1. Copy your SDK code Once you've made your selections, copy the provided SDK code from the Tracking Setup page.

  2. Share with your development team Provide the SDK code to the person or team responsible for website updates.

  3. Place the code in your website's head section The SDK code MUST be placed between the <head> and </head> tags on every page you wish to track.

You're almost there! Once the SDK is successfully implemented, Sona will automatically begin tracking events and visitor data.

Key Concepts / Best Practices

  • Why manual installation matters: The Sona SDK is extremely lightweight (only 2 KBs) and designed for optimal performance. Manual installation ensures ad blockers won't interfere with your tracking, giving you the most complete and accurate data possible.

  • CNAME configuration benefits: Setting up a CNAME makes the tracking script load from your own domain, which improves both performance and tracking accuracy while reducing the likelihood of being blocked.

  • Universal implementation: Remember that the SDK must be installed on every page where you want to track visitor behavior. Missing pages will create gaps in your customer journey data.

Did this answer your question?