Merge pull request #5142 from segmentio/facebook-cloud-source-note

Add Facebook Insights Breakdown Table

Author: pwseg

src/connections/sources/catalog/cloud-apps/facebook-ads/index.md

@@ -57,7 +57,7 @@ Collections are the groupings of resources we pull from your source. In your war
 
 ## Collection Properties
 
-Below are tables outlining the properties included in the collections listed above.
+The following tables outline the properties included in collections.
 
 ### Ad Accounts
 
@@ -123,20 +123,33 @@ Below are tables outlining the properties included in the collections listed abo
 | clicks                    | The number of clicks on your ads.                                                                                                                          |
 | date_start                | The start date for your data.                                                                                                                              |
 | date_stop                 | The end date for your data.                                                                                                                                |
-| ~~deeplink_clicks~~       | *Deprecated by Facebook.* Aliased to `click_to_app_deeplink`.                                                                                              |
-| ~~website_clicks~~        | *Deprecated by Facebook.* Aliased to `click_to_website`                                                                                                    |
 | frequency                 | The average number of times each person saw your ad.                                                                                                       |
 | impressions               | The number of times your ads were on screen.                                                                                                               |
 | inline_post_engagements   | The total number of actions that people take involving your ads.                                                                                           |
-| ~~social_clicks~~         | *Deprecated by Facebook.* The number of clicks (all) when your ad was displayed with social information.                                                   |
-| ~~social_impressions~~    | *Deprecated by Facebook.* The number of times your ads were viewed when displayed with social information.                                                 |
 | social_spend              | The total amount you've spent so far for your ads showed with social information.                                                                          |
 | spend                     | The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule.                                                       |
 | unique_clicks             | The number of people who performed a click (all). This metric is estimated.                                                                                |
 | unique_impressions        | Deprecated in favor of `reach` . You can continue to query `unique_impressions` for this metric, but zero-values will now be `null`.                       |
-| ~~unique_social_clicks~~  | *Deprecated by Facebook.* The number of people who performed a click (all) on your ad when it was displayed with social information.                       |
 | reach                     | The number of people who saw your ads at least once. Reach is different from impressions, which may include multiple views of your ads by the same people. |
-| ~~call_to_action_clicks~~ | *Deprecated by Facebook.* The number of times people clicked the call-to-action button on your ad.                                                         |
+
+#### Insights Breakdowns
+
+Segment also supports Breakdowns for Insights. Breakdowns are not enabled by default; [reach out to Segment support](https://segment.com/help/contact/){:target="_blank"} to enable them. Segment supports the following properties:
+
+| Property Name                    | Description                                                                                                                    |
+| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `actions`                        | The total number of actions people took that are attributed to your ads.                                                       |
+| `actions_values`                 | The total value of all conversions attributed to your ads.                                                                     |
+| `unique_actions`                 | The total number of unique actions attributed to your ads.                                                                     |
+| `video_p25_watched_actions`      | The number of times your video played at 25% of its length, including plays that skipped to this point.                    |
+| `video_p50_watched_actions`      | The number of times your video played at 50% of its length, including plays that skipped to this point.                    |
+| `video_p75_watched_actions`      | The number of times your video played at 75% of its length, including plays that skipped to this point.                    |
+| `video_p95_watched_actions`      | The number of times your video played at 95% of its length, including plays that skipped to this point.                    |
+| `video_p100_watched_actions`     | The number of times your video played at 100% of its length, including plays that skipped to this point.                   |
+| `video_30_sec_watched_actions`   | The number of times your video played for at least 30 seconds, or for nearly its total length if it's shorter than 30 seconds. |
+| `video_avg_time_watched_actions` | The average time a video played, including any time spent replaying the video for a single impression.                     |
+
+For more information, view [Meta's Insights documentation](https://developers.facebook.com/docs/marketing-api/reference/ads-insights/){:target="_blank"}.
 
 ## Adding Destinations