Facebook Ads

This data source contains insights on the advertising performance of your ad accounts such as average.

Dimensions

1. Date Start – The start date for your data
2. Created – Created time
3. Account Name – Name of the ad account and name of business profile (if applicable). If the account name is not set, the name of the first admin visible to the user will be returned
4. Business Country – Country code for the business address
5. Status – Status of the account
6. Placement – Placement is where your ad is shown on Facebook such as on News Feed on desktop, News Feed on a mobile device or on the right column
7. Business Name – The name of business account

Measures

1. Store Clicks – The numbers of clicks that go to app store after user clicks your ads
2. Call to Action Clicks – The number of clicks on the call to action button your ad receives
3. Avg View, % – The average percentage of the Canvas seen
4. Avg View Time, sec – The average time spent in seconds, within a Canvas unit
5. Total Clicks – The total number of clicks on your ad. Depending on what you’re promoting, this can include Page likes, event responses or app installs
6. Per 10 sec View Video – The average cost per 10-second video view, calculated as the amount spent divided by the number of 10-second video views
7. Estimated Ad Recall Lift (People) – The average cost per additional person we estimate will recall seeing your ad if asked within 2 days
8. Per Inline Link Click – The average you paid for each inline link click
9. Per Inline Post Engagement – The average you paid for each inline post engagement
10. Per Total Action – The average you’ve spent on actions. For example, if you spent $20 and you got 10 Page likes, each one cost an average of $2
11. Per Unique Click – The average cost per unique click for these ads, calculated as the amount spent divided by the number of unique clicks received
12. Per Unique Click (Inline Link) – The average you paid for each unique inline link click
13. CPC – The average cost per click for these ads, calculated as the amount spent divided by the number of clicks received
14. CPM – The average cost you’ve paid to have 1,000 impressions on your ad
15. CPP – The average cost you’ve paid to have your ad served to 1,000 unique people
16. CTR – The number of clicks you received divided by the number of impressions
17. Deeplink Clicks – The numbers of clicks that go to app after user clicks your ads
18. Estimated Ad Recall Lift Rate – The estimated number of people who recall your ad divided by the number of people your ad reached
19. Estimated Ad Recall Lift (People) – The additional number of people we estimate will remember seeing your ads if asked within 2 days
20. Frequency – The average number of times your ad was served to each person
21. Total Impressions – The number of times your ad was served. On our mobile apps an ad is counted as served the first time it’s viewed. On all other Facebook interfaces, an ad is served the first time it’s placed in a person’s News Feed or each time it’s placed in the right column
22. CTR (Link) – Click-through rate for inline clicks to link
23. Total Inline Link Clicks – The number of inline link clicks that your ad got
24. Inline Post Engagement – The number of inline post engagement that your ad got
25. Newsfeed Position – The average position where your ad was inserted into people’s news feeds on mobile and desktop. Position 1 is the one at the top of the feed
26. Newsfeed Clicks – The total number of clicks your ad received in people’s news feed, on mobile and desktop
27. Newsfeed Impressions – The total number of times your ad was inserted into people’s news feeds, on mobile and desktop
28. Reach – The number of people your ad was served to. This is the same as unique_impressions
29. Relevance Score – Ad relevance score is multiple metrics related to how your audience responded to your ad. Only available at ad level and will not be returned for aggregations at other levels
30. Social Clicks – The number of clicks your ad receives when it’s shown with social information (ex: Jane Doe likes this)
31. Social Impressions – The number of times your ad was served, with social information. For example, if 3 people are served an ad 2 times each and it includes information about a friend liking your Page, it counts as 6 social impressions
32. Social Reach – The number of people your ad was served to with social information. For example, if 3 people see an ad 2 times each that says a friend likes your Page, it counts as 3 social reache
33. Social Spend – The total amount you’ve spent so far for your ads showed with social information. (ex: Jane Doe likes this)
34. Spend – The total amount you’ve spent so far
35. Total Revenue – The total revenue returned from conversions or Facebook credit spends
36. Total Actions – The number of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn’t click on it. Actions include Page likes, app installs, conversions, event responses and more. For example, 2 Page likes and 2 comments would be counted as 4 action
37. Total Unique Actions – The number of people who took an action that was attributed to your ads
38. Unique Clicks – The total number of unique people who have clicked on your ad. For example, if 3 people click on the same ad 5 times, it will count as 3 unique clicks
39. Unique CTR – The number of people who clicked on your ad divided by the number of people you reached. For example, if you received 20 unique clicks and your ad was served to 1,000 unique people, your unique click-through rate would be 2%
40. Unique Impressions – The number of individuals the ad was served to on the site. This is the same as reach
41. Unique CTR (Inline Link) – Click-through rate for unique inline clicks to link
42. Unique Inline Link Clicks – The number of unique inline link clicks that your ad got
43. Unique CTR (Link) – Unique click-through rate for clicks to link. The number of people who clicked on the link in your ad that directs people off Facebook divided by the number of people you reached. Example: if you received 20 unique clicks to link and your ad was shown to 1,000 unique people, your unique click-through rate would be 2%
44. Unique Social Clicks – The number of individuals who clicked this ad while it had social context
45. Unique Social Impressions – The number of people the ad was served to with social context
46. Website Clicks – The numbers of clicks that go to web after user clicks your ads
47. CTR (Product) – The number of link clicks a product received divided by the number of impressions of the product, only applicable for multi-product ads
48. Number of Records – Number of Records

Templates

1. Ad accounts. Action Rate over the last 30 days – View your action rate for your ad accounts over time. Action rate is calculated as all actions divided by impressions.
2. Ad accounts. Click-Through Rate over the last 30 days – View your click-through rates for ad accounts over time. CTR is calculated as all clicks divided by impressions.
3. Ad accounts. Cost per Action over the last 30 days – View your cost per action over time. Cost per Action is calculated as amount spent divided by number of actions for ad accounts.
4. Ad accounts. Cost per Click over the last 30 days – View your cost per click over time. CPC is calculated as amount spent divided by number of clicks for ad accounts.
5. Ad accounts. Frequency over the last 30 days – View the average number of times your ad accounts were served to each person.
6. Ad accounts. Reach over the last 30 days – View the number of people who see your ad accounts in a given time period and how it trends.

This data source contains insights on the advertising performance of your ad accounts by action type.

Dimensions

1. Date Start – The start date for your data
2. Created – Created time
3. Account Name – Name of the ad account and name of business profile (if applicable). If the account name is not set, the name of the first admin visible to the user will be returned
4. Business Country – Country code for the business address
5. Action Type – Type of Action
6. Status – Status of the account
7. Business Name – The name of business account

Measures

1. Action Values – The total revenue returned from conversions or Facebook credit spends
2. Actions Count – The number of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn’t click on it. Actions include Page likes, app installs, conversions, event responses and more. For example, 2 Page likes and 2 comments would be counted as 4 actions
3. Per Action Type – The average you’ve spent on actions. For example, if you spent $20 and you got 10 Page likes, each one cost an average of $2
4. Per Unique Action Type – The average you paid for each type of unique action
5. Unique Actions – The number of unique people who took an action such as liking your Page or installing your app as a result of your ad. For example, if the same person likes and comments on a post, they will be counted as 1 unique person
6. CTR (Product) – The number of link clicks a product received divided by the number of impressions of the product, only applicable for multi-product ads
7. Total Views Video (10 sec) – This shows the number of total views of at least 10 seconds or to the end of your video, whichever occurs first
8. Total Views Video (15 sec) – The number of times your video was viewed more than 15 seconds, including views that skipped to this point
9. Total Views Video (30 sec) – This shows the number of total views of at least 30 seconds or to the end of your video, whichever occurs first
10. Audience Retention – This is the total video watch time divided by views of your video over your video’s duration. This is not applicable for live videos
11. Video Percentage Watched – not supported by Facebook API 4.0
12. Video Average Watch Time – This is the total video watch time for your video divided by the total number of plays of your video
13. Total Views Video (Complete) – This shows the number of total views of at least 30 seconds or to the end of your video, whichever occurs first
14. Total Views (100%) – The number of times your video was viewed to 100% of its length, including views that skipped to this point
15. Total Views (25%) – The number of times your video was viewed to 25% of its length, including views that skipped to this point
16. Total Views (50%) – The number of times your video was viewed to 50% of its length, including views that skipped to this point
17. Total Views (75%) – The number of times your video was viewed to 75% of its length, including views that skipped to this point
18. Total Views (95%) – not supported by Facebook API 4.0
19. Number of Records – Number of Records

Templates

1. Ad Accounts. Number of Actions over the last 30 days – View the total number of actions people took that are attributed to your ad accounts. Actions may include engagement, clicks or conversions.

This data source contains insights on the advertising performance of your ad campaigns for your ad accounts.

Dimensions

1. Date Start – The start date for your data
2. Created – Created time
3. Configure Status – The configured status of the campaign
4. Account Name – Name of the ad account and name of business profile (if applicable). If the account name is not set, the name of the first admin visible to the user will be returned
5. Business Country – Country code for the business address
6. Campaign Name – Name of the campaign
7. Objective – The objective you selected for your ad, ad set, or campaign. Your objective reflects what you want to achieve with ads
8. Account Status – Status of the account
9. Placement – Placement is where your ad is shown on Facebook such as on News Feed on desktop, News Feed on a mobile device or on the right column
10. Status – Status of the campaign
11. Tags – Tags associated with this campaign
12. Business Name – The name of business account

Measures

1. Store Clicks – The numbers of clicks that go to app store after user clicks your ads
2. Call to Action Clicks – The number of clicks on the call to action button your ad receives
3. Avg View, % – The average percentage of the Canvas seen
4. Avg View Time, sec – The average time spent in seconds, within a Canvas unit
5. Total Clicks – The total number of clicks on your ad. Depending on what you’re promoting, this can include Page likes, event responses or app installs
6. Per 10 sec View Video – The average cost per 10-second video view, calculated as the amount spent divided by the number of 10-second video views
7. Estimated Ad Recall Lift (People) – The average cost per additional person we estimate will recall seeing your ad if asked within 2 days
8. Per Inline Link Click – The average you paid for each inline link click
9. Per Inline Post Engagement – The average you paid for each inline post engagement
10. Per Total Action – The average you’ve spent on actions. For example, if you spent $20 and you got 10 Page likes, each one cost an average of $2
11. Per Unique Click – The average cost per unique click for these ads, calculated as the amount spent divided by the number of unique clicks received
12. Per Unique Click (Inline Link) – The average you paid for each unique inline link click
13. CPC – The average cost per click for these ads, calculated as the amount spent divided by the number of clicks received
14. CPM – The average cost you’ve paid to have 1,000 impressions on your ad
15. CPP – The average cost you’ve paid to have your ad served to 1,000 unique people
16. CTR – The number of clicks you received divided by the number of impressions
17. Deeplink Clicks – The numbers of clicks that go to app after user clicks your ads
18. Estimated Ad Recall Lift Rate – The estimated number of people who recall your ad divided by the number of people your ad reached
19. Estimated Ad Recall Lift (People) – The additional number of people we estimate will remember seeing your ads if asked within 2 days
20. Frequency – The average number of times your ad was served to each person
21. Total Impressions – The number of times your ad was served. On our mobile apps an ad is counted as served the first time it’s viewed. On all other Facebook interfaces, an ad is served the first time it’s placed in a person’s News Feed or each time it’s placed in the right column
22. CTR (Link) – Click-through rate for inline clicks to link
23. Total Inline Link Clicks – The number of inline link clicks that your ad got
24. Inline Post Engagement – The number of inline post engagement that your ad got
25. Newsfeed Position – The average position where your ad was inserted into people’s news feeds on mobile and desktop. Position 1 is the one at the top of the feed
26. Newsfeed Clicks – The total number of clicks your ad received in people’s news feed, on mobile and desktop
27. Newsfeed Impressions – The total number of times your ad was inserted into people’s news feeds, on mobile and desktop
28. Reach – The number of people your ad was served to. This is the same as unique_impressions
29. Relevance Score – Ad relevance score is multiple metrics related to how your audience responded to your ad. Only available at ad level and will not be returned for aggregations at other levels
30. Social Clicks – The number of clicks your ad receives when it’s shown with social information (ex: Jane Doe likes this)
31. Social Impressions – The number of times your ad was served, with social information. For example, if 3 people are served an ad 2 times each and it includes information about a friend liking your Page, it counts as 6 social impressions
32. Social Reach – The number of people your ad was served to with social information. For example, if 3 people see an ad 2 times each that says a friend likes your Page, it counts as 3 social reache
33. Social Spend – The total amount you’ve spent so far for your ads showed with social information. (ex: Jane Doe likes this)
34. Spend – The total amount you’ve spent so far
35. Total Revenue – The total revenue returned from conversions or Facebook credit spends
36. Total Actions – The number of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn’t click on it. Actions include Page likes, app installs, conversions, event responses and more. For example, 2 Page likes and 2 comments would be counted as 4 action
37. Unique Clicks – The total number of unique people who have clicked on your ad. For example, if 3 people click on the same ad 5 times, it will count as 3 unique clicks
38. Unique CTR – The number of people who clicked on your ad divided by the number of people you reached. For example, if you received 20 unique clicks and your ad was served to 1,000 unique people, your unique click-through rate would be 2%
39. Unique Impressions – The number of individuals the ad was served to on the site. This is the same as reach
40. Unique CTR (inline Link) – Click-through rate for unique inline clicks to link
41. Unique Inline Link Clicks – The number of unique inline link clicks that your ad got
42. Unique CTR (Link) – Unique click-through rate for clicks to link. The number of people who clicked on the link in your ad that directs people off Facebook divided by the number of people you reached. Example: if you received 20 unique clicks to link and your ad was shown to 1,000 unique people, your unique click-through rate would be 2%
43. Unique Social Clicks – The number of individuals who clicked this ad while it had social context
44. Unique Social Impressions – The number of people the ad was served to with social context
45. Website Clicks – The numbers of clicks that go to web after user clicks your ads
46. CTR (Product) – The number of link clicks a product received divided by the number of impressions of the product, only applicable for multi-product ads
47. Number of Records – Number of Records

Templates

1. Ad Campaigns. Action Rate over the last 30 days – View your action rate for your ad campaigns over time. Action rate is calculated as all actions divided by impressions.
2. Ad Campaigns. Click-Through Rate over the last 30 days – View your click-through rates for ad campaigns over time. CTR is calculated as all clicks divided by impressions.
3. Ad Campaigns. Cost per Click over the last 30 days – View your cost per click over time. CPC is calculated as amount spent divided by number of clicks for ad campaigns.
4. Ad Campaigns. Frequency over the last 30 days – View the average number of times your ad campaigns were served to each person.
5. Ad Campaigns. Number of Clicks over the last 30 days – View the total number of clicks on your ad campaigns over time. Depending on what you’re promoting, this can include Page likes, event responses or app installs.
6. Ad Campaigns. Reach over the last 30 days – View the number of people who see your ad campaigns in a given time period and how it trends.
7. Ad Campaigns. Cost per Action over the last 30 days – View your cost per action over time. Cost per Action is calculated as amount spent divided by number of actions for ad campaigns.

This data source contains insights on the advertising performance of ad campaigns by action type.

Dimensions

1. Date Start – The start date for your data
2. Campaign Name – Name of the campaign
3. Created – Created time
4. Configure Status – The configured status of the campaign
5. Account Name – Name of the ad account and name of business profile (if applicable). If the account name is not set, the name of the first admin visible to the user will be returned
6. Business Country – Country code for the business address
7. Objective – The objective you selected for your ad, ad set, or campaign. Your objective reflects what you want to achieve with ads
8. Account Status – Status of the account
9. Action Type – Type of Action
10. Status – Status of the campaign
11. Tags – Tags associated with this campaign
12. Business Name – The name of business account

Measures

1. Action Values – The total revenue returned from conversions or Facebook credit spends
2. Actions Count – The number of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn’t click on it. Actions include Page likes, app installs, conversions, event responses and more. For example, 2 Page likes and 2 comments would be counted as 4 actions
3. Per Action Type – The average you’ve spent on actions. For example, if you spent $20 and you got 10 Page likes, each one cost an average of $2
4. Per Unique Action Type – The average you paid for each type of unique action
5. Unique Actions – The number of unique people who took an action such as liking your Page or installing your app as a result of your ad. For example, if the same person likes and comments on a post, they will be counted as 1 unique person
6. CTR (Product) – The number of link clicks a product received divided by the number of impressions of the product, only applicable for multi-product ads
7. Total Views Video (10 sec) – This shows the number of total views of at least 10 seconds or to the end of your video, whichever occurs first
8. Total Views Video (15 sec) – The number of times your video was viewed more than 15 seconds, including views that skipped to this point
9. Total Views Video (30 sec) – This shows the number of total views of at least 30 seconds or to the end of your video, whichever occurs first
10. Audience Retention – This is the total video watch time divided by views of your video over your video’s duration. This is not applicable for live videos
11. Video Percentage Watched – not supported by Facebook API 4.0 
12. Video Average Watch Time – This is the total video watch time for your video divided by the total number of plays of your video
13. Total Views Video (Complete) – This shows the number of total views of at least 30 seconds or to the end of your video, whichever occurs first
14. Total Views (100%) – The number of times your video was viewed to 100% of its length, including views that skipped to this point
15. Total Views (25%) – The number of times your video was viewed to 25% of its length, including views that skipped to this point
16. Total Views (50%) – The number of times your video was viewed to 50% of its length, including views that skipped to this point
17. Total Views (75%) – The number of times your video was viewed to 75% of its length, including views that skipped to this point
18. Total Views (95%) – not supported by Facebook API 4.0
19. Number of Records – Number of Records

Templates

1. Ad Campaigns. Number of Actions over the last 30 days – View the total number of actions people took that are attributed to your ad campaigns. Actions may include engagement, clicks or conversions.

This data source contains insights on the advertising performance of your ad sets for ad accounts.

Dimensions

1. Date Start – The start date for your data
2. Created – Created time
3. Configure Status – The configured status of the campaign
4. Account Name – Name of the account. If the account name is not set, the name of the first admin visible to the user will be returned
5. Business Country – Country code for the business address
6. Ad Set Name – Name of the ad set
7. Objective – The objective you selected for your ad, ad set, or campaign. Your objective reflects what you want to achieve with ads
8. Account Status – Status of the account
9. Status – Status of the ad set
10. Tags – Tags associated with this campaign
11. Business Name – The name of business account

Measures

1. Call to Action Clicks – The number of clicks on the call to action button your ad receives
2. Avg View, % – The average percentage of the Canvas seen
3. Avg View Time, sec – The average time spent in seconds, within a Canvas unit
4. Total Clicks – The total number of clicks on your ad. Depending on what you’re promoting, this can include Page likes, event responses or app installs
5. Per 10 sec View Video – The average cost per 10-second video view, calculated as the amount spent divided by the number of 10-second video views
6. Estimated Ad Recall Lift (People) – The average cost per additional person we estimate will recall seeing your ad if asked within 2 days
7. Per Inline Link Click – The average you paid for each inline link click
8. Per Inline Post Engagement – The average you paid for each inline post engagement
9. Per Total Action – The average you’ve spent on actions. For example, if you spent $20 and you got 10 Page likes, each one cost an average of $2
10. Per Unique Click – The average cost per unique click for these ads, calculated as the amount spent divided by the number of unique clicks received
11. Per Unique Click (Inline Link) – The average you paid for each unique inline link click
12. CPC – The average cost per click for these ads, calculated as the amount spent divided by the number of clicks received
13. CPM – The average cost you’ve paid to have 1,000 impressions on your ad
14. CPP – The average cost you’ve paid to have your ad served to 1,000 unique people
15. CTR – The number of clicks you received divided by the number of impressions
16. Estimated Ad Recall Lift Rate – The estimated number of people who recall your ad divided by the number of people your ad reached
17. Estimated Ad Recall Lift (People) – The additional number of people we estimate will remember seeing your ads if asked within 2 days
18. Frequency – The average number of times your ad was served to each person
19. Total Impressions – The number of times your ad was served. On our mobile apps an ad is counted as served the first time it’s viewed. On all other Facebook interfaces, an ad is served the first time it’s placed in a person’s News Feed or each time it’s placed in the right column
20. CTR (Link) – Click-through rate for inline clicks to link
21. Total Inline Link Clicks – The number of inline link clicks that your ad got
22. Inline Post Engagement – The number of inline post engagement that your ad got
23. Reach – The number of people your ad was served to. This is the same as unique_impressions
24. Relevance Score – Ad relevance score is multiple metrics related to how your audience responded to your ad. Only available at ad level and will not be returned for aggregations at other levels
25. Social Clicks – The number of clicks your ad receives when it’s shown with social information (ex: Jane Doe likes this)
26. Social Impressions – The number of times your ad was served, with social information. For example, if 3 people are served an ad 2 times each and it includes information about a friend liking your Page, it counts as 6 social impressions
27. Social Reach – The number of people your ad was served to with social information. For example, if 3 people see an ad 2 times each that says a friend likes your Page, it counts as 3 social reache
28. Social Spend – The total amount you’ve spent so far for your ads showed with social information. (ex: Jane Doe likes this)
29. Spend – The total amount you’ve spent so far
30. Total Revenue – The total revenue returned from conversions or Facebook credit spends
31. Total Actions – The number of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn’t click on it. Actions include Page likes, app installs, conversions, event responses and more. For example, 2 Page likes and 2 comments would be counted as 4 action
32. Unique Clicks – The total number of unique people who have clicked on your ad. For example, if 3 people click on the same ad 5 times, it will count as 3 unique clicks
33. Unique CTR – The number of people who clicked on your ad divided by the number of people you reached. For example, if you received 20 unique clicks and your ad was served to 1,000 unique people, your unique click-through rate would be 2%
34. Unique CTR (inline Link) – Click-through rate for unique inline clicks to link
35. Unique Inline Link Clicks – The number of unique inline link clicks that your ad got
36. Unique CTR (Link) – Unique click-through rate for clicks to link. The number of people who clicked on the link in your ad that directs people off Facebook divided by the number of people you reached. Example: if you received 20 unique clicks to link and your ad was shown to 1,000 unique people, your unique click-through rate would be 2%
37. Unique Social Clicks – The number of individuals who clicked this ad while it had social context
38. CTR (Product) – The number of link clicks a product received divided by the number of impressions of the product, only applicable for multi-product ads
39. Number of Records – Number of Records

Templates

1. Ad Sets. Action Rate over the last 30 days – View your action rate for your ad sets over time. Action rate is calculated as all actions divided by impressions.
2. Ad Sets. Click-Through Rate over the last 30 days – View your click-through rates for ad sets over time. CTR is calculated as all clicks divided by impressions.
3. Ad Sets. Cost per Click over the last 30 days – View your cost per click over time. CPC is calculated as amount spent divided by number of clicks for ad sets.
4. Ad Sets. Frequency over the last 30 days – View the average number of times your ad sets were served to each person.
5. Ad Sets. Number of Clicks over the last 30 days – View the total number of clicks on your ad sets over time. Depending on what you’re promoting, this can include Page likes, event responses or app installs.
6. Ad Sets. Reach over the last 30 days – View the number of people who see your ad sets in a given time period and how it trends.
7. Ad Sets. Cost per Action over the last 30 days – View your cost per action over time. Cost per Action is calculated as amount spent divided by number of actions for ad sets.

This data source contains insights on the advertising performance of ads by action type.

Dimensions

1. Date Start – The start date for your data
2. Created – Created time
3. Ad Set Name – Name of the ad set
4. Configure Status – The configured status of the ad set
5. Account Name – Name of the ad account and name of business profile (if applicable). If the account name is not set, the name of the first admin visible to the user will be returned
6. Business Country – Country code for the business address
7. Objective – The objective you selected for your ad, ad set, or campaign. Your objective reflects what you want to achieve with ads
8. Account Status – Status of the account
9. Action Type – Type of Action
10. Status – Status of the ad set
11. Tags – Tags associated with this campaign
12. Business Name – The name of business account

Measures

1. Action Values – The total revenue returned from conversions or Facebook credit spends
2. Actions Count – The number of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn’t click on it. Actions include Page likes, app installs, conversions, event responses and more. For example, 2 Page likes and 2 comments would be counted as 4 actions
3. Per Action Type – The average you’ve spent on actions. For example, if you spent $20 and you got 10 Page likes, each one cost an average of $2
4. Per Unique Action Type – The average you paid for each type of unique action
5. Unique Actions – The number of unique people who took an action such as liking your Page or installing your app as a result of your ad. For example, if the same person likes and comments on a post, they will be counted as 1 unique person
6. CTR (Product) – The number of link clicks a product received divided by the number of impressions of the product, only applicable for multi-product ads
7. Total Views Video (10 sec) – This shows the number of total views of at least 10 seconds or to the end of your video, whichever occurs first
8. Total Views Video (15 sec) – The number of times your video was viewed more than 15 seconds, including views that skipped to this point
9. Total Views Video (30 sec) – This shows the number of total views of at least 30 seconds or to the end of your video, whichever occurs first
10. Video Percentage Watched – not supported by Facebook API 4.0
11. Video Average Watch Time – This is the total video watch time for your video divided by the total number of plays of your video
12. Total Views (100%) – The number of times your video was viewed to 100% of its length, including views that skipped to this point
13. Total Views (25%) – The number of times your video was viewed to 25% of its length, including views that skipped to this point
14. Total Views (50%) – The number of times your video was viewed to 50% of its length, including views that skipped to this point
15. Total Views (75%) – The number of times your video was viewed to 75% of its length, including views that skipped to this point
16. Total Views (95%) – not supported by Facebook API 4.0
17. Number of Records – Number of Records

Templates

1. Ad Sets. Number of Actions over the last 30 days – View the total number of actions people took that are attributed to your ad sets. Actions may include engagement, clicks or conversions.

This data source contains insights on the advertising performance of ads for your ad accounts.

Dimensions

1. Date Start – The start date for your data
2. Ad Name – Name of the ad
3. Created – Created time
4. Bid Type – Bid type
5. Configure Status – The configured status of the ad
6. Account Name – Name of the ad account and name of business profile (if applicable). If the account name is not set, the name of the first admin visible to the user will be returned
7. Business Country – Country code for the business address
8. Adset Name – A group of ads that share the same budget and are usually about a single topic
9. Campaign Name – A group of ad sets that share the same objective
10. Objective – The objective you selected for your ad, ad set, or campaign. Your objective reflects what you want to achieve with ads
11. Account Status – Status of the account
12. Placement – Placement is where your ad is shown on Facebook such as on News Feed on desktop, News Feed on a mobile device or on the right column
13. Status – Status of the ad
14. Tags – Tags associated with this campaign
15. Business Name – The name of business account

Measures

1. Store Clicks – The numbers of clicks that go to app store after user clicks your ads
2. Call to Action Clicks – The number of clicks on the call to action button your ad receives
3. Avg View, % – The average percentage of the Canvas seen
4. Avg View Time, sec – The average time spent in seconds, within a Canvas unit
5. Total Clicks – The total number of clicks on your ad. Depending on what you’re promoting, this can include Page likes, event responses or app installs
6. Per 10 sec View Video – The average cost per 10-second video view, calculated as the amount spent divided by the number of 10-second video views
7. Estimated Ad Recall Lift (People) – The average cost per additional person we estimate will recall seeing your ad if asked within 2 days
8. Per Inline Link Click – The average you paid for each inline link click
9. Per Inline Post Engagement – The average you paid for each inline post engagement
10. Per Total Action – The average you’ve spent on actions. For example, if you spent $20 and you got 10 Page likes, each one cost an average of $2
11. Per Unique Click – The average cost per unique click for these ads, calculated as the amount spent divided by the number of unique clicks received
12. Per Unique Click (Inline Link) – The average you paid for each unique inline link click
13. CPC – The average cost per click for these ads, calculated as the amount spent divided by the number of clicks received
14. CPM – The average cost you’ve paid to have 1,000 impressions on your ad
15. CPP – The average cost you’ve paid to have your ad served to 1,000 unique people
16. CTR – The number of clicks you received divided by the number of impressions
17. Deeplink Clicks – The numbers of clicks that go to app after user clicks your ads
18. Estimated Ad Recall Lift Rate – The estimated number of people who recall your ad divided by the number of people your ad reached
19. Estimated Ad Recall Lift (People) – The additional number of people we estimate will remember seeing your ads if asked within 2 days
20. Frequency – The average number of times your ad was served to each person
21. Total Impressions – The number of times your ad was served. On our mobile apps an ad is counted as served the first time it’s viewed. On all other Facebook interfaces, an ad is served the first time it’s placed in a person’s News Feed or each time it’s placed in the right column
22. CTR (Link) – Click-through rate for inline clicks to link
23. Total Inline Link Clicks – The number of inline link clicks that your ad got
24. Inline Post Engagement – The number of inline post engagement that your ad got
25. Newsfeed Position – The average position where your ad was inserted into people’s news feeds on mobile and desktop. Position 1 is the one at the top of the feed
26. Newsfeed Clicks – The total number of clicks your ad received in people’s news feed, on mobile and desktop
27. Newsfeed Impressions – The total number of times your ad was inserted into people’s news feeds, on mobile and desktop
28. Reach – The number of people your ad was served to. This is the same as unique_impressions
29. Relevance Score – Ad relevance score is multiple metrics related to how your audience responded to your ad. Only available at ad level and will not be returned for aggregations at other levels
30. Social Clicks – The number of clicks your ad receives when it’s shown with social information (ex: Jane Doe likes this)
31. Social Impressions – The number of times your ad was served, with social information. For example, if 3 people are served an ad 2 times each and it includes information about a friend liking your Page, it counts as 6 social impressions
32. Social Reach – The number of people your ad was served to with social information. For example, if 3 people see an ad 2 times each that says a friend likes your Page, it counts as 3 social reache
33. Social Spend – The total amount you’ve spent so far for your ads showed with social information. (ex: Jane Doe likes this)
34. Spend – The total amount you’ve spent so far
35. Total Revenue – The total revenue returned from conversions or Facebook credit spends
36. Total Actions – The number of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn’t click on it. Actions include Page likes, app installs, conversions, event responses and more. For example, 2 Page likes and 2 comments would be counted as 4 action
37. Unique Clicks – The total number of unique people who have clicked on your ad. For example, if 3 people click on the same ad 5 times, it will count as 3 unique clicks
38. Unique CTR – The number of people who clicked on your ad divided by the number of people you reached. For example, if you received 20 unique clicks and your ad was served to 1,000 unique people, your unique click-through rate would be 2%
39. Unique Impressions – The number of individuals the ad was served to on the site. This is the same as reach
40. Unique CTR (inline Link) – Click-through rate for unique inline clicks to link
41. Unique Inline Link Clicks – The number of unique inline link clicks that your ad got
42. Unique CTR (Link) – Unique click-through rate for clicks to link. The number of people who clicked on the link in your ad that directs people off Facebook divided by the number of people you reached. Example: if you received 20 unique clicks to link and your ad was shown to 1,000 unique people, your unique click-through rate would be 2%
43. Unique Social Clicks – The number of individuals who clicked this ad while it had social context
44. Unique Social Impressions – The number of people the ad was served to with social context
45. Website Clicks – The numbers of clicks that go to web after user clicks your ads
46. CTR (Product) – The number of link clicks a product received divided by the number of impressions of the product, only applicable for multi-product ads
47. Number of Records – Number of Records

Templates

1. Ads. Action Rate over the last 30 days – View your action rate for your ads over time. Action rate is calculated as all actions divided by impressions.
2. Ads. Click-Through Rate over the last 30 days – View your click-through rates for ads over time. CTR is calculated as all clicks divided by impressions.
3. Ads. Cost per Action over the last 30 days – View your cost per action over time. Cost per Action is calculated as amount spent divided by number of actions for ads.
4. Ads. Cost per Click over the last 30 days – View your cost per click over time. CPC is calculated as amount spent divided by number of clicks for ads.
5. Ads. Frequency over the last 30 days – View the average number of times your ads were served to each person.
6. Ads. Number of Clicks over the last 30 days – View the total number of clicks on your ads over time. Depending on what you’re promoting, this can include Page likes, event responses or app installs.
7. Ads. Number of Impressions over the last 30 days – View the number of times your ads were viewed over time.
8. Ads. Reach over the last 30 days – View the number of people who see your ads in a given time period and how it trends.
9. Highest Action Rate – View your top 10 ads that generated the highest actions rate. Action rate is calculated as all actions divided by impressions.
10. Highest Click-Through Rate – View your top 10 ads that generated the highest click-through rate.

This data source contains insights on the advertising performance of ads by action type.

Dimensions

1. Date Start – The start date for your data
2. Ad Name – Name of the ad
3. Created – Created time
4. Bid Type – Bid type
5. Configure Status – The configured status of the ad
6. Account Name – Name of the ad account and name of business profile (if applicable). If the account name is not set, the name of the first admin visible to the user will be returned
7. Business Country – Country code for the business address
8. Adset Name – A group of ads that share the same budget and are usually about a single topic
9. Campaign Name – A group of ad sets that share the same objective
10. Objective – The objective you selected for your ad, ad set, or campaign. Your objective reflects what you want to achieve with ads
11. Account Status – Status of the account
12. Action Type – Type of Action
13. Status – Status of the ad
14. Tags – Tags associated with this campaign
15. Business Name – The name of business account

Measures

1. Action Values – The total revenue returned from conversions or Facebook credit spends
2. Actions Count – The number of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn’t click on it. Actions include Page likes, app installs, conversions, event responses and more. For example, 2 Page likes and 2 comments would be counted as 4 actions
3. Per Action Type – The average you’ve spent on actions. For example, if you spent $20 and you got 10 Page likes, each one cost an average of $2
4. Per Unique Action Type – The average you paid for each type of unique action
5. Unique Actions – The number of unique people who took an action such as liking your Page or installing your app as a result of your ad. For example, if the same person likes and comments on a post, they will be counted as 1 unique person
6. CTR (Product) – The number of link clicks a product received divided by the number of impressions of the product, only applicable for multi-product ads
7. Total Views Video (10 sec) – This shows the number of total views of at least 10 seconds or to the end of your video, whichever occurs first
8. Total Views Video (15 sec) – The number of times your video was viewed more than 15 seconds, including views that skipped to this point
9. Total Views Video (30 sec) – This shows the number of total views of at least 30 seconds or to the end of your video, whichever occurs first
10. Audience Retention – This is the total video watch time divided by views of your video over your video’s duration. This is not applicable for live videos
11. Video Percentage Watched – not supported by Facebook API 4.0
12. Video Average Watch Time – This is the total video watch time for your video divided by the total number of plays of your video
13. Total Views Video (Complete) – This shows the number of total views of at least 30 seconds or to the end of your video, whichever occurs first
14. Total Views (100%) – The number of times your video was viewed to 100% of its length, including views that skipped to this point
15. Total Views (25%) – The number of times your video was viewed to 25% of its length, including views that skipped to this point
16. Total Views (50%) – The number of times your video was viewed to 50% of its length, including views that skipped to this point
17. Total Views (75%) – The number of times your video was viewed to 75% of its length, including views that skipped to this point
18. Total Views (95%) – not supported by Facebook API 4.0
19. Number of Records – Number of Records

Templates

1. Ads. Number of Actions over the last 30 days – View the total number of actions people took that are attributed to your ads. Actions may include engagement, clicks or conversions.
2. Number of Actions by Action Type (last 30 days) – View the number of actions by action type for ads in a given time period.