fixing ambiguity (#2177)

fixing ambiguity in integration data requirements

Co-authored-by: myronkaifung <[email protected]>

Author: leonardofratini

pages/docs/cohort-sync/integrations/facebook-ads.md

@@ -1,11 +1,10 @@
 # Facebook Ads
 
-
 ## Overview
 
 Export Mixpanel cohorts to Facebook Ads to use targeted advertisements in Facebook. Manage the Facebook Ads integration from the Mixpanel integrations page. The integration currently supports data from Mixpanel into Facebook Business.
 
->You must have a Facebook Business account connected to [Business Manager](https://audience.42matters.com/blog/how-to-connect-your-facebook-ad-account-to-business-manager-to-use-custom-audiences) to use this integration.
+> You must have a Facebook Business account connected to [Business Manager](https://audience.42matters.com/blog/how-to-connect-your-facebook-ad-account-to-business-manager-to-use-custom-audiences) to use this integration.
 
 ## Permissions
 
@@ -31,11 +30,11 @@ Follow these steps to enable the integration with Facebook Ads:
 
 ## Export a Cohort
 
-To export a cohort to Facebook Ads: 
+To export a cohort to Facebook Ads:
 
 1. Navigate to Cohorts by clicking in the **Data Management** tab and select **Cohorts**.
 
-2. Select the cohort that you want to export. Click on the three dot icon on the right side of the cohort. 
+2. Select the cohort that you want to export. Click on the three dot icon on the right side of the cohort.
 
 3. Click **Export to Facebook**. Select either a one-time sync or a dynamic sync. Click **Start Sync**.
 
@@ -46,14 +45,16 @@ To export a cohort to Facebook Ads:
 This integration supports two types of exports: one-time export and dynamic sync. When you generate a one-time export or a dynamic sync, it overwrites the previous export with an updated export that reflects users who qualify for the cohort at the time of export.
 
 ### One-Time Export
+
 In a one-time export, Mixpanel sends Facebook a static export of users who currently qualify for the cohort. The cohort data will not be updated in Facebook after a one-time export.
 
 ### Dynamic Sync
+
 In a dynamic sync, Mixpanel initiates a sync between a cohort and Facebook every two hours. The exported cohort will be updated every two hours to reflect the most recent list of users in a cohort.
 
 ## Select the Cohort in Facebook Ads
 
-You must log in to Facebook Business Manager to use the Mixpanel Cohort in Facebook Ads. Select the **Menu** in Facebook Business Manager top navigation. 
+You must log in to Facebook Business Manager to use the Mixpanel Cohort in Facebook Ads. Select the **Menu** in Facebook Business Manager top navigation.
 
 Click on **Audiences**.
 
@@ -63,11 +64,11 @@ The Mixpanel Cohort is available in the Audience list. Cohorts are exported to F
 
 ## Data Requirement
 
-Facebook uses email addresses to match users from the cohort with users from their system. If they do not have an email address, they will instead use either a combination of phone number or first and last name or the device advertising ID that you choose when setting up the connection.
+Meta uses _email addresses_ as the primary identifier to match users in your cohort with users in their system. If an email address is not available, Meta may instead attempt to match using other identifiers such as a _phone number_, _first and last name_, or a _device advertising ID_ (depending on your connection setup).
 
-In order to use this integration, you must set $email as a user profile property or have the advertising ID. In addition to email address, Mixpanel will send a first name user profile property, a last name user profile property, a phone number user property, an advertising id user property and the distinct id. 
+To use this integration, each user profile must include either an _email address_ or a _device advertising ID_. In addition to the email (if present), your system will send the following user profile properties (if available): first name, last name, phone number, advertising ID, and distinct_id. No other user properties will be exported.
 
-Facebook excludes cohort members from the audience if they are unable to match them with a user in their system. An inequality between the number of users in the Facebook audience and Mixpanel cohort indicates that Facebook was unable to find the user.
+If Meta is unable to match a cohort member with a user in their system, that member will be excluded from the resulting Meta audience. A lower count in the Meta audience compared to your cohort indicates that some users could not be matched.
 
 ## Troubleshooting Errors
 
@@ -77,8 +78,6 @@ Below are some common blocking errors (e.g. Error Message: Invalid OAuth 2.0 Acc
 
 [Facebook tokens expire after 60 days of inactivity](https://developers.facebook.com/docs/facebook-login/auth-vs-data/). Users will have to log in again to resume the cohort exports.
 
- 
-
 #### (#200) The current user can not update audience XXXXXXXXXXX
 
 Verify the permissions for the user who created the sync, and then disconnect and reconnect from the Integrations page. Disconnecting and Reconnecting will resume your existing exports.
@@ -106,5 +105,3 @@ Please disable two factor authentication and re-establish the connection from th
 #### (#2654) Customer List Audiences Are Not Available: Ad accounts owned by businesses new to Facebook Products can create customer file Custom Audiences after several weeks of following our policies.
 
 Please contact Facebook support to get this feature enabled for you.
-
-

pages/docs/cohort-sync/integrations/google-ads.md

@@ -1,6 +1,5 @@
 # Google Ads
 
-
 ## Overview
 
 Export Mixpanel cohorts to Google Ads to use targeted advertisements in Google Search. Manage the Google Ads integration from the Mixpanel integrations page. The integration currently supports data from Mixpanel into a Google Ads account.
@@ -44,61 +43,57 @@ Click **Export to Google Ads**. Select either one-time sync or dynamic sync. Cli
 This integration supports two types of exports: one-time export and dynamic sync. When you generate a one-time export or dynamic sync, it overwrites the previous export with an updated export that reflects users who qualify for the cohort at the time of export.
 
 ### One-Time Export
+
 In a one-time export, Mixpanel sends Google Ads a static export of users who currently qualify for the cohort. The cohort data will not be updated in Google Ads after a one-time export.
 
 ### Dynamic Sync
+
 In dynamic sync, Mixpanel initiates sync between a cohort and Google Ads every two hours. The exported cohort will be updated every day to reflect the most recent list of users in a cohort.
 
 ## Select the Cohort in Google Ads
 
-You must log in to Google Business Manager to use the Mixpanel Cohort in Google Ads. Select the **Menu** in Google Business Manager’s top navigation. 
+You must log in to Google Business Manager to use the Mixpanel Cohort in Google Ads. Select the **Menu** in Google Business Manager’s top navigation.
 
 Click on **Tools & Settings** and launch Audience Manager.
 
 ![GoogleAds 5 Image](/googleads5.png)
 
-The Mixpanel Cohort is available under Audience Manager. Cohorts are exported to Google Ads as mixpanel_<Cohort Name>_<Cohort ID>.
+The Mixpanel Cohort is available under Audience Manager. Cohorts are exported to Google Ads as mixpanel*<Cohort Name>*<Cohort ID>.
 
 ![GoogleAds 6 Image](/googleads6.png)
 
 ## Data Requirements
-  
-Google Ads uses email addresses to match users from the cohort with users from their system. If they do not have the email address, they will instead use a combination of phone number or first and last name or the device advertising ID that you choose when setting up the connection.
 
-In order to use this integration, **you must set an email as a user profile property or have device advertising ID**. In addition to an email address, Mixpanel sends the first name user profile property, the last name user profile property, a phone number user property, an advertising ID user property and a distinct_id. All other user properties are not exported.
+Google Ads matches users from your Mixpanel cohort to users in its system primarily using _email addresses_. If an email address is not available, Google Ads can instead attempt to match users using other identifiers — such as a _phone number_, _first and last name_, or a _device advertising ID_, depending on how you configure the connection.
+
+To use this integration, your Mixpanel user profiles must include either an _email address_ or a _device advertising ID_. Along with those identifiers, Mixpanel also sends the following user properties (if available): first name, last name, phone number, advertising ID, and distinct_id. No other user properties are exported.
+
+If Google Ads cannot match a cohort member with a user in its system, that member will be excluded from the Google Ads audience. A lower number of users in Google Audiences compared to your Mixpanel cohort means some users could not be matched.
 
-Google Ads excludes cohort members from the audience if they are unable to match them with a user in their system. Inequality between the number of users in Google Audiences and the Mixpanel cohort indicates that Google was unable to find the user.
-  
 ## Troubleshooting Errors
 
 Below are some common blocking errors that may occur when authorizing or using this connection:
 
 **Advertiser needs to be on the allow-list to use remarketing lists created from advertiser uploaded data (e.g., Customer Match lists).**
-  
-Google has to whitelist customers to use this feature. [This Google support article](https://support.google.com/adspolicy/answer/6299717?hl=en) contains more information. Cohort exports will remain paused until it is enabled.
 
+Google has to whitelist customers to use this feature. [This Google support article](https://support.google.com/adspolicy/answer/6299717?hl=en) contains more information. Cohort exports will remain paused until it is enabled.
 
 **No customer found for the provided customer id.**
-  
+
 Please [use a valid customer id](https://support.google.com/google-ads/answer/1704344?hl=en).
- 
 
 **The customer can't be used because it isn't enabled.**
-  
-Please make sure the user setting the integrations has standard or admin access in the Google Ads account.
 
+Please make sure the user setting the integrations has standard or admin access in the Google Ads account.
 
 **The user does not have permission to perform this action on the resource or call a method.**
 
 Please make sure the user setting the integrations has standard or admin access in the Google Ads account.
 
-
 **User doesn't have permission to access customer. Note: If you're accessing a client customer, the manager's customer id must be set in the 'login-customer-id' header. See https://developers.google.com/google-ads/api/docs/concepts/call-structure#cid**
 
 Please make sure the user setting the integrations has standard or admin access in the Google Ads account.
 
-
 **User in the cookie is not a valid Ads user.**
 
 Please make sure the user setting the integrations has standard or admin access in the Google Ads account.
-