Ringba SIP IP Whitelisting

To work with our SIP servers, please whitelist the following IP Addresses on your system:

52.8.204.190
52.8.220.135
52.9.121.155
52.8.45.238
107.20.251.237
107.20.176.37
184.169.138.133
54.215.5.82.

Webhooks

Webhooks are endpoints that allow you to send data back to Ringba for performance based routing and enhanced reporting. After generating a webhook, you can pass Ringba back data using the Call Token assigned to every call routed from our system with SIP.

Ringba passes a unique token in every SIP header that you can capture and send back via your webhook to pass revenue data into our reporting.

There are 3 options for your webhook that have to be configured.

  1. “Call Token” is the variable where the webhook accepts the unique identifier for the call being reported.
  2. “Revenue Token” is the variable for passing in the revenue generated from this call.
  3. “Fire Pixels” when included in the webhook will cause Ringba to fire the pixels associated with the call being reported.

Example Webhook:
https://webhooks.ringba.com/WHcd9076b39bef422a8b0510c1fadd1a4d/conversion?callid=[callUUID]&revenue=[conversionAmount]&fire=true

When configuring the webhook in your system, make sure to replace the variables in [brackets] with the dynamic information you would like to pass back into our reporting.

  • Call Token: “callid” = [callUUID] – Unique call ID
  • Revenue Token : “revenue” = [conversionAmount] – The revenue generated from the call.
  • Fire Pixels: “fire=true” – The configured conversion flag.

Pixels

If you would like to send information to another platform or service, you will want to add a conversion pixel that gets triggered when a call becomes a qualified conversion. Ringba will “fire” the pixel and pass whatever information you need into the third party by activating your pixel URL and dynamically inserting whatever data you choose.

Note: Ringba supports both http and https postback pixels.

There 3 options where configuring your pixels:

 

1. “Fire On” is the event that will cause the pixel to trigger.

Answered – Fire when a call is answered by a target.
Incoming – Fire immediately when a user dials your number.
Completed – Fire when a call is completed and the caller hangs up.
Converted – Fire when a call has converted.

 

2. “Base URL” is the static URL portion of your pixel without a ‘?’.

Correct Example:
http://www.website.com/pixel/

Incorrect Example:
http://www.website.com/pixel/?

 

3. “URL Tag” is the URL string or variable name that you want data passed to.

Example:  In the following URL “keyword” is a URL Tag:
http://www.website.com/?keyword=searched

Integrations Overview

Ringba is built to work with any third party software or other tracking platforms to seamlessly integrate into your workflows.

 

Pixels

Using postback pixels you are able to send conversion data to your publishers, partners, any tracking platform or marketing software by configuring your Ringba campaigns to utilize our easy to manage pixels. Pixels can be configured by event, publisher or campaign.

For more information, follow our Pixel Integration Guide.

 

Webhooks

Webhooks allow you to pass performance data back into Ringba after a sale or conversion event happens. By passing sale data into our system you can better optimize your call flows and route calls based on performance.

For more information, follow our Webhook Integration Guide.

 

Landing Pages / Websites

Dynamic number pools are designed to track specific information about users that can be used to optimize your campaigns for increased return on investment. This type of integration involves adding Ringba JavaScript code onto your landing pages and websites to give Ringba control over which users see what numbers.

For more information, follow our Basic JavaScript Integration Guide or our Advanced JavaScript Integration Guide.

Basic JS Integration

Ringba JavaScript Tags are for dynamic number insertion into your websites and landing page. These tags allow Ringba to track and aggregate information about your users and organize it for reporting.

The most important part of your configuration is making sure you have the correct campaign ID in your script tag. If you copy your implementation code out of your campaigns view, it will automatically be populated with the correct campaign ID. Otherwise, you can retrieve the correct ID for your campaign from the ‘View Campaigns’ menu, or by viewing the settings of any campaign.

Campaign IDs follow the same format:

Simple Integration

The easiest way to integrate the Ringba tracking code is to put the following script in the current location of your on-page phone number. Simply drop the script tag into your page where you’d like your phone number to appear, and style it using the existing HTML code.

For example, if your current HTML looks like:

Your new HTML would like:

h3>JQuery Integration

If the majority of your users use new browser technology, the jQuery implementation is most likely the best choice for your campaign.

To get started you will want to configure your website or landing page to have a specific class associated with the div, span, or other object where you want your phone number inserted. You can apply whatever CSS you prefer to the HTML class you would like to use so your phone numbers match the look and feel of your site.

For this example we will be using the class ‘phone-number‘ to identify the tags we’d like our number inserted into and will begin by implementing the correct HTML.

Now that we’ve configured the HTML object’s we’d like our phone numbers inserted into, we need to place the jQuery and Ringba JavaScript tags in your HTML.

Full Compatibility Integration

In many countries people are still using outdated technology and older versions of windows. In this example we use a backwards compatible implementation that will loop through and replace your numbers.

This implementation is designed for traffic that has high numbers of older versions of windows and browsers like Windows XP, Windows Vista, IE7, and IE8.

To get started you will want to configure your website or landing page to have a specific class associated with the div, span, or other object where you want your phone number inserted. You can apply whatever CSS you prefer to the HTML class you would like to use so your phone numbers match the look and feel of your site.

For this example we will be using the class ‘phone-number’ to identify the tags we’d like our number inserted into and will begin by implementing the correct HTML.

Now that we’ve configured the HTML object’s we’d like our phone numbers inserted into, we need to place the Ringba JavaScript tags.

It is important to note that the Ringba tag must be placed below 100% of your content that will receive inserted numbers or this code will not function properly.

 

Request Information

Find out how Ringba can help scale your campaigns and save you money on call fees.

  Chat with a Live Sales Expert
Request Demo Free Trial Request Information