Overview

The recommended flow for setting up event pixels is via Google Tag Manager (or our Shopify App, if you are using Shopify).

If Google Tag Manager does not fit your needs, you can use the manual method described below.

👍

This flow requires custom development.

Realize setup

Edit an existing conversion

If you already created a conversion in Realize, open it and copy the relevant code snippet:

1. Open Realize, and select the account (top, left) that you will use to track conversions.
2. In the sidebar (left), select Tracking.
3. Click on the Edit icon for the relevant event-based conversion rule.
4. Scroll down to the Event Code section. Mouse over the code snippet and click on COPY TO CLIPBOARD.
5. Keep Realize open and continue with the Web page setup below.

Create an event-based conversion

If you have not yet created a conversion in Realize, create it now, and copy the relevant code snippet:

📘

The instructions below illustrate the steps for setting up a registration event.

Other conversions - e.g. a purchase event - require slightly different steps.

---

For additional guidelines, see the Help Center.

1. Open Realize, and select the account (top, left) that you will use to track conversions.

2. In the sidebar (left), select Tracking.

3. Click on + New conversion (far right).

4. Type in a Conversion Name of your choice - e.g. Complete Registration.

   This is a descriptive name for your convenience. It need not match any value in GTM.

5. For Conversion Type, select EVENT:

   

6. If relevant, fill in a Fixed Value.

   Tip: If the event includes a dynamic value - e.g. a purchase event - leave this field blank. For additional guidelines, see the Help Center.

7. Select the relevant Category - e.g. Complete Registration.

8. Confirm that the Event Name is complete_registration.

   🚧

   Your web page must refer to the Event Name, exactly as entered here.
   Otherwise, Taboola will not be able to receive events passed by your web page.

9. (Optional) If desired, edit the following fields:

   1. Click Through Conversion Window
   2. View Through Conversion Window

10. (Optional) If relevant, clear the Include in total conversions checkbox.

    Tip: Always include the most important conversions, so that the Taboola algorithm will optimize towards them. For additional guidelines, see the Help Center.

11. (Optional) If relevant, clear the Include in total value checkbox.

12. (Optional) If desired, edit the following fields:

    1. Audience Properties
    2. Aggregation Type

13. Under the Event Code section:

    1. (Optional) If relevant, select 1 or more dynamic parameters.

       Note how the code snippet updates accordingly.
       For detailed guidelines, see: Track dynamic conversion values

    2. Mouse over the code snippet and click on COPY TO CLIPBOARD.

14. Review your chosen settings, and click on Create (bottom, right):

    

15. Keep Realize open and continue with the Web page setup below.

Web page setup

For each event in your conversion funnel, fire the relevant event pixel:

<script>
    _tfa.push({
        notify: 'event',
        name: '<event_name>',
        id: <account_id>
    });
</script>

📘

Params

• Replace <event_name> with the Event Name, exactly as it appears in Realize.
• Replace <account_id> with your numeric Taboola Account ID.

---

To copy a prefilled code snippet from Realize, refer to the Realize setup section (above).

For additional tips and techniques, see below.

What's next?

Well done! You have added an event pixel!

Next, you should verify that everything is running smoothly.

Tips & techniques

Send an email with prefilled code snippets

To send an email with prefilled code snippets for all your conversions in Realize:

1. Open Realize, and select the account (top, left) that you will use to track conversions.

2. In the sidebar (left), select Tracking.

3. Click on Account Tracking Setup (top, right):

   

4. Select Manually as the Setup Method, and click on Continue.

5. Scroll down to the Email instructions section.

6. Click on the Select Email Address button.

7. Fill in the relevant email address and click SEND.

8. Once you are done, click CLOSE.

Obtain your Account ID

To obtain your numeric Taboola Account ID:

1. Open Realize, and select the account (top, left) that you are using to track conversions.

   🚧

   Make sure to select the Taboola account that you are using to track conversions.

2. In the sidebar (left), select Tracking.

3. Copy the numeric Account ID on the screen (top, left):