Skip to main content

Taboola

Amanda Cross
Updated

What is Taboola

Taboola is the world leading native advertising platform built for creating meaningful engagements. It is integrated with Ringba and provides you with the ability to create Taboola-specific campaigns and is capable of sending Taboola S2S conversions once configured properly.

This guide with cover how to setup a S2S conversion tracking between Ringba and Taboola.

What data can be sent between Ringba and Taboola

Conversions and events are sent to Taboola based on a number of preconfigured trigger options available in Ringba. These triggers are defined by Ringba, not Taboola. Taboola can track all conversions and events or just the Converted (for conversions).

Note: If the goal is to track more than just Converted events, you’ll need to create multiple Pixels in Ringba to track all the different events offered.

There are types of events that can be sent between Taboola and Ringba:

  • Incoming: The pixel will be fired as soon as the call appears in the Ringba platform.
  • Connected (answered): The pixel will be fired when the call is answered by a target.
  • Completed: The pixel will be fired as soon as the call is finished after connecting to a target.
  • Error: The pixel will be fired if the call was marked as an error.
  • Converted: The pixel will be fired only if the call is converted.
    Note: Payout may occur after conversion, in which case payout information is not yet available to pixels that use this option. If you need to send payout information, choose the Payout option instead.
  • Payout: The pixel will be fired if the call was marked to have a payout to a publisher.
  • Finalized: The pixel will be fired when the call ends, regardless of how it ended (picked up, no answer, etc.).
  • Recording: The pixel will be fired when the recording is available to listen to. The recording usually takes a few seconds to appear after the call completes so the pixel will only fire when it appears in the call reporting.

How to Integrate Ringba with Taboola

  1. Navigate to the left side menu, select Numbers > Manage Pools and click Create Number Pool. This will give you the options to allocate the number pool. This is the pool of numbers that will be shown to the user on the landing page. When a visitor lands on the page, Ringba’s script loads and pulls a number attached to the impression that will hold the data until Ringba sees the call come into this number. For more details, see Number Pools.

  2. Switch to the Campaigns tab, scroll down to the Publisher section and make sure you already have a publisher with an attached publisher number.

     

  3. Once you have this, under the Call Tracking Tags click on Add Call Tracking Tags. Select the same number that was attached to the publisher under the Primary Number as well as in the Number to replace, and finally turn on Capture User Data and select the Number Pool you created before. Click on Generate.

    This will generate the unique JS snippet to be able to receive call tracking tags into your campaign. When you generate the script it will be immediately shown as in the image below.

    If you have already created the tag and would like to access it after the initial setup, you will see something like this under the Call Tracking Tags, click on the <> icon and you will get the snippet view again:

  4. Share the snippet with your publisher, who will then need to integrate it into the landing page. Once the snippet is embedded, ensure the landing page includes a placeholder for the Number to replace. This placeholder will be dynamically updated with the pool number by our code. When a visitor calls the displayed number, all relevant information for that impression will be linked to the call as Tags.
    When set up correctly, Ringba will grab every parameter in the URL of the landing page and attach to the call, for example:
    https://www.mylandingpage.com?taboola_id=xxx&page=6&ad_id=zzzz

    The following tags will be present in the call:

    * “taboola_id” with value “xxx” 
    * “page” with value “6” 
    * “ad_id” with value “zzzz”

  5. Once the landing page is working correctly (you get the Taboola Click ID or any other needed parameter in the URL on Ringba as described in the previous step) connect Taboola to Ringba using a pixel.

    To create the pixel go to Integrations > Pixels and click on + Create Pixel. Then enter a name for your pixel and select the proper trigger to send back data into Taboola. For example, the trigger can be when the call lasts 120 seconds. For more details on setting pixels, please see Pixels.

  6. The crucial component of the setting up the pixel is to reference the Taboola Click ID or any other data required by Taboola to properly track the conversion. In the URL section, you will need to attach a dynamic element called Tokens in order to populate the unique Taboola Click ID when firing the pixel. The following is an example of a pixel that fires with a tag that came from a landing page. Ringba labels those tags under User tags as they were generated by the user and not Ringba’s system.

    Using the landing page example from step 4 you can see that the user tag was called “taboola_id” with value “xxx”: https://www.mylandingpage.com?taboola_id=xxx&page=6&ad_id=zzzz

    When setting up the pixel fire you must use [tag:User:taboola_id] to reference when firing the Taboola postback URL. The pixel will look like this:

  7. Once you are done, click on Create and the pixel will be ready to be used in any campaign you want.

  8. To add the pixel to your campaign, go back to your campaign and scroll down to the Tracking Pixels section. Under Select Existing, find the pixel created in the previous steps, select it and click on Add.

  9. That is it, setup is now complete and every visitor that lands on the page will have a pool number to dial, Ringba will attach the tags when receive the call, and subsequently when the call converts in Ringba it will fire a postback pixel into Taboola with the information needed.

Related articles