Overview

If you previously integrated the Taboola pixel manually (or via a third-party app), we recommend using the Taboola Pixel app instead.

Before you install the app, you need to remove all legacy integration code, as described on this page.

📘

Where should I check?

There are a number of different manual integration methods for Shopify. To make sure that no legacy code is left behind, we recommend checking all of them.

📘

Guidelines & flow

1. Check all relevant configurations in your Shopify dashboard, and delete any Taboola pixel scripts that are present.
2. For each step in the purchase funnel, verify that no pixels are fired.

3rd party apps

If present, we recommend uninstalling any 3rd party apps that you previously used to install the Taboola pixel:

1. Log into your Shopify dashboard.
2. Click on the Apps node in the sidebar. A popup appears with your installed apps.
3. Search for the relevant 3rd party app, and uninstall it.

Dashboard settings

In your Shopify dashboard, review the settings below.

Customer event settings

1. Select Settings > Customer Events
2. Look for any pixels with the name Taboola Pixel., or similar.

   (The exact name may vary depending on what your team called it, or which 3rd party app installed it.)

3. If present, delete it (or mark it as disconnected, and delete it later).

Checkout settings

1. Select Settings > Checkout
2. Scroll down and look for a Post-purchase page section.
3. If the Post-purchase page section is present, look under Additional Scripts for a script containing _tfa.push. If present, remove it:

<script>
  _tfa.push({
    notify: 'event',
    name: 'make_purchase',
    id: 123456,
    revenue: '{{ total_price | money_without_currency }}',
    currency: '{{ shop.currency }}',
    orderid: '{{ order_number }}'
  });
</script>

Sample screenshot:

4. Scroll down slightly further to the Order status page additional scripts section.
5. Under Additional Scripts, look for a script containing _tfa.push. If present, remove it (see the sample script above).

Theme templates

In your Shopify dashboard, review the theme templates below.

layout template folder

1. Select Online store > Themes > Edit Code
2. Under the layout template folder, select theme.liquid
3. Look for a script containing _tfa.push. If present, remove it:

<!-- Taboola Pixel Code -->
<script type='text/javascript'>
  window._tfa = window._tfa || [];
  window._tfa.push({notify: 'event', name: 'page_view', id: 123456});
  !function (t, f, a, x) {
    if (!document.getElementById(x)) {
      t.async = 1; t.src = a; t.id = x; f.parentNode.insertBefore(t, f);
    }
  }(document.createElement('script'),
  document.getElementsByTagName('script')[0],
  '//cdn.taboola.com/libtrc/unip/123456/tfa.js',
  'tb_tfa_script');
</script>
<!-- End of Taboola Pixel Code -->

4. Under the layout template folder, select checkout.liquid.

📘

If checkout.liquid is not present, you can skip to the next section.

6. Look for a script containing _tfa.push. If present, remove it:

<!-- Taboola Pixel Code -->
<script>
  _tfa.push({
    notify: 'event',
    name: 'start_checkout',
    id: 123456,
  });
</script>
<!-- End of Taboola Pixel Code -->

snippetstemplate folder

1. (If you have not already done so, select Online store > Themes > Edit Code)
2. Under the snippets template folder, select buy-buttons.liquid.
3. Look for any scripts containing _tfa.push. If present, remove them.

Sample script to remove

onclick="_tfa.push({notify: 'event', name: 'add_to_cart', id: 123456});"

Verification

Use the following steps to verify that all legacy integration code has been removed.

🚧

Important

You must perform the following verification before installing the Taboola Shopify App.

📘

For more infromation about the verification flow, see: Verify your web pages

Using a Chrome web browser:

1. Install the Taboola Pixel Helper extension from the Chrome Web Store.

2. Click on extensions (top, right), and pin Taboola Pixel Helper to the toolbar for quick access.

3. Open your Shopify site, and click on the extension. Verify that no pixels were detected.

4. For each step in the Shopify purchase funnel, verify that no pixels were detected by the extension:

   • Product Search
   • Product Collection View
   • Product Details View
   • Add To Cart
   • View Cart
   • Start Checkout
   • Make Purchase

📘

The exact name for each event may vary, depending on what you named it.

What's next?

If no pixels were detected, install the Taboola Pixel app.