Marketing API Version

Ad Keyword Stats

Stats specific to each interest, or keyword, targeted by an ad. Specify keywords for an ad in the ad set's targeting spec. Keywords arealso known as Interests in Ads Manager.

When someone sees an ad targeting multiple keywords, attribute the impression to all those interests if they fall in that interest segment.

If someone with sports and outdoor interests sees an ad targeting both, attribute 1 impression to sports and 1 to outdoor. If someone has only sports as an interest, attribute 1 impression to sports and 0 impressions to outdoor.

Limits

Can be query for the past 7 days excluding the current day. The IDs specified in ad_ids must be for ads active in the past 7 days and the ads must use interest targeting.

Reading

Stats on the ad's interest targeting options (previously known as keywords)

If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

FieldDescription

id

numeric string

Keyword id

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 actions.

clicks

unsigned int32

The total number of clicks on your ad. Depending on what you're promoting, this can include Page likes, event responses or app installs.

cost_per_total_action

float

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.

cost_per_unique_click

float

The average cost per unique click for these ads, calculated as the amount spent divided by the number of unique clicks received.

cpc

float

The average cost per click for these ads, calculated as the amount spent divided by the number of clicks received.

cpm

float

The average cost you've paid to have 1,000 impressions on your ad.

cpp

float

The average cost you've paid to have your ad served to 1,000 unique people.

ctr

float

The number of clicks you received divided by the number of impressions.

frequency

float

The average number of times your ad was served to each person.

impressions

unsigned int32

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.

name

string

Keyword name

reach

unsigned int32

The number of people your ad was served to. This is the same as unique_impressions.

spend

float

The total amount you've spent so far.

total_actions

unsigned int32

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.

total_unique_actions

unsigned int32

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.

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.

unique_clicks

unsigned int32

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.

unique_ctr

float

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%.

unique_impressions

unsigned int32

The number of people your ad was served to. This is the same as unique_impressions.

Edges

No edges

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.