How to install the Teads Pixel
There are a couple of ways to install the pixel:
Important Notes
Before going further, please be aware of the following important information:
Our pixel relies on a first-party cookie to measure the performance of your campaigns efficiently. Please make sure that our pixel is not integrated within an iframe or equivalent that would prevent such mechanisms.
If you use a tool like Floodlight, please prefer GTM, as explained here. For other tag managers using iframes, please contact your provider for help.
When a user clicks on one of your ads running on our network, the pixel expects the Teads Click ID (auctid
) in the clickthrough URL. You don't need to do anything to have this Teads Click ID forwarded, our platform will take care of forwarding this parameter automatically.
However, if you are using a third-party click tracker like Google Campaign Manager (formerly DCM), Sizmek, Adform, etc.. you'll need to ensure that our parameter is not removed between the click and the landing page of your website. Please check our dedicated section for more details.
Post-installation:
Once installed following one of the methods described below, you can verify that the pixel is working using our Teads Pixel Helper documented here.
You'll be able to create Traffic Acquisition Campaigns once your pixel is up and running.
Direct Integration
Step One: Get your pixel code and add it to your website
Log in to your Teads Ads Manager account at
https://ads.teads.com
.Click On Events Manager in the top bar.
If you don't already have a pixel, you can create a new one by clicking on the button Create Pixel. Otherwise, you can skip this step.
Once your pixel is created, you'll have access to an Actions menu, click on it, and select the Pixel Code option. A new window will show up, and you'll access the code of the pixel.
Click on the Copy Code Snippet button
Paste the code between the
<head></head>
tags of the pages of your website.Important: This code is for your account only. Please do not change it.
Step Two: Track Events
At this point, you should have a working pixel installed on your website.
A predefined list of events is available for tracking, either by firing them directly from your website or by defining corresponding URLs.
In both cases, you have to click on the Events button of your pixel.
A new panel will appear, listing all the available events.
Let's say you want to track purchases. For that, click on the appropriate event, here Purchase, it will give you access to two options. The first one consists of firing the purchase event programmatically by incorporating a piece of code directly on your website pages, to do so, you can copy the code snippet from the Code Based Event tab and put it to be triggered where the purchase happens.
The second option doesn't require any additional code integration on your website. It consists of defining a URL as the source of the event. For that, click on the URL Based Event tab.
Here you can add a new URL. Each time our pixel is called on a page, an internal event is fired, our platform will translate it to the proper event, here Purchase.
Before saving the new URL, you will have to click on the Check URL button. It will open a new tab on your browser with the URL you just entered and check if our pixel correctly fired on the page. If so, you will get a green light, and the Save URL button will become available.
Important note:
If the URL check fails, either because the pixel is not installed or because your website is not responding within the timeout, it won't prevent you to save the URL. We suggest not to save a URL until you have a green light from the check but in some cases you might want to set up the events before installing the pixel.
At the bottom of the page, under legacy events you will have access to the event code-based conversions that need to be updated to be used in future campaigns.
For more advanced event configuration, you can check the Event Metadata documentation.
At this point, you should have a working pixel with your first events set-up.
You might want to read our other articles related to the pixel here and if you are looking for other integration modes, please see below.
Google Tag Manager (GTM)
Log in to your Google Tag Manager account.
Select the Workspace associated with your website.
Click Add a new Tag
Click on Tag Configuration
Click on Discover more tag types in the Community Template Gallery
Search for "Teads" and select the tag named Teads Advertiser Pixel
Click the Add to workspace button to add the tag template to your Workspace
Select Tags from the menu and click New
In Tag Configuration, select Teads Advertiser Pixel and keep this window or tab open.
In a separate window, get your Pixel ID from the Events Manager section at
https://ads.teads.com
. Choose the pixel you want to use through GTM and click on Setup Pixel, then click on I will install the pixel using Google Tag Manager.Click back on the GTM tab and copy your Pixel ID and paste it into the Teads Identifier input on GTM.
If you are integrating the pixel itself, let the Teads Universal Pixel option be selected. Otherwise, if you are configuring GTM to track a specific event, you can select the Event based pixel option, the name of the event will be expected, retrieve it from the list of available events from Events Manager > Events button at
https://ads.teads.tv/events-manager
/pixels
Repeat the steps to configure events and triggers for all the pages you want to track conversions on.