Merge pull request #432 from segmentio/repo-sync

repo sync

Author: bot-docsteam

src/connections/destinations/catalog/personas-facebook-custom-audiences/index.md

@@ -38,24 +38,10 @@ This page is about the **Facebook Custom Audiences** destination developed speci
 - **Destination rate limit**: None
 - **Lookback window allowed**: Yes
 - **Identifiers required** : Email or Mobile Device ID (IDFA)
-- **Identifiers accepted** : Email and Mobile Device ID (IDFA). Other identifiers can be sent through [Additional Traits Matching](#public-preview-feature-additional-traits-matching)
+- **Identifiers accepted** : Email and Mobile Device ID (IDFA). Other identifiers can be sent through [Additional Traits Matching](#public-preview-feature-additional-traits-matching).
 - **Client or Server-Side Connection**: Server-side
 - **Minimum audience size required**: 100
 
- <!-- commenting out until we can do better with formatting
- ---
-| **Support for Personas**        | Yes     |
-| **Personas Destination Method**  | List |
-| **Must create audience_name field in the tool before Personas can update those values** | No, we create the audience for you. Note: if you change the name of the audience in Segment, it will not be reflected in Facebook |
-| **How does the audience appear within the destination?**                                | As a Facebook Custom Audience  |
-| **Are there rate limits?**  | No     |
-| **Lookback window allowed by Destination**    | Yes   |
-| **Identifiers Required**   | email or IDFA   |
-| **Identifiers Accepted**    | See [Facebook developer docs](https://developers.facebook.com/docs/marketing-api/audiences/guides/custom-audiences/) for full list     |
-| **Client vs. Server-Side Connection**   | Server-side  |
-| **Minimum audience size required to send data to this Destination**   | 100  |  -->
-
-
 ## Use Cases: Known Users
 
 Facebook Custom Audiences allows you to efficiently run several marketing and advertising operations. The list below contains the most popular use cases when you know personally identifiable information (PII) about your users, such as email address, name, phone number, etc. Facebook takes the data that you send to Facebook Custom Audiences and matches it to the users that are on Facebook to enable these use cases.
@@ -66,14 +52,11 @@ Facebook Custom Audiences allows you to efficiently run several marketing and ad
 
 3. **Re-targeting Audiences.** You can use Personas to target users who completed some initial action, but didn't follow through on a purchase or other conversion event. You can create audiences to re-target these individuals and remind them to complete the purchase or other process.
 
-> note ""
-> **Note**: Re-targeting can also mean targeting anonymous visitors (those with no known personally identifiable information, such as email). The Personas Facebook Custom Audiences Integration feature for this use case is currently in beta. See below.
-
 ## Use Cases - Anonymous Users (Facebook Pixel support only)
 
 Sometimes, users visit your website and perform high-intent activities such as looking at a product or pricing page multiple times, but they don't convert (buy), and they don't provide any personally identifiable information so you can contact them.
 
-Facebook offers the Facebook Pixel, which allows you to retarget these types of anonymous users with advertising. This works by identifying users based on a cookie set in their browser. You can create a Website Custom Audience in Facebook for this use case. Segment today does not provide a way to sync audiences of anonymous users from Personas to Facebook to automatically create one of these Website Custom Audiences, though this feature is currently under development.
+Facebook offers the Facebook Pixel, which allows you to retarget these types of anonymous users with advertising. This works by identifying users based on a cookie set in their browser. You can create a Website Custom Audience in Facebook for this use case.
 
 ## How it works
 
@@ -97,17 +80,17 @@ Facebook offers the Facebook Pixel, which allows you to retarget these types of
 - Go to your Personas Space in your Segment Workspace.
 - Go to the Destinations tab and click “Add Destination”.
 - Select the Personas Facebook Custom Audiences option, and click **Configure Personas Facebook Custom Audiences**.
-- Authorize Facebook Ads and select a Facebook account id to sync to.
+- Authorize Facebook Ads and select a Facebook account ID to sync to.
 
-### 2. Create an audience in Segment & connect to Facebook
+### 2. Create an audience in Segment Personas & connect to Facebook
 
 - Go to the Audience Builder in Personas and create a new Audience with your desired event and trait criteria.
 - Go to your Personas space, and select the Facebook destination you added to connect the audience to Facebook.
 - Give the audience a name and description, and click **Create**.
 - Your audience starts syncing from Personas to Facebook Ads.
 
 > note ""
-> **Note**: if you change the name of the audience in Segment, it will not be reflected in Facebook
+> **Note**: If you change the name of the audience in Personas, it will not be reflected in Facebook.
 
 ### 3. Verify that the audience appears in Facebook
 
@@ -119,13 +102,12 @@ Once created, the audience should be available in Facebook in ten minutes unless
 ![](images/fb_ca_final.png)
 
 
-
-## Public Preview Feature: Additional traits matching
+## Additional Traits Matching
 
 > note ""
-> This feature is in Public Preview and usage is subject to the terms contained in the [First Access and Beta Preview Terms](https://segment.com/legal/first-access-beta-preview/). If you would like access, contact your CSM or email us at [[email protected]](mailto:[email protected]).
+> This feature is in Public Preview and usage is subject to the terms contained in the [First Access and Beta Preview Terms](https://segment.com/legal/first-access-beta-preview/){:target="_blank"}. For access, contact your CSM or email Segment at [[email protected]](mailto:[email protected]).
 
-Previously, Segment only sent email and mobile ids to Facebook. A new beta feature can send an expanded list of identifiers or traits to Facebook, so that Facebook can try to use these additional datapoints to match to their user profiles. If you have this feature enabled and implemented any of these traits in your Segment tracking, Personas can send this data to Facebook. Segment can now also sync multiple emails if the profile contains more than one. Additionally as part of this feature, Segment hashes fields before sending them downstream to Facebook, if required. (See the table below for hashing requirements.) Please note that the trait data implemented in your Segment tracking must match the naming convention and format specified in the table below, otherwise we are not able to send it to Facebook.
+Previously, Segment only sent email and mobile IDs to Facebook. A new beta feature can send an expanded list of identifiers or traits to Facebook, so that Facebook can try to use these additional datapoints to match to their user profiles. If you have this feature enabled and implemented any of these traits in your Segment tracking, Personas can send this data to Facebook. Segment can now also sync multiple emails if the profile contains more than one. Additionally as part of this feature, Segment hashes fields before sending them downstream to Facebook, if required. (See the table below for hashing requirements.) Please note that the trait data implemented in your Segment tracking must match the naming convention and format specified in the table below, otherwise we are not able to send it to Facebook.
 
 
 | **Name**        | **Trait Key formats supported**   | **Facebook Keys**  | **FB Hashing Required** | **FB Guidelines**     |
@@ -148,17 +130,15 @@ Previously, Segment only sent email and mobile ids to Facebook. A new beta featu
 
 ### Not seeing an audience in Facebook
 
-Make sure you authorized Facebook and selected the correct account id.
+Make sure you authorized Facebook and selected the correct account ID.
 
 ### Audience size smaller than expected
 
-Segment sends lists of users with identifiers that Facebook supports to Facebook. The matching logic itself occurs within Facebook. Facebook is more likely to be able to match a user profile if you track as many identifiers as possible, including email, mobile advertising identifiers (IDFA, Google advertising id), and others. If Facebook is unable to identify users based on the data that you provide, then the match rate will be low.
+Segment sends lists of users with identifiers that Facebook supports to Facebook. The matching logic itself occurs within Facebook. Facebook is more likely to be able to match a user profile if you track as many identifiers as possible, including email, mobile advertising identifiers (IDFA, Google advertising ID), and others. If Facebook is unable to identify users based on the data that you provide, then the match rate will be low.
 
-Note that emails must be in a plaintext format. Facebook also provides these guidelines for the emails that you send to them: Trim leading, trail whitespace, and convert all characters to lowercase.
+For example, many B2B SaaS businesses have users that sign up for their products with a work email address, like `[email protected]`. However, most Facebook users sign up for Facebook with a personal email only, like `[email protected]`. If you only provide the work email address, and no other identifiers, then Facebook can't match your user to the Jane Doe Facebook profile. This is the case for all identifiers - Facebook must have the identifier somewhere in a user's profile, or else they can't match on it.
 
-For example: many B2B SaaS business have users that sign up for their products with a work email address, like `[email protected]`. However, most Facebook users sign up for Facebook with a personal email only, like `[email protected]`. If you only provide the work email address, and no other identifiers, then Facebook can't match your user to the Jane Doe Facebook profile. This is the case for all identifiers: Facebook must have the identifier somewhere in a user's profile, or else they can't match on it.
+Please note, emails must be in a plain text format. Facebook also provides these guidelines for the emails that you send to them: trim leading, trail whitespace, and convert all characters to lowercase.
 
 ### Do you support LTV audiences?
-Facebook has a feature called [value-based audiences](https://developers.facebook.com/docs/marketing-api/audiences/guides/value-based-lookalike-audiences/) where you can send an additional field like LTV, to tell Facebook how to optimize their advertising based on a customer's value.
-
-Personas does not currently support this feature. If this is important to you, let us know at [[email protected]](mailto:[email protected]).
+Facebook has a feature called [value-based audiences](https://developers.facebook.com/docs/marketing-api/audiences/guides/value-based-lookalike-audiences/){:target="_blank"} where you can send an additional field like LTV, to tell Facebook how to optimize their advertising based on a customer's value. Personas does not currently support this feature.