Once you have followed the steps to create and install the Teads Pixel, the final step of the pixel configuration process is to set up the conversion event(s) that are relevant to your brand.
Each Teads Pixel within TAM Events Manager allows you to track 9 types of conversion events, each of which can use either URL-based or code-based triggers.
The Events Manager also provides detailed statistics on your pixel and created events. To view these statistics, select View Pixel & Conversion Activity from the pixel options menu.
Follow the steps below to set up a conversion event:
1. Select the Create Event button of your pixel in Events Manager.
2. There will be two options for creating conversions to choose from:
Code based & GTM events:
Code based & GTM events:
This is the recommended method of event configuration, and consists of directly incorporating a piece of code onto your website, which will be triggered when the specific event occurs (e.g. Purchase, Search, Complete Registrations, etc).
There are two methods available to trigger code-based events:
Using the Teads Advertiser Pixel template in Google Tag Manager (recommended), or
Manually configuring the code snippet within the code of your website to load whenever the specific event occurs.
Refer to the steps below to implement the pixel via Google Tag Manager (recommended):
Open GTM and select the Workspace associated with your website.
Click Add a new Tag.
Select 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.
Enter your Pixel ID from the Events Manager section in Teads Ad Manager into the Teads Identifier input on Google Tag Manager.
Select the Event based pixel option within the Teads Advertiser Pixel template, and enter the name of the standard event in the field provided.
You can also add event metadata for more advanced tracking.
For more information, refer to our Event Metadata documentation.
Select the most appropriate trigger to fire your conversion event.
If you prefer to implement the event code directly into the HTML of your site, follow the steps below:
Start by clicking on the Code based & GTM option in the Create Event menu.
Select the appropriate Event category for the conversion you wish to track.
Give the conversion event a unique name and click Save.
The next screen will present the event code snippet in the Code Based section.
Implement the event code in the <head> section of the page where the conversion event takes place in the website (e.g. product pages, purchase confirmation page).
Ensure that the event code is properly formatted. There should be no spaces in the conversion type value. For example, "AddToCart" should be used instead of "Add To Cart".
When using event metadata (recommended), it is possible to add name, price, and currency values for more advanced event tracking. The 'name' value can use any text with no special formatting required.
Note that metadata values must be populated dynamically.
For more information, refer to our Event Metadata documentation.
You must ensure that the conversion tag script is only triggered when the conversion point is reached. It is possible to fire the tag based on a variety of triggers including (but not limited to):
Visiting a specific URL: If the code will be triggered by a URL (e.g. order confirmation page), it is strongly recommended that it is implemented in the backend of the website and triggered via the server.
A click on a specific element: This will require implementing additional javascript based on your website's structure. Refer to the step by step guide here.
Viewing a specific element: This will require implementing additional javascript based on your website's structure. Refer to the step by step guide here.
URL based events
URL based events
This option does not require any additional code integration on the website. Instead, it involves setting a URL, like a purchase confirmation page, as a keyword that indicates the occurrence of the event. To use this option, start by clicking on the URL based option in the events configuration screen.
Select the appropriate Event category for the action you wish to track.
Give the conversion event a unique name.
Use the 'URL Contains' field to add a URL keyword that will function as the trigger to indicate a conversion has taken place. For example, by adding the keyword "search" it would be possible to track Search events across multiple domains like the examples below:
US version of the domain: www.teads-advertiser.com/search
FR version of the domain: www.teads-advertiser.fr/search
IT version of the domain: www.teads-advertiser.it/search
Event Creation Guidelines and Limits
Each event must have a unique name across all categories. Duplicate names are not allowed.
Use lowercase letters and underscores when possible. Allowed characters: A–Z, a–z, 0–9, underscore (_), hyphen (-), and space.
Avoid accents and special characters such as /, #, &, %.
Maximum 100 characters permitted for the Event Name and Product Name (≤ 50 recommended for readability).
A maximum of 100 active conversion events per advertiser pixel are permitted.
A maximum of 20 custom events per category are permitted.