Content:
What data can be sent between Taboola and Ringba
How to connect Taboola with Ringba
What is Ringba
Ringba is an inbound call tracking and analytics platform for marketers, brands, and pay per call. It is integrated with Taboola and it provides you with the ability to create Taboola-specific campaign links and it is capable of sending us S2S conversions once configured properly. This guide will cover how to set up S2S via Ringba.
What data can be sent between Taboola and Ringba
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).
❗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.
❗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 connect Taboola with Ringba
1. Navigate to the left side menu, select Numbers → Manage Pools and click on 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 please follow this article in Ringba’s Help Center.
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. For detailed instructions, refer to Ringba’s Help Center.
When setup 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:
|
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 visit the Ringba’s Help Center.
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 which Ringba calls 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. You can simply type it, or if you want the taboola_id to show when you click on the Token button menu and avoid typos, you must set up a URL parameter in advance. To do this, go to the Integrations menu, then URL Parameters, and create one using the following settings:
Once you enter those values, click Create URL Parameter as shown below. Now you would be able to simply click on Token and select taboola_id to add to your pixel. 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.
✅ If you have questions or concerns, contact your Taboola Account Manager or email support@taboola.com.