Tatari Setup - Northbeam

When you’re done, Northbeam shows your Tatari clicks, matchbacks, and attributed orders under the Clicks & Matchbacks attribution model.

Before you start, make sure you have:

A login to your Tatari Dashboard with access to Account Settings → Integrations
Shopify stores: permission to install apps from the Shopify App Store
Custom platforms: access to your site’s <head> code and the token Tatari gives you
Access to Connections in Northbeam

This integration supports only Streaming inventory by default. Linear inventory isn’t turned on automatically. If you need Linear, contact Northbeam Support to turn it on for your account.

1. Set up user tracking

Add Tatari’s tracking to your site.

2. Connect the account

Turn on AWS Data Sharing and enter your Tatari ID.

3. Add AWS credentials

After 24 hours, paste Northbeam’s AWS credentials into Tatari.

4. Confirm tracking

Check that Tatari data is arriving.

Set up user tracking in Tatari

Northbeam needs Tatari user tracking to attribute Tatari-driven orders correctly. The setup depends on your store platform. For more detail, see Tatari’s User Tracking Guide.Shopify

Open the Tatari Tag Manager app on the Shopify App Store.
Click Add app and follow the prompts.

Once it’s installed, the app manages the pixels that track funnel events from your TV campaigns.Non-Shopify (custom platform)

Add this script to your site’s <head>. Replace YOUR_TOKEN (in two places) with the token Tatari gives you.
When a user logs in, call tatari.identify({user_id}), replacing {user_id} with your internal user ID.

 <script>
     !function(){try{!function(t,i){if(!i.version){window.tatari=i,i
     .init=function(t,n){var e=function(t,n){i[n]=function(){t.push([
     n].concat(Array.prototype.slice.call(arguments,0)))}};"track
     pageview identify".split(" ")
     .forEach(function(t){e(i,t)}),i._i=t,i.config=n,i.pageview()}
     ,i.version="1.2.1"; var
     n=t.createElement("script");n.type="text/javascript",n.async=!0
     ,n.src="https://d2hrivdxn8ekm8.cloudfront.net/tag-manager/YOUR_TOKEN-latest.js";var e=t.getElementsByTagName("script")[0];e.parentNode.insertBefore(n,e)}}(document,window.tatari||[])}catch(t){console.log(t)}}();
     tatari.init('YOUR_TOKEN');
 </script>

Use the same customer IDs in Tatari and Northbeam. The user IDs you send to tatari.identify must match the customer IDs on your Northbeam orders. Custom setups vary, so check that yours lines up with Northbeam’s requirements.Need help with user tracking? Contact your Tatari representative. Northbeam can’t help with this part.

If you skip this step: Northbeam can’t accurately attribute Tatari-driven orders. If customer IDs don’t match, you may see clicks and matchbacks but no revenue or transactions.

Connect your Tatari account

AWS Data Sharing lets Northbeam access your Tatari-attributed order data.

Log in to your Tatari Dashboard.
Go to Account Settings → Integrations and make sure AWS Data Sharing is turned on.

Next, give Northbeam your Tatari ID and pick your source of truth so the two stay in sync:

Find your Tatari ID in your Tatari account URL.
In Northbeam, open Connections and find Tatari.
Enter your Tatari ID, select your Orders Source of Truth, and click Connect.

Northbeam then creates the AWS credentials you’ll use in the next step.If you skip this step: Northbeam can’t access your Tatari-attributed order data.

Add the AWS credentials in Tatari

Wait 24 hours first. After you enter your Tatari ID and source of truth, allow up to 24 hours for the connection to finish processing.

If you add the AWS credentials too early, Tatari shows “API Error 400: Invalid ARNs”. That’s expected. Wait until the 24 hours are up and try again.

Tatari error message reading API Error 400: Invalid ARNs — The error you'll see if you add credentials too early

Then add the credentials:

Copy the AWS credentials Northbeam created when you connected your Tatari ID.
In Tatari, go to Account Settings → Integrations and select AWS Data Sharing.
Enter the AWS credentials from Northbeam and click Add.

If you skip this step: the integration isn’t complete, so Tatari data doesn’t reach Northbeam.

Confirm tracking

Quick check: your Tatari data shows up under the Clicks & Matchbacks attribution model. “Matchbacks” are the attributed orders Tatari reports. On a new integration, it can take up to 7 days for all your data to fill in, oldest first.For a full check:

Connection syncing: follow Checking platform connections to confirm the account shows as connected and data is arriving.

If a check fails, see Troubleshooting Northbeam data.

Need help?

Tatari FAQ

Where Tatari data shows up, how often it updates, and missing revenue.

Troubleshooting Northbeam data

Start here if a check above fails.

1. Set up user tracking

2. Connect the account

3. Add AWS credentials

4. Confirm tracking

Set up user tracking in Tatari

Connect your Tatari account

Add the AWS credentials in Tatari

Confirm tracking

​Need help?

Tatari FAQ

Troubleshooting Northbeam data

Need help?