Skip to content

Commit 9df1341

Browse files
kdaswanimarkzegarelli
andauthored
FB CAPI (Actions) updates for Public Beta (#2276)
* FB CAPI (Actions) updates for Public Beta * add to strat Co-authored-by: markzegarelli <[email protected]>
1 parent 9784c9e commit 9df1341

File tree

2 files changed

+17
-24
lines changed
  • src
    • _data/sidenav
    • connections/destinations/catalog/actions-facebook-conversions-api

2 files changed

+17
-24
lines changed

src/_data/sidenav/strat.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,9 @@ sections:
2929
- path: /connections/destinations/catalog/facebook-pixel
3030
title: Facebook Pixel destination
3131
- path: /connections/destinations/catalog/facebook-pixel-server-side
32-
title: Facebook Conversions API Destination (Beta)
32+
title: Facebook Conversions API Destination (Classic)
33+
- path: /connections/destinations/catalog/actions-facebook-conversions-api
34+
title: Facebook Conversions API Destination (Actions)
3335
- path: /connections/destinations/catalog/facebook-app-events
3436
title: Facebook App Events destination
3537
- path: /connections/destinations/catalog/facebook-offline-conversions

src/connections/destinations/catalog/actions-facebook-conversions-api/index.md

Lines changed: 14 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Facebook Conversions API (Actions)
3-
hidden: true
3+
strat: facebook
44
hide-boilerplate: true
55
hide-dossier: true
66
---
@@ -18,6 +18,7 @@ Facebook Conversions API (Actions) enables advertisers to send events from their
1818
The Facebook Conversions API (Actions) destination provides the following benefits over the classic Facebook Conversions API destination:
1919
- **Fewer settings**. Data mapping for actions-based destinations happens during configuration, which eliminates the need for most settings.
2020
- **Clearer mapping of data**. Actions-based destinations enable you to define the mapping between the data Segment receives from your source, and the data Segment sends to Facebook Conversions API.
21+
- **Prebuilt mappings**. Mappings for standard Facebook Conversions API events, like `Purchase`, are prebuilt with the prescribed parameters and available for customization.
2122
- **Support for page calls**. Page calls can be sent to Facebook as a standard Page View.
2223
- **Support for identify calls**. Identify calls can be sent to Facebook as a standard or custom event.
2324
- **Support for multi-product arrays**. Product data nested within arrays, like the `products` array in the [Order Completed](/docs/connections/spec/ecommerce/v2/#order-completed) event, can be sent to Facebook.
@@ -43,20 +44,20 @@ Set up your Pixel to work with the Facebook Conversions API (Actions) destinatio
4344
3. Choose “Segment” from the list of partners.
4445
4. Enable the setting to “Authorize Segment Connection” and then click **Continue**.
4546

46-
### Set up in Segment
47+
### Connect Facebook Conversions API (Actions) to your workspace
4748

48-
The Facebook Conversions API (Actions) destination is in Private Beta, and does not appear in the Destinations Catalog.
49-
50-
1. To access the destination, navigate to this URL: `https://app.segment.com/<workspace_slug>/destinations/catalog/actions-facebook-conversions-api`. Replace `<workspace_slug>` with your workspace slug.
51-
2. Click **Configure Facebook Conversions API (Actions)** in the top-right corner of the screen.
52-
3. Choose which of your sources to connect the destination to. (You can connect more sources to the destination later.)
53-
4. Click **Configure Actions** and follow the set up steps to **Create Destination**.
54-
5. On the Settings tab, enter in your Pixel ID and click **Save**.
49+
1. From the Segment web app, click **Catalog**, then click **Destinations**.
50+
2. Search for “Facebook Conversions API (Actions)” in the Destinations Catalog, and select the destination.
51+
3. Click **Configure Facebook Conversions API (Actions)** in the top-right corner of the screen.
52+
4. Select the source that will send data to Facebook Conversions API and follow the steps to name your destination.
53+
5. On the **Settings** tab, enter in your Pixel ID and click **Save**.
5554
6. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
5655

57-
## Configuration options
56+
{% include components/actions-fields.html %}
5857

5958

59+
## Configuration options
60+
6061
The Facebook Conversions API (Actions) destination gives you several ways to implement your conversion tracking. You can use it with [Facebook Pixel](/docs/connections/destinations/catalog/facebook-pixel/), or as a stand-alone alternative. You can read more about implementation options below and in [Facebook documentation](https://developers.facebook.com/docs/marketing-api/conversions-api/guides/end-to-end-implementation#pick-your-integration-type){:target="_blank"}.
6162

6263

@@ -72,7 +73,7 @@ With the Facebook Conversions API (Actions) destination, you can choose any fiel
7273

7374
![the coalesce function](images/image1.png)
7475

75-
You can send additional User Data to increase the match rate for events from a server source. Collect other fields from the browser, like User Agent, IP Address, and [Facebook's cookie parameters (fbp, fbc)](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc){:target="_blank"}, pass them to the server, and map them in the User Data object.
76+
You can send additional User Data to increase the match rate for events from a server source. Collect other fields from the browser, like User Agent, IP Address, and [Facebook's cookie parameters (fbp, fbc)](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc){:target="_blank"}, pass them to the server, and map them in the User Data object. See [Facebook's Customer Information Parameters](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/customer-information-parameters) for more information on User Data fields.
7677

7778
![the user data object](images/image2.png)
7879

@@ -96,7 +97,7 @@ With the Facebook Conversions API (Actions) destination, you can choose any fiel
9697

9798
![the coalesce function](images/image1.png)
9899

99-
You can send additional User Data to increase the match rate for events from a server source. Collect other fields from the browser, like User Agent, IP Address, and [Facebook's cookie parameters (fbp, fbc)](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc){:target="_blank"}, pass them to the server, and map them in the User Data object.
100+
You can send additional User Data to increase the match rate for events from a server source. Collect other fields from the browser, like User Agent, IP Address, and [Facebook's cookie parameters (fbp, fbc)](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc){:target="_blank"}, pass them to the server, and map them in the User Data object. See [Facebook's Customer Information Parameters](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/customer-information-parameters) for more information on User Data fields.
100101

101102
![the user data object](images/image2.png)
102103

@@ -118,17 +119,6 @@ You can send additional User Data to increase the match rate for events from a s
118119

119120
If you choose this option, each source sends different events, and deduplication is not necessary.
120121

121-
## Available Facebook Conversions API actions
122-
123-
Combine the supported [triggers](/docs/connections/destinations/actions/#components-of-a-destination-action) with the following Facebook Conversions API-supported actions:
124-
125-
* Page View
126-
* Search
127-
* View Content
128-
* Add to Cart
129-
* Initiate Checkout
130-
* Purchase
131-
* Custom Event
132122

133123
## Verify Events in Facebook
134124

@@ -137,3 +127,4 @@ After you start sending events, you should start seeing them in twenty minutes.
137127
1. Go to the Events Manager.
138128
2. Click on the corresponding pixel.
139129
3. In the Overview tab, look for events where the “Connection Method” is Server.
130+

0 commit comments

Comments
 (0)