Guides
Log In
Guides
Start typing to search…

Google Tag Manager

DCO Pixel > Set up with Google Tag Manager

📍

This section refers to the Taboola DCO solution. For the standard e-commerce solution, see here.

The Google Tag Manager (GTM) is a tool that allows you to add and update tags and code snippets, such as conversion tracking and site analytics, without editing your website's code.

What is a tag?

A tag is a piece of code provided by marketing or analytics platforms to send information to them (e.g., Taboola Pixel, Facebook Pixel, Google Analytics Tracking Code, Remarketing Tags, etc.).

What is the E-commerce Taboola pixel template?

The E-commerce Taboola pixel template (for Google Tag Manager) allows marketers to easily implement the DCO pixel without the need to know how to code.

📺

Video instructions

Prefer to watch a video? Check out our step-by-step video guide for GTM setup.

Add the Taboola tag

In your GTM workspace:

  1. In the navigation panel (left), select Templates:

  2. In the Tag Templates section, click on Search Gallery.

  3. Search for and select the E-commerce Taboola pixel template.

    For DCO, make sure to select the above template (and not the Taboola Pixel template).

  4. Click Add to workspace and confirm by clicking Add.

Configure the tag

In your GTM workspace:

  1. In the navigation panel (left), select Tags:

  2. Click on New (top, right).

  3. In the Tag Configuration panel, select the Taboola E-commerce Events Tracking Pixel template that you added.

  4. Enter your Account ID (also called Advertiser ID). This is provided by your Taboola account manager.

    🚧

    Important

    Replace all fields with your Advertiser ID supplied by your DCO Account Manager. This is NOT the same as your DCO Seat ID.

  5. From the Event Name dropdown, select the event you want to track. The available events and their use cases for your specific industry are detailed in the Tracking events section below.

  6. Under Event Parameters, provide the required parameters for the selected event.

  7. Under Triggering, select the trigger that corresponds to the user action you want to track (e.g., a user viewing a product page).

  8. Click Save.

Event parameters

The following tables show the GTM variables you need to configure for each event. When setting up an event in GTM, select the appropriate GTM variable that returns the required data from your website's data layer.

📘

Data layer options

If your site uses Google Analytics 4 (GA4) or Universal Analytics data layer structure, many of these fields may be automatically populated when you enable the corresponding checkbox in the tag configuration. For sites without these data layers, you'll need to manually configure each parameter.

📘

E-commerce terminology

Due to technical requirements, the pixel uses e-commerce terminology (e.g., productIds, cartDetails) across all verticals. See your industry tab below for how to interpret these fields.

Select your industry to see the relevant GTM event configuration:

Event

Description

Parameters

Product View (Mandatory)

The user viewed the info page of an item.

Product IDs (Mandatory)
String/Array of strings/strings separated by commas
Select the GTM Variable that returns the main Product ID in the current page.
Examples: ["sku1"], "sku1"


The Product ID value must match one of the product identifier columns (e.g., GTIN, SKU, MPN, etc.) in your feed. Product ID values passed for Product View event should be consistently passed across all other events.

Purchase (Mandatory)

A purchase was made.

Cart Details (Mandatory)
Array of objects
Select the GTM Variable that returns an array containing the quantity, product ID and the unit price of each item in the user's cart.
Example: [{productId: "sku1", quantity: 3, price: 22.45}, {productId: "sku2", quantity: 4, price: 15.76}]

Important: Use the exact structure shown above. Attribute names MUST remain unchanged (use productId not ID).


Order ID (Mandatory)
String
Select the GTM Variable that returns the Order ID of the current transaction. This ID should be unique per Order.


Value (Mandatory)
Number (Decimal)
The total value of the purchase in the given currency.
Example: 9.99


Currency (Mandatory)
String
The currency used in the cart in ISO 3-letter currency code notation.
Example: "USD"

Add to Cart (Mandatory)

A product was added to the shopping cart.

Product IDs (Mandatory)
String/Array of strings/strings separated by commas
Select the GTM Variable that returns Product IDs in the current page.
Examples: ["sku1"], ["sku1", "sku2"]

Search (Optional)

A search results page was displayed to the user. Send the first 5 product IDs of the search result.

Product IDs (Optional)
String/Array of strings/strings separated by commas
Select the GTM Variable that returns Product IDs of the first 5 products in the result list.
Example: ["sku1", "sku2", "sku3", "sku4", "sku5"]


Search Term (Optional)
String
Select the GTM Variable that returns the search term entered by the user.
Example: "long dress"

Category View (Optional)

A list of products was displayed to the user by browsing a category. Send the first 5 product IDs.

Product IDs (Optional)
String/Array of strings/strings separated by commas
Select the GTM Variable that returns Product IDs of the first 5 products in the result list.
Example: ["sku1", "sku2", "sku3", "sku4", "sku5"]


Category (Optional)
String
Select the GTM Variable that returns the name of the category being viewed.
Example: "Womens Shoes"


Category ID (Optional)
String
Select the GTM Variable that returns the ID of the category being viewed.

Home Page Visit (Optional)

The home page was displayed to the user.

No additional parameters required.

Checkout (Optional)

A checkout flow was started.

Product IDs (Optional)
String/Array of strings/strings separated by commas
Select the GTM Variable that returns Product IDs in the current page.
Examples: ["sku1"], ["sku1", "sku2"]

Add to Wishlist (Optional)

A product was added to a wish list.

Product IDs (Optional)
String/Array of strings/strings separated by commas
Select the GTM Variable that returns Product IDs in the current page.
Examples: ["sku1"], ["sku1", "sku2"]

Remove from Wishlist (Optional)

A product was removed from the wish list.

Product IDs (Optional)
String/Array of strings/strings separated by commas
Select the GTM Variable that returns Product IDs in the current page.
Examples: ["sku1"], ["sku1", "sku2"]

📘

Job Platforms

Job Platforms use the JavaScript API only and do NOT support GTM configuration. See the JavaScript API setup for Job Platforms implementation.

Publish your changes

After creating and verifying the tags, the changes must be submitted and then published to apply them to the live environment:

  1. Click Submit in your GTM workspace.
  2. Click Publish.
  3. Verify that your changes are live.

What's next?

After publishing your GTM configuration, validate that your pixel is firing correctly.

Updated about 15 hours ago