Skip to main content

Voluum Integration

Amanda Cross
Updated

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.

This article contains the following sections:

Integration Flow Overview

The following steps represent the integration flow at a high level:

  • A visitor clicks through your Voluum campaign funnel.
  • Ringba’s tracking tag captures the Voluum ClickID value from the Offer URL.
  • The visitor's call connects through Ringba.
  • The call converts (or another action happens to trigger S2S postback).
  • Voluum S2S postback fires, sending the conversion details to Voluum.
  • The ClickID, along with other call information, is available for you to review in Ringba's Reporting. 

Requirements

Before you start the procedures in this article, you must meet the following requirements:

  • Set up a Ringba number pool
  • Set up a Ringba campaign with:
  • Set up a landing page (lander) with a click-to-call action and the ability to add custom scripts. You use this landing page as an Offer in Voluum. The publisher's tracking number must appear on the landing page so it can be replaced by the call tracking tag you add in the next section. 
  • Configure Voluum to append the Click ID value to the Offer page URL, which is required by traffic sources like Facebook, Google, Bing, and Outbrain.
  • Set up your Facebook Ads, Google Ads, Outbrain, and Bing campaigns in Voluum to 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).
    Note: If you cannot use a Wait Page for any reason, see Voluum Integration Using Inbound Data Enrichment for an alternative integration technique.

Install a Ringba Call Tracking Tag

Ringba's number pools feature lets you attribute call conversion information to a web browsing session. You install a small JavaScript snippet called a call-tracking tag in your landing page. The snippet replaces the default phone number with a different number for each visitor. Giving each browsing session a different phone number makes it possible to associate a session with a call and its conversion data. 

To get started, add the Ringba call tracking tag to your webpage's header:

  1. Open the campaign that is attached to the publisher you want to track with Voluum and scroll down to the Call Tracking Tags section.
    publishers_call_tracking_tags.png
  2. Click the <> icon in the Actions column to open the Install Call Tracking Tag window.
    install_call_tracking_tag_window.png
  3. Copy and paste the code snippet into your web page header. It should look something like the example below:
    snippet_in_head.png

Create URL Parameters for ClickID and Other Data

Once you install the call tracking tag, Ringba automatically captures the ClickID and other data and sends it to your Ringba account as URL Parameters. It adds the data to the call as tags, which you can review on the Tags tab when you expand a call in the Call Details section of the Reporting screen. 

click_id_tag.png

Make sure your Voluum Offer URL includes a parameter with to contain the {clickid} token. For example:

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

To include the data from Ringba's reporting tag in Voluum's S2S postback, you must create a URL parameter in Ringba. Navigate to Integrations > URL Parameters. 

url_parameter.png

Click the Create URL Parameter button and complete the fields as follows:

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

Note: Creating the URL parameter automatically creates the corresponding dynamic token: [tag:User:clickid]. You use this token later when you Create Ringba Pixels for Voluum S2S Postback Events later in this article.

After you create the URL parameter, you must add it to the campaign.

Return to the campaign and scroll to the URL Parameters section. Find the clickid URL parameter you just created and add it to the campaign.

voluum_url-parameters-3_mvbcnx.png

You can add other custom parameters to your Voluum Offer URL and all of them will be captured by Ringba as reporting tags.

Example Offer URL

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:

other_tags.png

You can take this a step further by creating Ringba URL parameters for the tag values if you want to use them dynamically in the Voluum S2S Postback or if you want to use the data to help route the calls using tag routing filters.

Create Ringba Pixels for Voluum S2S Postback Events

Ringba's pixel feature lets you send information from Ringba to another platform or service. Each pixel has a triggering event that initiates the sending of the data. You can create multiple pixels for triggering events you want to track in Voluum. 

To create a pixel, in Ringba navigate to Integrations > Pixels and then click the Create Pixel button.

voluum_pixels-1_1eofwbv.png

Name your pixel and choose the event you want to trigger the pixel in the Fire Pixel On field. Paste your Voluum S2S Postback into the URL field and match the fields with the correct Ringba tokens by clicking the Token button.

voluum_pixels-2_1xxudm.png

  • 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

You can find the token for ClickID here. It is the URL Parameter from earlier in this procedure:

voluum_pixels-3_b7kauy.png

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

Example 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

Note: This S2S postback is just an example. Ringba supports many dynamic tokens you can use. Consider carefully which tokens to include to achieve your goals.

Passing Conversion Payout in Pixels

Ringba offers two tokens you can use for the conversion payout:

  • [Call:ConversionPayout]: The payout a publisher is credited for each conversion
  • [Call:ConversionAmount]: The actual revenue of the conversion

Another approach is to match the payout= parameter with a hardcoded conversion value. For example, if payout=0.05, then Voluum records each postback-reported conversion with 0.05 revenue.

If you need to fire the S2S postback with the conversion revenue (Conversion Amount token), change the value of the Fire Pixel On field to Converted. Once the conversion event occurs, the S2S postback pixel fires and reports the conversion revenue to Voluum:

voluum_passing-conversion-payout_kz0b3o.png

If you don't include the conversion payout, the S2S postback pixel still fires, but the [Call:ConversionAmount] token is not replaced with the actual conversion revenue. In this 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 lets you set up custom conversion events using tag filters.

To use the advanced options, navigate to Integrations > Pixels and create a pixel or open an existing pixel. Toggle on the Advanced Options switch. 

In this exercise, select GET as the HTTP Method:

voluum_custom-conversion-events-1_1df18u4.png

Click the Add Filter button under Tag Filters heading to show the fields to build a tag filter. You can specify how and when the system should fire the pixel. For example, you could set a Tag Filter so the pixel only fires when the Call Length is greater than 60 seconds:

voluum_custom-conversion-events-2_985ce5.png

Voluum Integration FAQ

Is there another way to integrate Ringba and Voluum?

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. See Voluum Integration Using Inbound Data Enrichment.

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.

Related articles