Skip to main content

Update your Tie Events Pixel on Shopify

For Shopify stores updating Tie's pixel. Replace the code in your Tie Events Pixel with the new file from Tie, in your Shopify admin, with no theme changes.

T
Written by Tim Hughes
Tie and Shopify

When Tie releases a new version of the Tie Events Pixel, your Tie contact sends it to you as a .txt file. Updating means replacing the code inside the pixel you already have in Shopify. It's quick, it doesn't touch your theme, and the rest of your site keeps tracking the whole time.

What the Tie Events Pixel does. It's the part of Tie that runs inside Shopify's checkout, where your theme's code can't reach, so it's what sends Tie your checkouts and purchases. If it's out of date, those events can stop reaching Tie while everything else looks normal. On a headless Shopify store your checkout still runs on Shopify, so these steps are the same.

Step 1. Open the file Tie sent you

Your Tie contact sends the pixel as a .txt file with Tie Events Pixel in its name. Open it in a plain text editor such as TextEdit or Notepad, select everything, and copy it.

Copy from the file, not from an email or chat message. Email and chat apps can wrap long lines or change characters, and a single changed character stops the pixel from running.

You may also get a Tie Loader file. Keep it for your records. You only need to change your loader if your Tie contact tells you it's out of date (see the last section).

Step 2. Find your current Tie Events Pixel

2a. In your Shopify admin, go to Settings → Customer events. Every pixel on your store is in the Pixels list there. Type Tie in the search box to narrow it down.

2b. Find Tie's pixel. Depending on when you set Tie up, it may be named Tie Events Pixel, Tie Tracker, Tie or Revenue Roll (Tie's legal company name). Not sure which one it is? Open it and look for rr_purchase in the code. Only Tie's pixel contains it.

The Pixels list in Settings, Customer events, filtered to Tie, with the Tie Events Pixel row highlighted

Step 3. Replace the code

3a. Click Tie's pixel to open it. Click inside the Code box, select all of it (Cmd+A on a Mac, Ctrl+A on Windows) and delete it.

3b. Paste the whole contents of the file. The first few lines of the new code include PIXEL_VERSION. If the code you just deleted had no such line, it was an older version, which is exactly what this update replaces.

3c. Check the two settings on the pixel. Permission should be "Not required" and Data sale should be "Data collected qualifies as data sale."

3d. Click Save at the top of the page. If the button in the top right then says Connect, click it and confirm with Connect in the popup. The pixel only runs once it's connected, and a connected pixel shows Disconnect in that spot instead.

The Tie Events Pixel page with the new code pasted (3b), Permission set to Not required and Data sale set to Data collected qualifies as data sale (3c), and the Save button (3d) highlighted

3e. Optional. If your pixel has an older name, open More actions → Edit pixel name and rename it Tie Events Pixel, so it's easy to find next time.

Step 4. Make sure only one copy is connected

Back in the Pixels list, search for Tie again. If another pixel named Tie, Tie Tracker or Revenue Roll is also connected, open it, click Disconnect in the top right and confirm in the popup. Two copies count every checkout twice.

Step 5. Check that it's working

Visit your store, add any product to your cart and continue to the checkout page. You don't need to place an order. Then tell your Tie contact the update is done, and we'll confirm your checkouts and purchases are reaching Tie.

If your Tie contact also sent a new Tie Loader

The loader is the other half of Tie, and it lives in your theme rather than in Customer events. Change it only if your Tie contact tells you yours is out of date. Replace your existing copy rather than adding a second one, so the loader appears in your theme exactly once. Where it goes is covered in Step 1 of Install the Tie Pixel on Shopify.

If your theme is published from code, change the loader in your codebase, not in Shopify. A change made in Shopify's code editor is overwritten the next time your developer publishes, and tracking stops without any warning. Send the loader file to your developer instead. Understanding version control before you edit your theme explains why.

Rather we make the change?

We can update the pixel for you. Send your Tie contact your 4-digit collaborator request code and approve our request, and we'll make the swap and confirm it's working. Where to find your Shopify collaborator request code shows where to find it.

Did this answer your question?