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 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 Facebook JS tag integration version, which requires you to use a number pool. For information on the integration for static numbers only/call only ads, see this article: Facebook Offline Events Integration - Call-Only 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. 

This article contains the following sections:

Requirements

Before you get started, you must have the following items:

  • A Facebook Business Manager account
  • A Ringba number pool running on the landing page where you want to track calls 
  • A Meta Pixel set up and added to the site you want to track, alongside the Ringba number pool replacement script

Flow Overview

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

  • A Facebook user sees your ad on Facebook.
  • The Facebook user clicks the ad and visits your landing page, which includes Ringba's number pool code and Facebook's Meta Pixel code.
  • The Meta Pixel tracks the activity on the website; meanwhile, Ringba tracks the activity using the number pool code.
  • The user calls the number on the landing page.
  • Ringba handles the call and gets the user data 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 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 optimize your ads.

Setup Guide

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

Create a Meta Pixel

You need a Meta pixel to complete the integration. You complete the steps for this procedure entirely in Meta Business Suite. See Set up and install the Meta Pixel for step-by-step instructions. 

If you already have a Meta Pixel you want to use, you can skip this and continue to the next procedure.

Enable Your Meta Pixel to Receive Conversions from Ringba

  1. In your Meta Business Suite account, go to Events Manager. 
    Tip: You may need to click All tools to see the Events Manager option.
    fb_all_tools_nav.png
    fb_events_manager_nav.png
    The Events Manager Overview screen appears.
  2. Click the Connect Data option.
    fb_events_mngr_connect_data.png
    The Connect a new data source wizard appears.
  3. Select the Offline option and click Next.
    fb_connect_data_source.png
    The Connect your data step appears.
  4. Select your Facebook pixel from the Dataset drop-down and click Next.
    Tip: You can click Create new dataset here to create a Facebook pixel.
    fb_connect_your_data.png
    The Select a setup step appears.
  5. Choose Do it yourself and click Next.
    fb_select_setup.png
    The Choose how to connect your website step appears.
  6. Select Conversions API and Meta Pixel (Recommended) and click Next.
    fb_connect_your_website.png
    The Set up Conversions API to connect website activity step appears.
  7. Select the Set up manually option and click Next. 
    fb_set_up_conversion_api.png
    The Connect activity with Conversions API wizard appears, open to the Overview step. Click Continue to pass through this step and proceed to the Select Events step.
  8. Select Ecommerce and retail from the drop-down and select the check box next to Purchase. Click Continue.
    fb_select_events.png
    The Select Event Details step appears.
  9. Select the check boxes next to each piece of information you want to send for this event. Click Continue.
    fb_select_event_details.png
    The Review Setup window appears.
  10. Review your choices and click Continue. 
    fb_review_setup.png
    The See Instructions step appears.
  11. Click the Open implementation guide link to download the instructions to your browser's downloads folder. Click Continue. 
    fb_see_instructions.png
    The Using the Conversion API wizard appears, open to the Getting Started step. Click Get Started and the wizard scrolls down to the Explore Integration step. 
    fb_using_conv_api_wiz_get_started.png
  12. Scroll to the Generate Access Token step and click Generate Access Token. Scroll through the rest of the tutorial and complete any needed information. At the bottom, click Finish.

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. Click AUTHORIZE and complete the steps to authorize Ringba to access your Facebook account.

    You have created an integration that you can add to a campaign.
  4. Still in Ringba, navigate to Campaigns and open the campaign where you want to add the integration.
  5. Scroll to the Platform Integrations section and click the Add Integration button. Fields appear to configure the integration.
    campaign_platform_integraion.png
    Complete these fields:
    • Integrate using: Select the JS Tag option.
    • JS Tag: Select the JS tag you want to use to track conversions.
    • 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.

FAQ and Resources

Do I need a separate Ringba campaign for each Facebook integration?

No, you can have multiple Facebook integrations within the same campaign. While each number pool you set up must be connected to a separate landing page, you can have multiple Facebook integrations (as well as other integrations, like Google Ads) within the same campaign.

How can I learn more about the Ringba features I'm using?

To learn more about the Ringba features you use in this process, use the following resources:

Where can I get more information about the Facebook features?

To learn more about the Facebook features you use in this process, use the following resources:

What should I do if I need help with my integration?

If you have any questions or need additional help, please reach out to our support team via chat or email at support@ringba.com.

Related articles