Skip to main content

Facebook Offline Events Integration - JS version

Amanda Cross
Updated

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

This article contains a step-by-step guide on how to set up and track your Ringba calls with FB Ads.

Note: Facebook can change the integration requirements/aspects without notice. As such, this article no longer contains information about creating a custom conversion because Facebook ended support for that capability. Also this article only covers Facebook JS tag integration version. For information on the integration for static numbers only/call only ads, see this article Facebook Offline Events Integration - Call-Only Ads.

This article discusses the following setup steps you must complete to enable the integration:

  • Setting up your Ringba Number Pool and adding the script to your site.
  • Setting up the Facebook Pixel, adding the tracking script to your site, and connecting it to your campaign or ad.
  • Setting up the integration on Ringba to send the data.
  • Creating the Conversion on Facebook.

Requirements

Before you get started, you must have a Facebook Business Manager account, and you need a Ringba number pool running on the landing page you want to track calls from.

You need a pixel set up on Facebook and added to the site you want to track, alongside the number pool replacement script.

Example Flow

This is a brief description of the whole flow from Ringba side and Facebook side:

  • A user sees your ad in Facebook.
  • The user clicks the ad and visit your website/landing page with Ringba's number pool code and Facebook pixel code.
  • The Facebook pixel tracks the activity on the website; meanwhile, Ringba tracks the activity using the number pool code.
  • The user calls the number on the website/landing page.
  • Ringba handles the call and gets the data from caller using the number pool. Ringba also sends an event to Facebook Offline Events once the call is completed/converted.
  • Facebook receives the data and tries to match it with an user that saw the ad.
  • Once Facebook accepts the data, you can use it to optimize your ad.

Setup Guide

Create a Facebook Pixel

Note: Follow these steps on the Pixel section only if you haven’t created a pixel yet. If you already have the pixel you want to use, please proceed to the next section.

  1. In your Facebook business account, go to Data Sources > Events Manager.
  2. Click Connect Data Sources.
  3. Select the Web option.
  4. Next, select the Facebook Pixel option.
  5. Complete the form with the name of your pixel and website URL.
  6. Choose Manually add pixel code to your website.
  7. Copy the pixel code and install it in your website following Facebook's Instructions. Then, click Continue.
  8. Turn on Automatic Advanced Matching with the following options to get a better match rate: City, State, ZIP/Postal Code, Country, and Phone Number.
  9. 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

  1. In your Facebook business account, go to your Events Manager page.
  2. Select the pixel you want to use with Ringba and go to settings.
  3. Go to the Conversions API section of the settings and click Generate Access Token. This is required for Facebook to enable server-to-server requests to the pixel.

  4. Once you have generated an Access Token, the pixel is ready to integrate on the Facebook side. Now you can proceed to the next section to enable the integration in Ringba.

     

Integrate Ringba with Facebook Offline Events

  1. In Ringba, go to Integrations > Platforms and click Add Platform Integration.
  2. Select Facebook Events as the platform.
  3. Next, you will need to authorize Ringba to allow access to your Facebook account.
  4. Go to your Ringba campaign, click Add Integration and select JS Tag. Select the pool you will be using on your website, the integration platform you just created, and link the pixel. You will see a drop-down selection with the Pixels options that you have on Facebook side so you can select the one that you will use for this integration.

FAQ and Troubleshooting

If you still have questions about Facebook pixels set up please contact our chat support team to get personalized support from Ringba engineers.

To learn more about the mentioned features, use the following resources:

Ringba Documentation:

Facebook Documentation:

  • Conversions API: https://developers.facebook.com/docs/marketing-api/conversions-api/
  • Payload Helper: https://developers.facebook.com/docs/marketing-api/conversions-api/payload-helper

Related articles