Facebook Conversions API

With the Facebook Conversions API, you can gauge the impact of your advertisements across Meta technologies on real-world outcomes. Compare the offline conversions, such as in-store purchases, phone orders, bookings, and so on, with the audiences who viewed or interacted with your ads. This analysis will provide insights into the effectiveness of your advertising campaigns.

You can utilize offline conversions to extend your reach to offline audiences and display ads based on their offline actions. Additionally, you can leverage Lookalike Audiences to target individuals across Meta technologies who share similarities with your offline customer base.

Setup overview

Here are the steps involved in setting up integration with Blueshift and sending offline conversion data to Facebook from a campaign:

1. Complete the prerequisites.
2. Configure the Facebook offline conversions app in Blueshift to set up integration.
3. Configure the payload by setting up a template.
4. Set up a campaign journey and add a Facebook offline conversions trigger.
5. Launch your campaign.

Prerequisites

Before you can set up integration with Blueshift, you must have your Meta account set up.

Blueshift uses the Meta's Conversion API to create a connection to Meta systems that optimize ad targeting, decrease cost per result and measure outcomes. Follow the instructions in the Conversion API Getting started documentation to obtain the following information required for the integration with Blueshift.

• The Pixel ID
• The Access Token

Set up integration

To add a Facebook offline conversions adapter in Blueshift, complete the following steps:

1. Sign in to the Blueshift app, and click App Hub in the left navigation menu.
2. Go to All Apps, search for, and select Facebook offline conversions.
3. You can also go to Advertising Apps and select Facebook offline conversions.
4. Click Configure to view all the configured adapters.
5. Click +ADAPTER to add an adapter.
    

   

6. Add a Name for the adapter.  If you have multiple adapters, the adapter name helps you to identify the integration.
7. Add the Pixel ID and the Access Token that you obtained from Facebook.
8. Click Save to add the adapter.

   The adapter is now added and you can use it in your Cloud App template. 

Quick start templates

When you create an adapter in the App Hub, the following quick start template is added to the Cloud App templates.

• Send a Facebook Offline Conversion event

Consider the following points about quick start templates:

• You can find these in the following location: Templates > Cloud App
• Quick start templates are identified by the label "QUICK START".
• A quick start template is added only when you create the first adapter for the app in App Hub. If you have multiple adapters for an app, you can edit the Adapter details on the template Properties tab to select the required adapter.
• You can use this template as-is in your campaigns. You cannot make any changes to the schema for a quick start template.
• If you need to change the schema, you can clone the template and then edit the schema as required.

Add a Facebook offline conversions cloud app template

A Cloud App template is required to send a payload using the Facebook Conversions API from a campaign. You can include personalizations and recommendations in the template content. For more information, see Cloud Apps templates.

To use a quick start template or to add a Facebook offline conversions Cloud App template, complete the following steps:

1. Go to Templates > Cloud App.
2. Complete one of the following actions:
   • Select the Send a Facebook Offline Conversion event quick start template for Facebook oflline conversions from the list of templates.
   • To create a clone of the quick start template, go to the action menu for the template and click Clone.
   • To create a new template, click +TEMPLATES on the Cloud App Templates page. Select the Facebook Offline Conversions app.

     Note: Only apps that support Cloud Apps templates and have atleast one adapter configured are displayed on the Cloud App Templates page.

3. Go to the Properties tab.
4. Specify a name for the template to identify it on the index screen.
5. Select the adapter to use to send the payload.
6. The API endpoint is added by default to the quick start template. If you have added a new template, copy the API endpoint from the quick start template and use it.
7. In the Advanced Settings section, select the HTTP Method as POST. This is selected by default in the quick start template.
8. Add tags and other relevant information.
    

   

9. Go to the Content tab.
10. If you are using a cloned quick start template or a new template, go to the Schema tab and configure the schema for the form.
11. Go to the Content Form tab and fill the form to specify the data to send to Facebook offline conversions. You can use Liquid for personalization in these fields. 

    

12. In the preview tab, you can also switch to JSON and view the content in JSON format.
13. The quick start template uses attributes from an event in the content and the purchase event is added by default as the Sample event on the Data tab > Preview Data section.
14. In the Show Data section, go to the bsft_event_context object. This contains the event specific data that you can use in your template.
15. Save the template.

Next steps

In your campaign journey, add a Facebook offline conversions trigger. Select the template that you created.