Testing Tool

Overview

Use the Testing Tool to verify that your Taboola pixel conversion tracking is working smoothly.

🚧

The Testing Tool does not support S2S (server to server) conversion tracking.

Start a test

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

    Alternatively, select your network account.

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

  3. Under Conversions, select the Test Events tab.

  4. Enter the URL of the page that you want to test, and click on Generate QR Code.

    The URL must be a page that contains your Taboola pixel.

    🚧

    Enter the URL exactly as it appears in your ad (including any tracking params). This will mimic real-world conditions.

    (In some cases, if the URL redirects to another domain, you may need to enter the destination URL.)

  5. Test your site on mobile or desktop:

    1. To test on mobile, scan the QR Code with your phone.
    2. To test on desktop, click on the link provided. (Your site will open in a new browser tab.)

      👍

      Tip: For best results, test on both desktop and mobile.

  1. Browse your site, making sure to move through the various stages of your conversion funnel, as described below.

Test your events

👍

Testing Guidelines

  1. Disable all ad blockers for the page that you are testing.
  2. Enter the URL exactly as it appears in your ad (including any tracking params).

    In some cases, if the URL redirects to another domain, you may need to enter the destination URL.

  3. If prompted, make sure to consent to cookies.

    Note that Safari's strict privacy settings may block third party cookies.

  4. For best results, test on both desktop and mobile.
  5. Make sure that all expected events are received and that no errors are shown. *

* If no events appear - and the above steps are not effective - try testing with our Chrome extension. This will indicate if the event is fired at all.

Once you have started the test (previous section), it's time to verify that the expected events are received:

  1. Browse your site, making sure to move through the various stages of your conversion funnel.

  2. Make sure that all expected events are received and that no errors are shown.

  3. As each event is triggered, it will appear in the Events Received pane (right):

    🚧

    If no events are shown, refer to the Testing Guidelines above.

    If the above steps are not effective, try testing with our Chrome extension. This will indicate if the event is fired at all.

  4. To view event details, click on the arrow to expand.

    The following example illustrates the expanded view for a page_view event:

Event details

The following details are provided for each event:

Refer to the screenshot above for an example.

  • Quick summary (top, left):
    • Icon: indicates if the event is triggered by a Button click or URL visit.

      E.g.

    • Event name/description - page_view in the above example.

      The page_view event is fired each time the page loads.

    • Label - Automatically Fired in the above example.

      In the above example, the label indicates that you need not create a page_view event - it is managed automatically.

  • Date/time (top, right)
  • Account ID: The Taboola Account ID referenced in this pixel.

    This is typically your current account (top, left) in Realize. If your current account (top, left) in Realize is your network account, then this could be any sub-account in your network.

  • Event name: The event name/description - e.g. page_view
  • Page URL: The URL of the page that triggered the event.
  • Parameters: This field is shown only if the event passes additional parameters - e.g. value and currency.
  • Condition: This field is shown for a URL visit event only. It is the condition that triggers the event.

    E.g "."- i.e every page triggers this event.

  • Contents: The specific data passed for this event.

    This data is used for technical troubleshooting - you can typically ignore it.

Manage the view

  1. To temporarily clear the Events Received pane, click on Clear Activity (top, right).

    As new events are received, the pane will start to fill up again.

Check for issues

  1. If the testing tool detects any issues:
    1. The Events Received pane displays a total count of events with issues (top, right).
    2. Each event with an issue is tagged with an error icon.
  2. To see details of a given issue, expand the relevant event and mouse over the error icon shown.
  3. Some examples include:
    1. Unmatched conversion: The event received does not have a matching conversion in Realize.
    2. Parameter errors: Additional parameters in the event have issues. E.g.
      1. Incorrect format for currency
      2. Invalid amount for value