Taboola is the world-leading native advertising platform built for creating meaningful engagements. Ringba makes it easy to integrate Taboola with your Ringba account by letting you create Taboola-specific campaigns and sending Taboola S2S conversions once configured properly.
This guide covers how to set up S2S conversion tracking between Ringba and Taboola.
Sending Data Between Ringba and Taboola
Ringba sends conversions and events to Taboola based on a number of trigger options. These triggers are defined within Ringba, not Taboola. Taboola can track all conversions and events or just the "Converted" events.
Note: If you want to track more than just Converted events, you must create a Ringba Pixel for each event you want to track.
You can send the following types of events between Taboola and Ringba:
- Incoming: The pixel fires as soon as the call appears in the Ringba platform.
- Connected (answered): The pixel fires when the target answers the call.
- Completed: The pixel fires as soon as the call finishes after connecting to a target.
- Error: The pixel fires if the call was marked as an error.
-
Converted: The pixel fires 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 fires if the call was marked to have a payout to a publisher.
- Finalized: The pixel fires when the call ends, regardless of how it ended (picked up, no answer, etc.).
- Recording: The pixel fires when the recording is available to listen to. The recording usually takes a few seconds to appear after the call completes, so the pixel also fires a few seconds later, when the recording appears in the call reporting.
How to Integrate Ringba with Taboola
Use the following steps
- Navigate to Numbers > Manage Pools, and then click Create Number Pool. Complete the fields and click Save to create a number pool.
A screen appears with options to define a number pool. This is the pool of numbers that appear to potentially callers who are visiting your landing page. Number pools use a JavaScript snippet on your landing page to display a different phone number from the pool to each visitor. When the visitor calls, Ringba can tie the browsing session data to the call data using the distinct phone number. For step-by-step instructions, see Number Pools.
-
Navigate to Campaigns and open the campaign you want to use. Scroll down to the Publisher section and make sure you already have a publisher with an attached publisher number. For detailed instructions on how to create a publisher and attach it to a campaign, see Publishers.
-
Still on the Campaigns screen, scroll to the Call Tracking Tags section. Click 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 Generate.
Ringba generates the unique JS snippet you need to receive call tracking tags into your campaign. When you generate the script, it appears immediately, as in the image below.
If you want to find the snippet again later, you can find it on the campaign in the Call Tracking Tags section. Click the <> icon under the Actions heading and to display the snippet. - Share the snippet with your publisher and instruct them to integrate it into the landing page.
Tip: Your publisher can start at step 4 of the procedure on the Number Pools article.
Once the snippet is embedded, ensure the landing page includes a placeholder for the Number to replace. The script dynamically updates the placeholder with a pool number. When a visitor calls the displayed number, the script links all relevant information for that impression 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”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, navigate to Integrations > Pixels and click + 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.
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 must attach a dynamic element called Tokens in order to populate the unique Taboola Click ID when firing the pixel. The image below shows 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 looks like this: -
Once you are done, click Create, and the pixel becomes available to use in any campaign you want.
-
To add the pixel to your campaign, open your campaign and scroll down to the Tracking Pixels section. Under Select Existing, find the pixel you created in the previous steps, select it, and click Add.
- That is it, setup is now complete! Every visitor that lands on the page sees a number from the number pool to dial. Ringba attaches the tags when receiving the call, and, when the call converts, Ringba fires a postback pixel into Taboola with the information needed.