Orders REST API Tracking Attribution

You can pass tracking data to Bronto using a TID. A TID is a unique id that associates an order with a specific contact and delivery. How you can identify the TID is dependent upon whether or not your account uses a private domain.

  1. Log into Bronto.

    If you cannot log into Bronto ask the person who uses your company’s login to complete these steps.

  2. Go to Settings > Platform Settings > Commerce.
  3. In the Order Settings section, check to see if Add tracking URL parameters used to create and use first-party cookies is checked.
  4. If this:
    • is checked, your account does not use a private domain. Continue to the When You Use Bronto’s Domain section.
    • is NOT checked your account uses a private domain. Continue to the When You Use a Private Domain section.

When You Use Bronto’s Domain

In this case, tracking information is passed as part of a query string request to the commerce site. To find the TID, parse the query string for the parameter _bta_tid. For example: A customer clicks on an email link and is directed to the commerce site:

https://shopping.example.com?_bta_tid=12345678901234567890123456789012345678901234567890

Then you capture the value from _bta_tid, store it so it is associated with the shopping session, and attach it to cart or order REST requests. In this example, the TID element is { "tid":"12345678901234567890123456789012345678901234567890"; }.

When You Use a Private Domain

In this case, Bronto sets a cookie on the domain of your commerce site that contains the TID. This cookie is named tid_{encrypted site_id} so you will need to determine what your encrypted site ID is in order to find the cookie. The encrypted site ID is the bsw.src value found in the Bronto embed code. You can either read the embed code from where it is on your site, or log into Bronto, go to Home > Settings > Commerce and read the embed code in the Tag Manager section.

Once you have your encrypted site ID, open the file named tid_{encrypted site_id}. The value string is your TID. For example: A customer clicks on a link and is directed to the commerce site https://shopping.example.com Bronto sets a cookie:

name = tid_3gvfksuhdbvbicfddvov4g3i4xmfitkgvsd6720yko4vtp1ngyzz
        value = 12345678901234567890123456789012345678901234567890

Then you capture the value from the cookie, store it so it is associated with the shopping session, and attach it to cart or order REST requests. In this example, the TID element is: { "tid":"12345678901234567890123456789012345678901234567890"; }.