Ringba and Voluum make it easy to track your inbound calls as conversions for your Voluum offers and report them back to Ringba for attribution.

Voluum is an ad-tracking platform for performance marketers and media buyers running traffic that provides robust tools for managing affiliate partnerships.

Requirements

Before you get started, you must have a Ringba Campaign with at least one Publisher and Tracking Number assigned to them. You will also need a webpage (lander) with a click-to-call action and the ability to add custom scripts. This webpage will be used as an Offer in Voluum.

Note: The Ringba Number assigned to the Publisher must be present on the webpage, Ringba's Call Tracking Tag will automatically replace it with a number from a Number Pool.

Due to the requirements for Voluum and traffic sources like Facebook, Google, Bing, and Outbrain, you will need to append the ClickID value to the Offer page URL in Voluum.

Facebook Ads, Google Ads, Outbrain, and Bing campaigns in Voluum must be tracked with Direct Method. In this case, you can use your main page as Lander in Voluum and create a Wait Page with a simple JavaScript that will auto-click the button with the number, redirecting visitors to dial (and use that page as Offer in Voluum).

Install a Ringba Call Tracking Tag

To get started, you will need to add the Ringba Call Tracking Tag to your webpage's header in order to use Number Pools. To do this:

Navigate to the Campaign with your Publisher that you want to track with Voluum.
Click Install Call Tracking Tag from the Actions panel.
Copy and paste the code snippet into your web page header. It should look something like the example below:

Create a URL Parameter for ClickID and other data

With the Call Tracking Tag installed, Ringba will automatically catch the ClickID and other data that's included in the URL Parameters. This data is captured in reporting and stored in tags.

Please make sure that there is any parameter with {clickid} token added in your Offer URL, for example:

https://my.offer.com?clickid={clickid}

Our next step is to create a URL Parameter in Ringba to capture this value as a token and use it dynamically for Voluum's S2S Postback. Navigate to Integrations and select URL Parameters. Click Create URL Parameter and fill out the info below:

URL Parameter: clickid
Reporting Menu Name: User
Report Name: clickid

Note: Creating a new URL Parameter will automatically create a relevant dynamic token, [tag:User:clickid], which can be used later in Voluum S2S postbacks.

After you have created the URL Parameter, you will need to add it to the Campaign.

Go to the Campaign with our Publisher and Call Tracking Tag, scroll down to URL Parameters. Find the URL Parameter we created for ClickID and add it to the campaign.

You can add multiple custom parameters to your Voluum Offer URL and all of them will be captured by Ringba in Tags.

Here's an example of an Offer URL with additional parameters and Voluum dynamic tokens:

https://my_offer.com/?clickid={clickid}&trafficsource={trafficsource.name}&browser={browser}&country={country}&isp={isp}&user_agent={useragent}

Here's how that example Offer URL will be recorded in Ringba as Tags:

You can take this a step further by creating Ringba URL Parameters for them if you want to use these dynamically in the Voluum S2S Postback. Additionally, you can use this data for routing logic in the Ringba platform by applying Tag Routing Filters.

Create Ringba Pixels for Voluum S2S Postback Events

In Ringba, you can create mutliple Pixels for triggering events you want to track in Voluum. To create a Pixel in Ringba, navigate to Integrations > Pixels > Create Pixel.

Name your pixel and choose the event you want to fire the pixel on. Paste your Voluum S2S Postback into the URL Field and match the fields with the correct Ringba Tokens by clicking the Token button.

cid: ClickID
payout: conversion payout
txid: transaction ID
et: conversions type you want to record in Voluum (requires creating Custom conversions in Voluum)
param1-param5: any additional values you would like to record in Voluum

The token for ClickID can be found here as the URL Parameter we created in the previous step:

Tip: If you are unsure if a particular token is relevant for the call type you want to report, review this list of Most Common Tokens in Ringba.

Example of full Voluum S2S Postback with custom parameters:

https://voluum_tracking_domain/postback?cid=[tag:User:clickid]&payout=[Call:-ConversionAmount]&txid=[Call:InboundCallId]&param1=[tag:Campaign:Id]&param2=[tag:Geo:Country]&param3=[tag:Geo:ZipCode]&param4=[tag:Technology:OS]&param5=[tag:Geo:SubDivision]&et=incoming

Please note that the above S2S postback is just an example. Ringba supports many dynamic tokens. Please take your time to think it over and select those which will be the best choice for your requirements.

Passing Conversion Payout in Pixels

In Ringba, there are two token that can be used for the conversion payout:

[Call:ConversionPayout] - the payout a Publisher is credited for each conversion.
[Call:ConversionAmount] - the actual revenue of the conversion.

The payout= parameter can also be matched with the hardcoded value of the conversion, for example, payout=0.05. Then each postback-reported conversion will be recorded in Voluum with 0.05 revenue.

If you need to fire the S2S postback with the conversion revenue (Conversion Amount token), switch the Fire Pixel On field to Converted. Once the conversion event from Routing Plan is reached, S2S postback will be fired, reporting the Conversion revenue to Voluum:

In other scenarios, the S2S postback still will be fired, but the [Call:ConversionAmount] token won’t be replaced with the actual conversion revenue (in such a case, you can enter the required value manually with the payout= parameter).

Using Custom Conversion Events in Pixels with Tag Filters

Using Ringba's Advanced Options for your pixels gives you the ability to use custom conversion events by Tag Filters in your request.

When configuring a Ringba Pixel, click the toggle for Advanced Options and select GET for the HTTP Method:

Under Tag Filters, you can specify how and when the pixels should fired. For example, you could set a Tag Filter the pixel to only fire when the Call Length is greater than 60 seconds:

Voluum Integration Campaign Checklist

The Call Tracking Tag must be associated with the Publisher’s number.
Capture User Data toggle must be enabled.
You must have at least one Number Pool in Ringba to be able to select it when creating the Tag.
The URL Parameters and Tracking Pixels for the Voluum S2S Postback must be added to the Campaign.

With all the elements set up correctly, when a visitor clicks through your Voluum campaign funnel, Ringba’s Tracking Tag will capture the Voluum ClickID value from the Offer URL and save it in Ringba's Reporting. Once the call converts (or other action that triggers S2S postback happens), Voluum S2S postback will be fired, sending the conversion details to Voluum.

Advanced Method: Using Inbound Data Enrichment

If you use Facebook Ads, Google Ads, Outbrain, and Bing as Traffic Sources, and the additional page (wait page) is a no-go, you can use the Inbound Data Enrichment URL for tracking. The URL can be taken directly from the Publishers section in your Ringba campaign:

The Inbound Data Enrichment URL will look like this:

https://display.ringba.com/enrich/2092323682876655181?callerid=<<E.164-CALLER-NUMBER>>&key1=value1&key2=value2

The <<E.164-CALLER-NUMBER>> must be replaced with the caller’s number.
key1=value1 can be replaced with the ClickID parameter and the ClickID value.
key2=value2 can be replaced with any other parameter and value.

In this scenario, data must be pinged to Ringba before the call happens. You can use a simple JavaScript function to fire the URL:

<script>
function pushTag() {
var VLM = dtpCallback.getClickID();
(window._rgba_tags = (window._rgba_tags || [])).push({type: "user", clickid: VLM});}
pushTag();
</script>

Note: You must develop a way to push the caller number and the ClickID value to the relevant parameters in the URL. For Direct campaigns in Voluum (required for Facebook, Google Ads, Outbrain and Bing) with Offer only, the ClickID will not be appended to the Offer URL - it will be present in vl-cid cookie or in response to the Voluum Offer tracking script.

Tip: Learn more about Inbound Data Enrichment with Ringba.

FAQ, Troubleshooting, and Resources

What do I do if I need help integrating Voluum with Ringba?

If you need assistance with your integration, please reach out to the Voluum or Ringba team via support.