# [CLS] Social Metrics

###### tags: `Collidescope`

NOTE

- reach is uniqee count of impressions

## FB

scopes:
- public_profile
- business_management
- pages_show_list
- read_insights
- pages_read_user_content
- pages_read_engagement

### Campaign Dashboard (post)

list posts: /{pageId}/posts

| Metric | Field | Scopes |
| ------------------- | -------------------------------------------------- | ----------------------- |
| Impression | {postId}/insights/post_impressions/lifetime | read_insights |
| Reach | {postId}/insights/post_impressions_unique/lifetime | read_insights |
| Engagement/likes | {postId}/reactions?limit=0&summary=total_count | pages_read_user_content |
| Engagement/comments | {postId}/comments?limit=0&summary=total_count | pages_read_user_content |
| Engagement/shares | {postId}?fields=shares | pages_read_user_content |

### Analytic Dashboard (page)

list pages: /{userId}/accounts?fields=name,access_token,instagram_business_account{id,name}

| Metric | Field | Scopes |
| ---------- | ------------------------------------------------------------------- | ------------- |
| Likes | {pageId}/insights/page_fans/day?date_preset=today | read_insights |
| Impression | {pageId}/insights/page_impressions/days_28?date_preset=today | read_insights |
| Reach | {pageId}/insights/page_impressions_unique/days_28?date_preset=today | read_insights |
| Engagement | {pageId}/insights/page_post_engagements/days_28?date_preset=today | read_insights |

## IG

scopes:
- pages_show_list
- business_management
- instagram_basic
- instagram_manage_insights

### Campaign Dashboard (media)

list media: /{accountId}/medias

| Metric | Field | Scopes |
| ---------- | ------------------------------------- | ------------------------- |
| Impression | {mediaId}/insights?metric=impressions | instagram_manage_insights |
| Reach | {mediaId}/insights?metric=reach | instagram_manage_insights |
| Engagement | {mediaId}/insights?metric=engagement | instagram_manage_insights |

### Analytic Dashboard (account)

| Metric | Field | Scopes |
| ---------- | ------------------------------------------------------ | ------------------------- |
| Follower | {accountId}?fields= follower_count | instagram_basic |
| Impression | {accountId}/insights?metric=impressions&period=days_28 | instagram_manage_insights |
| Reach | {accountId}/insights?metric=reach&period=days_28 | instagram_manage_insights |
| Engagement | none | - |

## YouTube

scopes:
- youtube.readonly
- yt-analytics.readonly

### Campaign Dashboard (video)

| Metric | Field | Scopes |
| ------------------- | --------------------------------------------------------------- | --------------------- |
| Impression | none | - |
| Reach | `/v2/reports?ids=channel==MINE&video=={videoId}&metrics=views` | yt-analytics.readonly |
| Engagement/likes | `/v2/reports?ids=channel==MINE&video=={videoId}&metrics=likes` | yt-analytics.readonly |
| Engagement/comments | `/v2/reports?ids=channel==MINE&video=={videoId}&metrics=comments` | yt-analytics.readonly |
| Engagement/shares | `/v2/reports?ids=channel==MINE&video=={videoId}&metrics=shares` | yt-analytics.readonly |

### Analytic Dashboard (channel)

| Metric | Field | Scopes |
| ------------------- | ----------------------------------------------------- | --------------------- |
| Follower | /v3/channels?part=statistics&id={channelId} | youtube.readonly |
| Impression | none | - |
| Reach | /v2/reports?ids=channel=={channelId}&metrics=views | yt-analytics.readonly |
| Engagement/likes | /v2/reports?ids=channel=={channelId}&metrics=likes | yt-analytics.readonly |
| Engagement/comments | /v2/reports?ids=channel=={channelId}&metrics=comments | yt-analytics.readonly |
| Engagement/shares | /v2/reports?ids=channel=={channelId}&metrics=shares | yt-analytics.readonly |

* YouTube report data is delayed by 2 days!!!

## Twitch

scopes:

### Campaign Dashboard (video)

| Metric | Field | Scopes |
| ---------- | -------------------- | ------ |
| Impression | none | - |
| Reach | /videos?id={videoId} | - |
| Engagement | none | - |

### Campaign Dashboard (steams)

* user need to export data and import into our system manually, maybe we can use extensions to solve this issue?

| Metric | Field | Scopes |
| ---------- | -------------------- | ------ |
| Impression | none | - |
| Reach | /videos?id={videoId} | - |
| Engagement | none | - |

### Analytic Dashboard (channel)

| Metric | Field | Scopes |
| ---------- | ----- | ------ |
| Follower | - | - |
| Reach | - | - |
| Impression | - | - |
| Engagement | - | - |

<!--
- Ref
- [Google sheet](https://docs.google.com/spreadsheets/d/1kY6grWF4miEzc_W3QMLZKL4uXiON3JSFsSxsyxdZiKw/edit#gid=1058544358)

## Facebook

- Ref
- [FB: page engegement](https://developers.facebook.com/docs/graph-api/reference/insights/#page-engagement)
- [FB: page fans](https://developers.facebook.com/docs/graph-api/reference/insights/#page-fans)
- [FB: page posts](https://developers.facebook.com/docs/graph-api/reference/insights/#page-posts)

- Analytic Dashboard

| field | key | API |
| -------------------- | --------------------- | -------------- |
| Total Page Likes | page_fans | insights/{key} |
| Likes by Age | page_fans_gender_age | insights/{key} |
| Likes by Gender | page_fans_gender_age | insights/{key} |
| Likes by Region | page_fans_country | insights/{key} |
| Page Post Engagement | page_post_engagements | insights/{key} |
| Page Followers | page_follows | insights/{key} |
| Page Post Shares | x | x |
| Page Post Comments | x | x |
| Page Post Likes Gain | x | x |
| Page Impression | x | x |

NOTE:
- page_fans_gender_age: require `read_insights` permissions
- follower is undocumented: https://developers.facebook.com/community/threads/2566095593458198/
- page_follows
- page_daily_follows
- page_daily_follows_unique
- page_daily_unfollows
- page_daily_unfollows_unique
- share, comment มีแค่ระดับ post

- Campaign Dashboard

| field | key | API |
| ---------------- | --- | --- |
| Post Likes | | |
| Post Shares | | |
| Post Comments | | |
| Post Impressions | | |
| Post Reach | | |
| Post Views | | |

## Instagram

- Ref
- [IG: user](https://developers.facebook.com/docs/instagram-api/reference/ig-user)
- [IG: user insights](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)
- [IG: media](https://developers.facebook.com/docs/instagram-api/reference/ig-media)
- [IG: media insights](https://developers.facebook.com/docs/instagram-api/reference/ig-media/insights)
- igBussinessAccountId = {fbPageId}?fields=instagram_business_account

- Analytic Dashboard

| field | key | API |
| ------------------ | ----------------- | ----------------------------------- |
| Total IG Followers | followed_by_count | {igUserId}?fields=followed_by_count |
| Total Engagement | x | x |

- Campaign Dashboard

| field | key | API |
| -------- | -------- | -------- |
| like | likes | Text |

## YouTube

- Ref
- [YT: channel](https://developers.google.com/youtube/v3/docs/channels/list)
- [YT: stat query](https://developers.google.com/youtube/analytics/reference/reports/query)
- [Impression, Unique Viewers, Metrics mean](https://support.google.com/youtube/answer/9314486?visit_id=637665266804712889-3314159608&rd=1#impressions)

- Analytic Dashboard
- [Channel](https://youtube.googleapis.com/youtube/v3/channels?part=statistics&id=UCuYhJWbbaTdPKMjT2-EVkMA&key=[YOUR_API_KEY])
- [Report Query](https://youtubeanalytics.googleapis.com/v2/reports?ids=channel==UCuYhJWbbaTdPKMjT2-EVkMA&metrics=views&dimensions=day&startDate=2021-08-01&endDate=2021-09-03)

| field | key | API |
| --------------------- | ----------------------- | ------------ |
| Total Views | viewCount | Channel |
| Total Subscribers | subscriberCount | Channel |
| Total Watch Time | | x |
| Subscribers by Age | | x |
| Subscribers by Gender | | x |
| Subscribers by Region | | x |
| Likes | likes | Report Query |
| Shares | shares | Report Query |
| Watch Time | estimatedMinutesWatched | Report Query |
| Comments | commentCount | x |

- Campaign Dashboard

| field | key | API |
| ------------- | ------------- | ------------ |
| Likes | likes | Report Query |
| Shares | shares | Report Query |
| Comments | comments | Report Query |
| Impressions | adImpressions | ? |
| Unique Viewer | | x |

**Note**
- สามารถแยก viewer ตาม Age, Gender ได้
- Region ต้องระบุ country/province/continent/subContinent ที่อยากได้มา
- commentCount: This property has been deprecated.

## Twitch

- Campaign Dashboard

| field | key | API |
| ------------- | --- | --- |
| Likes | | |
| Shares | | |
| Comments | | |
| Impressions | | |
| Unique Viewer | | |
| Videos | | |

### NOTE
- All social platform
* Total Reach = FB Total Page Likes + IG Total followers + YT Total Subscribers
* Total Channels
- FB
* Total Page Likes
* Total Pages
* Total Engagement Rate (shares + likes + comments)/total page likes)
* or Total Engagement Rate 90 days
- IG
* Total Followers
* Total Accounts
* Total Engagement Rate (shares + likes + comments + saves)/total followers)
* or Total Engagement Rate 90 days
- YT
* Total Subscribers
* Total Channels
* Total Engagement Rate (likes + dislikes + comments)/total subscribers)
* or Total Views of channel of all channels (accumulated)

-->