Skip to content

Commit 102c2c3

Browse files
authored
Merge pull request #1997 from segmentio/update-fb-conversions-docs
FB conversions API docs updates
2 parents c797d74 + 05e142f commit 102c2c3

File tree

1 file changed

+9
-10
lines changed
  • src/connections/destinations/catalog/facebook-pixel-server-side

1 file changed

+9
-10
lines changed

src/connections/destinations/catalog/facebook-pixel-server-side/index.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -76,8 +76,7 @@ This approach provides a redundancy that ensures maximum signal reliability. Eve
7676

7777
#### Match rate considerations
7878

79-
For this option to work best, you must pass the same `external_id` from both the browser and the server sources.
80-
To do this, go to your Facebook Pixel destination settings in Segment, and enable **Use UserId or Anonymous Id as External Id**. By default the Facebook Conversions API destination uses the `userId` (or `anonymousId` if not present) to set the External Id, so when you set up Facebook Pixel to use the same settings, Facebook can then match the users.
79+
For this option to work best, the same `external_id` needs to be passed from the browser and the server. To achieve this, go to your Facebook Pixel destination settings in Segment and enable the **Enable Advanced Matching** and **Use User ID or Anonymous ID as External ID** settings. By default the Facebook Conversions API destination uses the `userId` (or `anonymousId` if not present) to set the `external_id`, so when you set up Facebook Pixel to use the same settings, Facebook can then match the users.
8180

8281
You can also increase the match rate for events from a server source by sending [user traits in the context object of the track events](#default-mappings-to-facebook-properties). You can also collect other fields from the browser, such as `userAgent`, `ip` address, and [Facebook's parameters (fbp, fbc)](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc) and pass them to the server, and manually add them to the events.
8382

@@ -91,7 +90,7 @@ Use this approach if you want to separate tracking events completed on a user's
9190

9291
#### Match rate considerations
9392

94-
For this option to work best, the same `external_id` needs to be passed from the browser and from the server. To easily achieve this go to your Segment destination settings for Facebook Pixel and toggle on the setting called **Use UserId or Anonymous Id as External Id**. The Facebook Conversions API destination uses the userId (or anonymousId if not present) to set the External Id by default. Therefore enabling this on Facebook Pixel will allow Facebook to match the users.
93+
For this option to work best, the same `external_id` needs to be passed from the browser and the server. To achieve this, go to your Facebook Pixel destination settings in Segment and enable the **Enable Advanced Matching** and **Use User ID or Anonymous ID as External ID** settings. By default the Facebook Conversions API destination uses the `userId` (or `anonymousId` if not present) to set the `external_id`, so when you set up Facebook Pixel to use the same settings, Facebook can then match the users.
9594

9695
You can also increase the match rate for events from a server source by sending [user traits in the context object of the track events](#default-mappings-to-facebook-properties). You can also collect other fields from the browser, such as `userAgent`, `ip` address, and [Facebook's parameters (fbp, fbc)](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc) and pass them to the server, and manually add them to the events.
9796

@@ -265,18 +264,18 @@ analytics.track("Clicked Email", {
265264
```
266265

267266
### Custom Mappings to Facebook Properties
268-
Any properties you send that aren't listed above are sent in the 'Custom Data' part of the Segment payload to Facebook.
267+
Any properties you send that aren't listed above are sent in the `custom_data` part of the Segment payload to Facebook.
269268

270269
### Alternative External IDs
271270

272-
By default, Segment sends the `userID` as `externalID`, and if `userID` is absent falls back to `anonymousID`. To use a different field in your payload as the External ID, use the "Alternative External ID Field". An example value for this setting would be `properties.externalId`.
271+
By default, Segment sends the `userId` as `external_id`, and if `userId` is absent falls back to `anonymousId`. To use a different field in your payload as the `external_id`, use the **Alternative External ID Field** setting. An example value for this setting would be `properties.externalId`.
273272

274-
### Alternative "Value" Properties
273+
### Alternative Value Properties
275274

276275
For most events Segment sends revenue for the Pixel value field, but for
277-
the pre-purchase events "Product Viewed" and "Product Added", Segment
278-
uses the value of the "Value Field Identifier" setting to determine which
279-
property to use for the "value" field. This field defaults to
276+
the pre-purchase events `Product Viewed` and `Product Added`, Segment
277+
uses the value of the **Value Field Identifier** setting to determine which
278+
property to use for the `value` field. This field defaults to
280279
`price`.
281280

282281
## Limited Data Use
@@ -313,7 +312,7 @@ minutes. You can confirm that Facebook received them:
313312

314313
1. Go to the Events Manager.
315314
2. Click on the corresponding pixel.
316-
3. In the **Overview** tab, look for events where the "Connection Mode" is `Server`.
315+
3. In the **Overview** tab, look for events where the "Connection Method" is `Server`.
317316

318317
> info ""
319318
> **Note**: It might take a few minutes before events appear in the Events Manager.

0 commit comments

Comments
 (0)