Add Tracking URL Parameters Used To Create First-Party Cookies

When you enable the Tracking URL Parameters feature, two additional URL parameters are added to URLs used in emails you send via Bronto.

About this task

Note: If you use Order Service, do not set this feature up on the Data Exchange page. Instead, see this help topic for information on how to set these parameters on the Commerce page.
These parameters allow the application to create first party cookies. The following URL parameters are added:
  • _bta_tid: This parameter is a unique ID that identifies the contact who clicked the link, and the delivery the link was contained in.
  • _bta_c: (Only used with the addConversionLegacy method): This parameter is used to identify unique conversions when using the addConversionLegacy method.

For more information on deciding when to use the Tracking URL Parameters feature, see When To Use The Tracking URL Parameters.

Provided you have Click Through Link Tracking enabled, when a contact clicks a link contained in an email you send them via Bronto, we create a tracking cookie (most commonly used for tracking conversions). If the domain the URL points to is different from your domain, then the cookie created will be a third-party cookie. Third-party cookies may be blocked, depending on your contacts' browser settings, resulting in a loss of tracking data. In contrast, first-party cookies are much less likely to be blocked, thus ensuring that conversions are tracked.

For more information on Click Through Link Tracking, see Enable Click Through Link Tracking.

If you are tracking conversions using Legacy Conversion Tracking or addConversion, the data contained in the first-party cookie will be used to attribute the conversion to a specific contact and delivery.

For more information on using Legacy Conversion Tracking, see Legacy Conversion Tracking.

Tip: See the API documentation for addConversion for more information on tracking conversions using addConversion and the tid parameter.

To ensure that a first-party cookie gets created:

Procedure

  1. Go to Settings > Platform Settings > Data Exchange.
  2. Scroll down to the Click Through Link Tracking section.
  3. Make sure the Track which contacts follow links off of your messages box is checked.
    A tracking cookie will only get created if Click Through Link Tracking is enabled.
  4. Scroll down to the Tracking URL Parameters section.
  5. Check the Add tracking URL parameters used to create and use first-party cookies box.
    This will append the tracking parameters to URLs added to emails you send via the application. These tracking parameters are used to create a first-party cookie.
  6. Add the JavaScript tracking snippet (included below) to the top of any page (after the opening BODY tag) that you might link to in emails you send from the application. This JavaScript will create a first-party cookie using the tracking parameters appended to URLs added to emails you send via the application.

    Add JavaScript (TOP of the page after the opening BODY tag)

    
    
    <script type="text/javascript">
    document.write(unescape("%3Cscript src='" + ((document.location.protocol == "https:") ? "https:" : "http:")
    + "//p.bm23.com/bta.js' type='text/javascript'%3E%3C/script%3E"));
    </script>
    <script type="text/javascript">
    var bta = new __bta('
        ENTER APP BTA KEY HERE
    ');
    bta.setHost("
        ENTER SETHOST KEY HERE
    "); 
    
        ENTER SETHOSTTID KEY HERE
    
    </script>