Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add Facebook Insights Breakdown Table #5142

Merged
merged 8 commits into from
Aug 8, 2023
Merged

Add Facebook Insights Breakdown Table #5142

Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
e3a0b50
Get rid of deprecated properties
pwseg Aug 7, 2023
346929a
Add Breakdowns table
pwseg Aug 8, 2023
9cf26dd
Update src/connections/sources/catalog/cloud-apps/facebook-ads/index.md
pwseg Aug 8, 2023
a59d955
Update src/connections/sources/catalog/cloud-apps/facebook-ads/index.md
pwseg Aug 8, 2023
dd59fa5
Update src/connections/sources/catalog/cloud-apps/facebook-ads/index.md
pwseg Aug 8, 2023
53260bd
Update src/connections/sources/catalog/cloud-apps/facebook-ads/index.md
pwseg Aug 8, 2023
5d1fefb
Update src/connections/sources/catalog/cloud-apps/facebook-ads/index.md
pwseg Aug 8, 2023
c9fe054
Update src/connections/sources/catalog/cloud-apps/facebook-ads/index.md
pwseg Aug 8, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 20 additions & 7 deletions src/connections/sources/catalog/cloud-apps/facebook-ads/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand Down
Loading