Marketing API Version

Ads Action Stats

Reading

A single action for a Statistics result. Some fields that are marked default are returned only if you specify a breakdown for them.

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

1d_click

numeric string

Metric value of attribution window "1 day after clicking the ad"

1d_view

numeric string

Metric value of attribution window "1 day after viewing the ad"

28d_click

numeric string

Metric value of attribution window "28 days after clicking the ad"

28d_view

numeric string

Metric value of attribution window "28 days after viewing the ad"

7d_click

numeric string

Metric value of attribution window "7 days after clicking the ad"

7d_view

numeric string

Metric value of attribution window "7 days after viewing the ad"

action_canvas_component_name

string

Name of a component within a Canvas ad

action_carousel_card_id

string

The ID of the specific carousel card that people engaged with when they saw your ad.

action_carousel_card_name

string

The specific carousel card that people engaged with when they saw your ad. The cards are identified by their headlines.

action_destination

string

The destination where people go after clicking on your ad. This could be your Facebook Page, an external URL for your conversion pixel or an app configured with the software development kit (SDK).

action_device

string

The device on which the conversion event you're tracking occurred. For example, "Desktop" if someone converted on a desktop computer. Supported values are:
Other
Desktop
iPhone
iPad
iPod
Android Smartphone
Android Tablet
Offline
N/A

action_link_click_destination

string

The destination where people go after clicking link on your ad that directs people off Facebook.

action_reaction

string

The number of reactions on your ads or boosted posts. The reactions button on an ad allows people to share different reactions on its content: Like, Love, Haha, Wow, Sad or Angry.

action_target_id

string

The id of destination where people go after clicking on your ad. This could be your Facebook Page, an external URL for your conversion pixel or an app configured with the software development kit (SDK).

action_type

string

The kind 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. Action types include Page likes, app installs, conversions, event responses and more.
Actions prepended by app_custom_event come from mobile app events and actions prepended by offsite_conversion come from the Facebook Pixel.
app_custom_event.fb_mobile_achievement_unlocked: Mobile App Feature Unlocks
app_custom_event.fb_mobile_activate_app: Mobile App Starts
app_custom_event.fb_mobile_add_payment_info: Mobile App Payment Details
app_custom_event.fb_mobile_add_to_cart: Mobile App Adds To Cart
app_custom_event.fb_mobile_add_to_wishlist: Mobile App Adds to Wishlist
app_custom_event.fb_mobile_complete_registration: Mobile App Registrations
app_custom_event.fb_mobile_content_view: Mobile App Content Views
app_custom_event.fb_mobile_initiated_checkout: Mobile App Checkouts
app_custom_event.fb_mobile_level_achieved: Mobile App Achievements
app_custom_event.fb_mobile_purchase: Mobile App Purchases
app_custom_event.fb_mobile_rate: Mobile App Ratings
app_custom_event.fb_mobile_search: Mobile App Searchs
app_custom_event.fb_mobile_spent_credits: Mobile App Credit Spends
app_custom_event.fb_mobile_tutorial_completion: Mobile App Tutorial Completions
app_custom_event.other: Other Mobile App Actions
app_install: App Installs
app_use: App Uses
checkin: Check-ins
comment: Post Comments
commerce_event.add_to_cart: Commerce Adds to Cart
commerce_event.message_to_buy: Commerce Messages to Buy
commerce_event.purchase: Commerce Purchases
commerce_event.view_content: Commerce Product Views
credit_spent: Credit Spends
full_view: Post Full Views
games.plays: Game Plays
leadgen.other: Leads (Form)
like: Page Likes
link_click: Link Clicks
mention: Page Mentions
messenger.block: Message Blocks
messenger.reply: Message Replys
mobile_app_install: Mobile App Installs
new_mobile: Newly Purchased Mobile Devices
offsite_conversion.add_to_cart: Adds to Cart
offsite_conversion.checkout: Checkouts
offsite_conversion.custom.<custom_conv_id>: Custom Conversions defined by the advertiser
offsite_conversion.fb_pixel_add_payment_info: Adds Payment Info
offsite_conversion.fb_pixel_add_to_cart: Adds To Cart
offsite_conversion.fb_pixel_add_to_wishlist: Adds To Wishlist
offsite_conversion.fb_pixel_complete_registration: Completed Registration
offsite_conversion.fb_pixel_custom: Custom pixel events defined by the advertiser
offsite_conversion.fb_pixel_initiate_checkout: Initiates Checkout
offsite_conversion.fb_pixel_lead: Leads
offsite_conversion.fb_pixel_purchase: Purchases
offsite_conversion.fb_pixel_search: Searchs
offsite_conversion.fb_pixel_view_content: Views Content
offsite_conversion.key_page_view: Key Page Views
offsite_conversion.lead: Leads
offsite_conversion.other: Other Website Conversions
offsite_conversion.registration: Registrations
onsite_conversion.flow_complete: On-Facebook Workflow Completions
onsite_conversion.messaging_block: Blocked Messaging Conversations
onsite_conversion.messaging_first_reply: New Messaging Conversations
onsite_conversion.messaging_reply: Messaging Replies
onsite_conversion.purchase: On-Facebook Purchases
outbound_click: Outbound Clicks
photo_view: Page Photo Views
post: Post Shares
post_reaction: Post Reactions
receive_offer: Offer Claims
rsvp: Event Responses
tab_view: Page Tab Views
video_view: 3-Second Video Views

Grouped Action Types:
app_engagement
app_story
commerce_event
page_engagement
page_story
post_engagement
post_story
offsite_conversion
onsite_conversion
app_custom_event
mobile_app_retention
mobile_app_roas
offsite_engagement
offline_conversion
store_visit_with_dwell
add_to_cart
complete_registration
purchase
search
view_content

action_video_sound

string

The sound status (on/off) when user watches your video ad.

action_video_type

string

Video metrics breakdown.

value

numeric string

Metric value of default attribution window

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.