Skip to content

Commit 893088f

Browse files
bobbyatsegmentmarkzegarelli
andauthored
Add section highlighting User Data parameter mappings to Facebook Conversions API Destination (#4025)
* Update index.md * Update src/connections/destinations/catalog/actions-facebook-conversions-api/index.md Co-authored-by: markzegarelli <[email protected]> Co-authored-by: markzegarelli <[email protected]>
1 parent 59a7065 commit 893088f

File tree

1 file changed

+18
-0
lines changed
  • src/connections/destinations/catalog/actions-facebook-conversions-api

1 file changed

+18
-0
lines changed

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

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -149,6 +149,24 @@ Segment creates a SHA-256 hash of the following fields before sending to Faceboo
149149

150150
If you use Facebook Pixel, the Pixel library also hashes the External ID. This means External IDs will match across Facebook Pixel and Facebook Conversions API if they use the External ID for [deduplication](https://developers.facebook.com/docs/marketing-api/conversions-api/deduplicate-pixel-and-server-events/#fbp-or-external-id){:target="_blank"}.
151151

152+
### User Data Parameters
153+
154+
Segment automatically maps User Data fields to their corresponding parameters [as expected by the Conversions API](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/customer-information-parameters/){:target="_blank"} before sending to Facebook:
155+
156+
| User Data Field | Conversions API User Data Parameter |
157+
|-----------------|-------------------------------------|
158+
| External ID | external_id |
159+
| Email | em |
160+
| Phone | ph |
161+
| Gender | ge |
162+
| Date of Birth | db |
163+
| Last Name | ln |
164+
| First Name | fn |
165+
| City | ct |
166+
| State | st |
167+
| Zip Code | zp |
168+
| Country | country |
169+
152170
### Server Event Parameter Requirements
153171

154172
Facebook requires the `action_source` server event parameter for all events sent to the Facebook Conversions API. This parameter specifies where the conversions occur. If `action_source` is set to **website**, then the `client_user_agent` and the `event_source_url` parameters are also required. Events sent to the Conversions API that don't meet the requirements may not be available for optimization, targeting, or measurement.

0 commit comments

Comments
 (0)