Postback Conversions from TrackDrive to Ringba

In Ringba - Create a Global Postback for Any Buyer

Ringba has a menu selection at Integrations/Webhooks that will be used to setup a Webhook for the Postback of converted calls.  It is easiest to set a Global Postback since the Call UUID is already unique; however, if you want to be more secure, you can set a Webhook for a single campaign or even for a single buyer to ensure the unique token for the Webhook is more secure.  

NOTE: A Global Webhook could be use for any Target to post back conversions, this logic is not just for the TrackDrive Integration.  In TrackDrive's opinion, you need only to setup one Webhook for Postbacks and it can be given to any Target to do a postback, since they would have to know both the UNIQUE Webhook token you see in the URL AND the exact call_uuid that you sent in a field to a buyer. 

From Integrations/Webhooks, click on Create Webhook.  Then simply fill in the following values:

NOTE: (even tho you can make custom field names for a webhook in Ringba, TrackDrive sets up a global hook on each client to get back to Ringba, and we are not expecting different field names than EXACTLY what you see below.  Our clients tag the number you are given with the ringba_webook_token and if the call also has ringba_call_uuid, the Global Postback Triggers.)

Name: Global Buyer Revenue Postback (or however you wish to name this webhook)

Call Token: call_id

Revenue Token: call_revenue

Fire Conversion: sale_successful=true

This will produce a URL with a unique identifier for the webhook in the URL.  You may simply give your TrackDrive Buyer the full URL produced from filling in the form as a Postback to place in TrackDrive.

Example URL: https://webhook.ringba.com/hook/WHbb01eb9114dc46429d7570fa4a6f87fb?call_id=[callUUID]&call_revenue=[conversionAmount]&sale_successful=true

Below is a picture of a Global Revenue Postback Webhook in Ringba:

In TrackDrive - Create a Global Ringba Postback Trigger

TrackDrive has a menu selection at Company/Webhooks where you can place a global trigger to Postback to any call that is from a Ringba Traffic Source and the ringba_call_uuid field has a value.  If you have not done so already, copy in the Global Trigger from TrackDrive Templates and then only a few things need to be changed.

From Company/Webhooks, click on the blue “New From Template” button to find available webhook templates and search for “Ringba”.  You will find a webhook to copy in called “GLOBAL TRIGGER: RINGBA WEBHOOK: Do a Postback for Ringba Traffic Sources if ringba_call_uuid is populated”.

Once the copy is done, you should not have to edit the Trigger or the Webhook URL in most situations.  However, it depends on if it is easier to map the “ringba_webhook_token” here (if the traffic source made a Global Webhook in Ringba, this would be the preferred place to identify this token value), or in each Number you assign to the Ringba Traffic Source (in the case they give unique webhook token values for each number you assign them).  You can combine both methods, it all depends on your Traffic Source's configuration in Ringba.

Option 1: Map “ringba_webhook_token” in the URL settings:

Edit the Webhook URL, then edit the “Ringba Webhook Token Field Mapping Group” using the inline menu. Click the “+ New Custom Field Mapping” button to add a New Custom Field Mapping. Then for any Ringba Traffic Source that uses global webhook for buyer revenue postback, set a filter for the traffic source and map the “ringba_webhook_token” to the unique value in the Ringba URL provided.

A picture of mapping the ringba_webhook_token in the Global URL Mappings is pictured below:

Option 2: Set the “ringba_webhook_token” in the Number provided to the Traffic Source:

If your Traffic Source didn't realize that Ringba can use a Global Webhook for Revenue Postback, it is highly suggested you guide them to this document on how to setup a Global Revenue Postback and use Option 1 above.  If they have a use case that they do need to give you many Webhook Tokens for various reasons, then is will be more logical to set the “ringba_webhook_token” value in the Number .

A picture of mapping the ringba_webhook_token in a TrackDrive Number is pictured below: