Merge pull request #4734 from segmentio/bobbyatsegment-patch-2

Add section for user data field formatting

Author: forstisabella

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

@@ -165,6 +165,22 @@ Segment creates a SHA-256 hash of the following fields before sending to Faceboo
 
 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"}.
 
+### User Data Formatting
+
+Segment applies formatting to User Data Parameters as follows:
+
+| User Data Field       | Formatting applied to field value before hashing                                                                                                                                                                             |
+|-----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| External ID           | All whitespace is removed from string, set to lowercase.                                                                                                                                                                     |
+| Email                 | All whitespace is removed from string, set to lowercase.                                                                                                                                                                     |
+| First Name, Last Name | All whitespace is removed from string, set to lowercase.                                                                                                                                                                     |
+| Gender                | All whitespace is removed from string, set to lowercase. "male" is set to "m", "female" is set to "f".                                                                                                                       |
+| Date of Birth         | No formatting is applied.                                                                                                                                                                                                    |
+| Phone                 | All whitespace is removed from string.                                                                                                                                                                                       |
+| Zip Code              | All whitespace is removed from string.                                                                                                                                                                                       |
+| State                 | All whitespace is removed from string and the result is compared against a map object of states and their two-character ANSI abbreviation code.  Example: "Texas", "TX", or "tx" in this field will be formatted as "tx".    |
+| Country               | All whitespace is removed from string and the result is compared against a map object of countries and their two-letter ISO 3166-1 alpha-2 country code.  Example: "Germany", "germany", or "de" will be formatted as "de".  |
+
 ### User Data Parameters
 
 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: