Facebook lets you push data about conversions that happened in Ringba into Facebook Ads using Facebook's Conversions API.

This article contains a step-by-step guide on how to set up and track your Ringba calls with Facebook Ads. This article discusses the Call-only ads integration version, which works when you have static numbers on your ads. If you are using number pool numbers in your ads, you must use the JS tag integration version. See Facebook Offline Events Integration - JS version.

Note: Facebook can change its integration requirements/aspects at any time, without notice, which could break your integration.

This article contains the following sections:

Requirements
Flow Overview
Setup Guide
FAQ and Troubleshooting

Requirements

Before you begin, you must have the following items:

A Facebook Business Manager account
Important: Currently Ringba has access to Business Managed Data only. Client-Managed Data on the Facebook Side is not available to Ringba.
A pixel set up on Facebook and added to the site you want to track

Flow Overview

The following steps describe the flow from Ringba side and Facebook side.

A Facebook user sees your static number published in an ad or in your website.
The Facebook user calls the static number.
Note: Since it's a static number, Ringba can't retrieve session data to attach to the call like we can when a number comes from a number pool.
Once the call is completed/converted, Ringba sends an event to Facebook Offline Events with the:
- phone number
- available data (like caller number State and Country)
Facebook receives the data and tries to match it with the user that saw the ad so it can appear in your Facebook analytics.
You use the insight you gain from your Facebook analytics to evaluate the success of your ads and optimize your ad approach.

Note: Since Ringba does not have much data to send to Facebook, Facebook's match rate for the events sent might be low. For a better match rate, try the Facebook Offline Events Integration - JS version.

Setup Guide

The following procedures cover the steps you need to complete in Facebook and Ringba to set up the integration.

Create a Facebook Pixel

Note: Follow these steps only if you haven’t created a Facebook pixel yet. If you already have a pixel to use, you can skip this step and proceed to the next section.

In your Facebook business account, go to Data Sources > Events Manager.
Click Connect Data Sources.
Select the Web option.
Next, Select the Facebook Pixel option.
Complete the form with the name of your pixel and website URL.
Click the Install code manually button under the Manually add pixel code to your website heading.
Copy the pixel code and install it in your website following Facebook's instructions. Then click Continue.
Toggle on the Automatic Advanced Matching switch. Toggle on the following options to get a better match rate:
- City, State, ZIP/Postal Code
- Country
- Phone Number.
Finally, verify that your Facebook pixel is linked to your ads. Use the image below as a reference:

Enable Your Facebook Pixel to Receive Conversions from Ringba

In your Facebook business account, go to your Events Manager page.
Select the pixel you want to use with Ringba and go to Settings.
Go to the Conversions API section of the settings and click the Generate access token link.
Important: This step is required for Facebook to enable server-to-server requests to the pixel.

Once you have generated an access Token, the pixel is ready to integrate on the Facebook side.

Integrate Ringba with Facebook Offline Events

In Ringba, navigate to Integrations > Platforms and click Add Platform Integration.
Select Facebook Events as the platform.
Click the AUTHORIZE button to authorize Ringba to allow access to your Facebook account.
Still in Ringba, navigate to the Campaigns and open the campaign where you want to use the integration.
Scroll to the Platform Integration section and click the Add Integration button:
Complete these fields:
- Integrate using: Select the Number option.
- Phone Number: Select the number to use.
- Integration: Select the integration you created earlier in this procedure.
- Pixel ID: Select the Facebook pixels you created earlier in this procedure.
- Conversion Upload Event: Choose whether you want to upload the data to Facebook on Conversion or on Payout.
- Conversion Upload Delay: Enter the number of minutes to wait after the Upload Event before attempting to upload data to Facebook.
  Note: Usually you should leave this as the default value of 5 minutes. Facebook is not ready to accept conversion data immediately, and if you try to upload the data before Facebook is ready, the upload fails.

Create a Custom Conversion in Facebook for Ad Optimization

For this, you first must have some instances of the event to send to Facebook. Otherwise Facebook won’t let you complete the setup.

First, connect Ringba with Facebook and let Ringba send conversions back to Facebook. Once that’s done and you can see those conversions on the pixel panel like the image below, you can proceed setting up the custom conversion using the Custom Event.

Note: Please note that Facebook takes around an hour to process the events sent to them.

In your Facebook business account, go to your Custom Conversions page.
Click Create Custom Conversion.
Complete the fields and choose the conversion event you set up in your test of the Conversion API. If you want to override the configured conversion trigger, you can use the call duration and Ringba Conversion/Payout value to define the custom conversion trigger rules.
Once you have configured your custom conversion, go to your business ad account by clicking Go to Settings so you can link the conversion to your ad account.
Next, go to Connected Assets.
Finally, connect the conversion to your ad account.