Reference
Dimensions & Metrics
Every dimension and metric AskYourAds.app can pull, per platform. Use this when you're not sure what to ask, or when the chat couldn't match a term you used.
Loading…
Show
click to toggle
336 of 336 fields
| Name | Description | Type | Additive | Synonyms |
|---|---|---|---|---|
| account_currency | Currency used for the account | Dimension | — | account currency, insights currency |
| account_id | The unique identifier of the Facebook advertising account associated with the image data. | Dimension | — | — |
| account_name | Name of the account | Dimension | — | account, accounts, account name, accounts names, account names, ad account, ads accounts, ad accounts |
| actor_id | The unique identifier for the actor (user/page) who performed the activity. | Dimension | — | — |
| actor_name | The name of the actor (user/page) who performed the activity. | Dimension | — | actor, actors |
| ad_breaks | Information about ad breaks within the video. | Dimension | — | — |
| ad_id | ID of the ad | Dimension | — | — |
| ad_name | Name of the ad | Dimension | — | ad, ads, ad name, ads names, ad names |
| adlabels | A collection of ad labels associated with the ad creative. | Dimension | — | ad label, ads labels, ad labels, label |
| adset_end | The end time of the ad set | Dimension | — | ad set end, adset end date, ad set end date, ads sets end dates |
| adset_id | The unique identifier for the ad set associated with the ad. | Dimension | — | — |
| adset_name | Name of the ad set | Dimension | — | ad set, ads sets, ad sets, adset, adsets, ad set name, ad set names, ads sets names, ad group, ads groups, ad groups |
| age_targeting | Age targeting specification for the ad | Dimension | — | age target, age targets, ages targets |
| application_id | The unique identifier for the application involved in the activity. | Dimension | — | application, applications |
| application_name | The name of the application involved in the activity. | Dimension | — | application name, application names, applications names, app name, app names, apps names |
| applink_treatment | Specifies how the app link is treated. | Dimension | — | — |
| asset_feed_spec | Specifies the asset customization rules, call to actions, and groups for the ad creative. | Dimension | — | — |
| attribution_setting | How conversions are attributed | Dimension | — | attribution, attribution model, attribution window |
| backdated_time | The time when the video was backdated. | Dimension | — | — |
| backdated_time_granularity | Granularity of the backdated time. | Dimension | — | — |
| bid_constraints | Bid constraints for the ad set. | Dimension | — | — |
| bid_info | Information about bidding in the ad set. | Dimension | — | — |
| bid_strategy | The bidding strategy used in the ad set. | Dimension | — | bidding strategy, bidding strategies, bid strategies, bids strategies |
| bid_type | The type of bid strategy used for the ad. | Dimension | — | bid type, bid types, bids types |
| body | The body text of the ad creative. | Dimension | — | ad body, body text, ad copy, ads copies, ad copies |
| boosted_object_id | The ID of the boosted object associated with the campaign. | Dimension | — | — |
| budget_rebalance_flag | A flag indicating whether the budget is set to rebalance. | Dimension | — | — |
| business | Information about the business associated with the custom conversion. | Dimension | — | — |
| buying_type | The type of buying for the campaign. | Dimension | — | — |
| call_to_action_type | The type of call-to-action for the ad creative. | Dimension | — | cta type, call to action type, call-to-action type |
| campaign_id | The unique identifier for the campaign associated with the ad. | Dimension | — | — |
| campaign_name | Name of the campaign | Dimension | — | campaign, campaigns, campaign name, campaign names, campaigns names, marketing campaign, marketing campaigns |
| configured_status | The configured status of the campaign. | Dimension | — | configured state, configured states |
| content_category | The category of the video content. | Dimension | — | content categories, video category, video categories, videos categories |
| content_tags | Tags associated with the video content. | Dimension | — | content tag, tags |
| conversion_rate_ranking | Ranking based on conversion rates | Dimension | — | cvr ranking |
| conversion_specs | Specifications for tracking conversions | Dimension | — | — |
| created_time | The date and time when the image was initially created. | Dimension | — | — |
| creation_time | Date and time when the custom conversion was created. | Dimension | — | custom conversion creation time, conversion created at |
| creative | Details of the creative used in the ad | Dimension | — | creatives details, creative details, ad creative |
| creative_media_type | The media type of the creative | Dimension | — | media type, creative type |
| creatives | Additional information or metadata related to the image. | Dimension | — | — |
| custom_event_type | Type of custom event triggering the conversion. | Dimension | — | custom events types, custom event types, customs events types |
| custom_labels | Custom labels assigned to the video. | Dimension | — | custom label |
| customer_file_source | The source of the customer file used to create the custom audience. | Dimension | — | — |
| data_source | Information about the source of the custom audience. | Dimension | — | — |
| data_sources | Data sources related to the custom conversion. | Dimension | — | — |
| date_start | Start date of the data | Dimension | — | start date, start day, from date |
| date_stop | End date of the data | Dimension | — | end date, stop date, to date, end day |
| date_time_in_timezone | The date and time of the activity adjusted to the timezone. | Dimension | — | — |
| dda_results | DDA results | Dimension | — | — |
| delivery_status | Status of the delivery related to the custom audience. | Dimension | — | delivery state |
| description | Description or any additional information related to the custom audience. | Dimension | — | descriptions |
| effective_instagram_media_id | The effective Instagram story ID associated with the ad creative. | Dimension | — | — |
| effective_object_story_id | The effective object story ID for the ad creative. | Dimension | — | — |
| effective_status | The effective status of the ad set (e.g., active, paused). | Dimension | — | effective state, effective states, delivery status, current status |
| embed_html | HTML code for embedding the video. | Dimension | — | — |
| embeddable | Flag indicating if the video is embeddable. | Dimension | — | — |
| end_time | The date and time when the ad set will end. | Dimension | — | adset end time, campaign end time, scheduled end |
| engagement_rate_ranking | Ranking based on engagement rate | Dimension | — | engagement ranking |
| event_source_type | Type of event source triggering the custom conversion. | Dimension | — | event source |
| event_time | The exact date and time when the activity occurred. | Dimension | — | event date, events times |
| event_type | The type of event/action performed in the activity. | Dimension | — | events types, event types |
| extra_data | Additional data associated with the activity. | Dimension | — | — |
| filename | The name of the file containing the image data. | Dimension | — | file name, files names, file names |
| first_fired_time | Date and time when the custom conversion was first triggered. | Dimension | — | first fired date, first triggered time |
| format | Specifies the format of the video data being fetched. | Dimension | — | video format, videos formats, video formats |
| gender_targeting | Gender targeting specification for the ad | Dimension | — | gender target, genders targets |
| hash | A unique hash value generated for the image. | Dimension | — | — |
| icon | Icon associated with the video. | Dimension | — | — |
| id | The unique identifier for the custom audience. | Dimension | — | — |
| image_crops | Cropped versions of the main image used in the ad creative. | Dimension | — | — |
| image_hash | Hash value representing the image used in the ad creative. | Dimension | — | — |
| image_url | URL of the main image used in the ad creative. | Dimension | — | image url, images urls, image urls |
| instagram_permalink_url | Permalink URL of the ad creative on Instagram. | Dimension | — | — |
| instagram_user_id | Instagram actor ID associated with the ad creative. | Dimension | — | — |
| instant_experience_clicks_to_start | Clicks to start instant experience | Dimension | — | instant experience starts |
| is_archived | Flag indicating if the custom conversion is archived. | Dimension | — | archived |
| is_associated_creatives_in_adgroups | Indicates if the image is associated with creatives in ad groups. | Dimension | — | — |
| is_crosspost_video | Flag indicating if the video is a crosspost. | Dimension | — | — |
| is_crossposting_eligible | Flag indicating if the video is eligible for crossposting. | Dimension | — | — |
| is_episode | Flag indicating if the video is an episode of a series. | Dimension | — | — |
| is_instagram_eligible | Flag indicating if the video is eligible for posting on Instagram. | Dimension | — | — |
| is_unavailable | Flag indicating if the custom conversion is unavailable. | Dimension | — | — |
| is_value_based | Indicates if the custom audience is value-based or not. | Dimension | — | — |
| issues_info | Information on any issues related to the campaigns. | Dimension | — | — |
| labels | Labels associated with the ad | Dimension | — | insights labels, ads labels insights, ad labels insights |
| last_fired_time | Date and time when the custom conversion was last triggered. | Dimension | — | last fired date, last triggered time |
| last_updated_by_app_id | The unique identifier for the last app that updated the ad. | Dimension | — | — |
| learning_stage_info | Info about whether the ranking or delivery system is still learning for this ad set. | Dimension | — | learning stage, learning phase |
| link_og_id | Open Graph ID related to the link. | Dimension | — | — |
| link_url | URL associated with the ad creative. | Dimension | — | link url, links urls, link urls |
| live_status | Status of the live video. | Dimension | — | — |
| location | Location targeting for the ad | Dimension | — | location targeting |
| lookalike_audience_ids | IDs of lookalike audiences based on this custom audience. | Dimension | — | — |
| lookalike_spec | Specifications for creating lookalike audiences. | Dimension | — | lookalike specification, lookalike audience spec |
| marketing_messages_read_rate_benchmark | Marketing messages read rate benchmark | Dimension | — | — |
| marketing_messages_spend_currency | Currency for marketing messages spend | Dimension | — | — |
| name | The name or label assigned to the image. | Dimension | — | — |
| object_id | The unique identifier for the object (post/ad/etc.) related to the activity. | Dimension | — | — |
| object_name | The name/label of the object related to the activity. | Dimension | — | — |
| object_story_id | Story ID associated with the object. | Dimension | — | — |
| object_story_spec | Specification for the object story associated with the ad creative. | Dimension | — | — |
| object_type | The type/category of the object related to the activity. | Dimension | — | — |
| object_url | URL of the associated object. | Dimension | — | — |
| objective | The objective of the campaign. | Dimension | — | — |
| objective_results | The objective results for the ad | Dimension | — | objective result |
| offline_conversion_data_set | If applicable, the data set for offline conversions. | Dimension | — | — |
| operation_status | Status of ongoing operations related to the custom audience. | Dimension | — | — |
| opt_out_link | The link for opting out of the custom audience. | Dimension | — | — |
| optimization_goal | Goal for optimization | Dimension | — | optimization goals, optimization target |
| permalink_url | The permanent URL where the image can be accessed or viewed. | Dimension | — | permalink, permanent url, permanent urls |
| permission_for_actions | Permissions granted for actions associated with the custom audience. | Dimension | — | — |
| pixel_id | The ID of the pixel associated with the custom audience. | Dimension | — | pixel, pixels |
| place_page_name | Name of the place page | Dimension | — | place page, place pages names |
| premiere_living_room_status | Status of the video premiere in living rooms. | Dimension | — | — |
| product_brand | Product brand | Dimension | — | product brands, products brands, brand, brands |
| product_category | Product category | Dimension | — | products categories, product categories, category, categories |
| product_content_id | Product content ID | Dimension | — | products content ids, product content ids |
| product_custom_label_0 | Product custom label 0 | Dimension | — | custom label 0 |
| product_custom_label_1 | Product custom label 1 | Dimension | — | custom label 1 |
| product_custom_label_2 | Product custom label 2 | Dimension | — | custom label 2 |
| product_custom_label_3 | Product custom label 3 | Dimension | — | custom label 3 |
| product_custom_label_4 | Product custom label 4 | Dimension | — | custom label 4 |
| product_group_content_id | Product group content ID | Dimension | — | — |
| product_group_retailer_id | Product group retailer ID | Dimension | — | — |
| product_name | Product name | Dimension | — | products names, product names |
| product_retailer_id | Product retailer ID | Dimension | — | products retailers ids |
| product_set_id | ID of the product set linked to the ad creative. | Dimension | — | product set, products sets, product sets |
| product_views | Product views | Dimension | — | product view, products views |
| promoted_object | Information about the object being promoted in the ad set. | Dimension | — | promoted objects |
| published | Flag indicating if the video is published. | Dimension | — | — |
| quality_ranking | Ranking based on quality | Dimension | — | ad quality ranking |
| recommendations | Recommended actions or strategies for the ad | Dimension | — | recommendation |
| result_values_performance_indicator | Result values performance indicator | Dimension | — | — |
| results | The results for the ad based on the objective | Dimension | — | result |
| rule | The rule or condition used to define the custom audience. | Dimension | — | rules |
| rule_aggregation | The aggregation method used for rules in the custom audience. | Dimension | — | — |
| scheduled_publish_time | Scheduled time for publishing the video. | Dimension | — | — |
| sharing_status | Status of sharing permissions for the custom audience. | Dimension | — | — |
| shops_assisted_purchases | Shops assisted purchases | Dimension | — | shops assisted purchase |
| smart_promotion_type | The type of smart promotion used for the campaign. | Dimension | — | — |
| source | Source of the video. | Dimension | — | — |
| source_ad_id | The source ad identifier, if the ad was copied from another ad. | Dimension | — | — |
| source_campaign_id | The ID of the source campaign, if any. | Dimension | — | — |
| source_instagram_media_id | ad_creatives.source_instagram_media_id | Dimension | — | — |
| special_ad_category | The special ad category associated with the campaign. | Dimension | — | special ads categories, special ad categories, specials ads categories |
| special_ad_category_country | The country associated with the special ad category. | Dimension | — | — |
| start_time | The date and time when the ad set will start. | Dimension | — | adset start time, campaign start time, scheduled start |
| status | The current status or state of the image data. | Dimension | — | — |
| stop_time | The end date and time of the campaign. | Dimension | — | campaign stop time, campaign scheduled end |
| subtype | The subtype of the custom audience. | Dimension | — | subtypes, audience subtype |
| targeting | The targeting parameters set for the ad set. | Dimension | — | — |
| template_url | URL of the template used in the ad creative. | Dimension | — | — |
| template_url_spec | Specification for the template URL. | Dimension | — | — |
| thumbnail_data_url | URL of the thumbnail data. | Dimension | — | — |
| thumbnail_url | URL of the thumbnail image. | Dimension | — | thumbnail, thumbnails, thumbnails urls |
| title | Title or name of the video. | Dimension | — | — |
| total_card_view | Total card views | Dimension | — | total card views, card views |
| total_postbacks | Total postbacks | Dimension | — | total postback, postbacks |
| total_postbacks_detailed | Total postbacks detailed | Dimension | — | — |
| total_postbacks_detailed_v4 | Total postbacks detailed v4 | Dimension | — | — |
| tracking_specs | Specifications for tracking ad performance | Dimension | — | — |
| translated_event_type | The translated or localized version of the event type. | Dimension | — | — |
| universal_video_id | Universal unique ID for the video. | Dimension | — | — |
| updated_time | The date and time when the image data was last updated. | Dimension | — | — |
| url | The URL pointing to the image file. | Dimension | — | urls, image file url |
| url_128 | The URL pointing to a lower resolution (128px) version of the image file. | Dimension | — | — |
| url_tags | Tags added to the URL of the ad creative. | Dimension | — | url tag, urls tags |
| video_id | ID of the video used in the ad creative. | Dimension | — | video, videos |
| video_play_curve_actions | Actions on the video play curve | Dimension | — | video play curve, video retention curve |
| action_values | Action values taken on the ad | Metric | Yes | action value, actions values, values of actions, value of actions |
| actions | Total number of actions taken | Metric | Yes | action, events, event, engagement, engagements, interaction, interactions, total actions, total action, view-through conversions, view through conversions, view-through |
| ad_click_actions | Actions taken that are clicks on the ad | Metric | Yes | ad click action, ads clicks actions, ad clicks actions, click action, click actions, clicks actions |
| ad_impression_actions | Actions triggered by ad impressions | Metric | Yes | ad impression action, impression action, impression actions, impressions actions |
| approximate_count_lower_bound | An estimated lower bound count of the size of the custom audience. | Metric | Yes | audience lower bound, audience size lower bound |
| approximate_count_upper_bound | An estimated upper bound count of the size of the custom audience. | Metric | Yes | audience upper bound, audience size upper bound |
| auction_bid | Bid amount in the auction | Metric |
No
duration_avg
|
bid, bids, auction bid amount |
| auction_competitiveness | Competitiveness level in the auction | Metric | No | competitiveness, auction competition |
| auction_max_competitor_bid | Maximum bid among the competitors in the auction | Metric |
No
duration_avg
|
max competitor bid, competitor bid, competitors bids |
| average_purchases_conversion_value | Average value of purchase conversions | Metric |
No
ratio
|
avg purchase conversion value, average purchase conversion value, avg purchases conversions values, avg purchases conversion values |
| bid_amount | The amount set for bidding in the ad set. | Metric | Yes | bid amount, bid amounts, bids amounts |
| budget_remaining | The remaining budget for the campaign. | Metric | Yes | — |
| canvas_avg_view_percent | Average percentage of the canvas viewed | Metric |
No
ratio
|
avg canvas view percent, average canvas view percent, canvas view percentage |
| canvas_avg_view_time | Average time spent viewing the canvas | Metric |
No
duration_avg
|
avg canvas view time, average canvas view time, canvas view time |
| catalog_segment_actions | Actions on specific catalog segments | Metric | Yes | catalog actions, catalog segment action |
| catalog_segment_value | Value attributed to catalog segments | Metric | Yes | catalog value |
| catalog_segment_value_mobile_purchase_roas | Mobile purchase return on ad spend for catalog segments | Metric |
No
ratio
|
catalog mobile purchase roas, catalog mobile roas |
| catalog_segment_value_omni_purchase_roas | Omni-channel purchase return on ad spend for catalog segments | Metric |
No
ratio
|
catalog omni purchase roas, catalog omni roas |
| catalog_segment_value_website_purchase_roas | Website purchase return on ad spend for catalog segments | Metric |
No
ratio
|
catalog website purchase roas, catalog website roas |
| clicks | Total number of clicks | Metric | Yes | click, tap, taps, click count, clicks count, total clicks, total click, all clicks |
| conversion_leads | Number of conversion leads | Metric | Yes | conversion lead, conversions leads, lead conversion, leads conversions |
| conversion_values | Values from conversions | Metric | Yes | conversion value, conversions values, values of conversions, value of conversions, purchase value, purchase values, purchases values |
| conversions | Total number of conversions | Metric | Yes | conversion, total conversions, total conversion, conversion count, conversions count |
| converted_product_app_custom_event_fb_mobile_purchase | Converted product app custom event for mobile purchase | Metric | Yes | — |
| converted_product_app_custom_event_fb_mobile_purchase_value | Value of converted product app custom event for mobile purchase | Metric | Yes | — |
| converted_product_offline_purchase | Converted product offline purchase | Metric | Yes | — |
| converted_product_offline_purchase_value | Value of converted product offline purchase | Metric | Yes | — |
| converted_product_omni_purchase | Converted product omni-channel purchase | Metric | Yes | — |
| converted_product_omni_purchase_values | Values of converted product omni-channel purchase | Metric | Yes | — |
| converted_product_quantity | Quantity of products converted | Metric | Yes | converted products quantity, products converted quantity |
| converted_product_value | Value of products converted | Metric | Yes | converted products value, products converted value |
| converted_product_website_pixel_purchase | Converted product website pixel purchase | Metric | Yes | — |
| converted_product_website_pixel_purchase_value | Value of converted product website pixel purchase | Metric | Yes | — |
| converted_promoted_product_app_custom_event_fb_mobile_purchase | Converted promoted product app custom event for mobile purchase | Metric | Yes | — |
| converted_promoted_product_app_custom_event_fb_mobile_purchase_value | Value of converted promoted product app custom event for mobile purchase | Metric | Yes | — |
| converted_promoted_product_offline_purchase | Converted promoted product offline purchase | Metric | Yes | — |
| converted_promoted_product_offline_purchase_value | Value of converted promoted product offline purchase | Metric | Yes | — |
| converted_promoted_product_omni_purchase | Converted promoted product omni-channel purchase | Metric | Yes | — |
| converted_promoted_product_omni_purchase_values | Values of converted promoted product omni-channel purchase | Metric | Yes | — |
| converted_promoted_product_quantity | Quantity of converted promoted products | Metric | Yes | — |
| converted_promoted_product_value | Value of converted promoted products | Metric | Yes | — |
| converted_promoted_product_website_pixel_purchase | Converted promoted product website pixel purchase | Metric | Yes | — |
| converted_promoted_product_website_pixel_purchase_value | Value of converted promoted product website pixel purchase | Metric | Yes | — |
| cost_per_15_sec_video_view | Cost per 15-second video view | Metric |
No
ratio
|
cost per 15 second video view, cost per 15-sec video view, cost per 15s video view |
| cost_per_2_sec_continuous_video_view | Cost per 2-second continuous video view | Metric |
No
ratio
|
cost per 2 second video view, cost per 2-sec continuous video view, cost per 2s video view |
| cost_per_action_type | Cost per specific action type | Metric |
No
ratio
|
cost per action, cost per actions, cpa per action type |
| cost_per_ad_click | Cost per ad click | Metric |
No
ratio
|
cost per ad clicks, cost per ads clicks |
| cost_per_conversion | Cost per conversion | Metric |
No
ratio
|
cpa, cost per acquisition, cost / conv., cost per conv, cost per conversions |
| cost_per_dda_countby_convs | Cost per DDA count-by conversions | Metric |
No
ratio
|
cost per dda conversion, dda cost per conversion |
| cost_per_estimated_ad_recallers | Cost per estimated ad recallers | Metric |
No
ratio
|
cost per ad recaller, cost per estimated recall |
| cost_per_inline_link_click | Cost per inline link click | Metric |
No
ratio
|
cost per inline link clicks, cost per inline links clicks, inline link click cost |
| cost_per_inline_post_engagement | Cost per inline post engagement | Metric |
No
ratio
|
cost per inline engagement, cost per inline post engagement |
| cost_per_objective_result | Cost per objective result | Metric |
No
ratio
|
cost per objective |
| cost_per_one_thousand_ad_impression | Cost per one thousand ad impressions | Metric |
No
ratio
|
cost per thousand ads impressions, cost per thousand ad impressions, cost per 1000 ads impressions, cost per 1000 ad impressions, cpm ad |
| cost_per_outbound_click | Cost per outbound click | Metric |
No
ratio
|
cost per outbound clicks, outbound cpc |
| cost_per_result | Cost per result | Metric |
No
ratio
|
cost per results |
| cost_per_thruplay | Cost per thruplay | Metric |
No
ratio
|
cost per thru play, cost per video thruplay |
| cost_per_unique_action_type | Cost per unique action type | Metric |
No
ratio
|
cost per unique action, cost per unique actions |
| cost_per_unique_click | Cost per unique click | Metric |
No
ratio
|
cost per unique clicks, unique cpc |
| cost_per_unique_conversion | Cost per unique conversion | Metric |
No
ratio
|
cost per unique conversions |
| cost_per_unique_inline_link_click | Cost per unique inline link click | Metric |
No
ratio
|
cost per unique inline links clicks, cost per unique inline link clicks |
| cost_per_unique_outbound_click | Cost per unique outbound click | Metric |
No
ratio
|
cost per unique outbound clicks |
| cpc | Cost per click | Metric |
No
ratio
|
cost per click, cost per clicks, average cpc, avg cpc |
| cpm | Cost per thousand impressions | Metric |
No
ratio
|
cost per mille, cost per thousand impressions, cost per thousand impression, cost per 1000 impressions |
| cpp | Cost per thousand people reached | Metric |
No
ratio
|
cost per 1000 reached, cost per thousand reached, cost per thousand people reached, cost per mille reach |
| ctr | Click-through rate | Metric |
No
ratio
|
click-through rate, click-through rates, click through rate, click through rates, clicks through rates, clickthrough rate, clickthrough rates |
| daily_budget | The daily budget set for the campaign. | Metric | No | — |
| dda_countby_convs | DDA count-by conversions | Metric | Yes | dda conversions, dda count conversions |
| default_conversion_value | Default value assigned to the conversion event if no specific value is provided. | Metric | No | default value |
| estimated_ad_recall_rate | Estimated ad recall rate | Metric |
No
ratio
|
ad recall rate, ad recall rates, ads recall rates |
| estimated_ad_recall_rate_lower_bound | Lower bound of estimated ad recall rate | Metric |
No
ratio
|
— |
| estimated_ad_recall_rate_upper_bound | Upper bound of estimated ad recall rate | Metric |
No
ratio
|
— |
| estimated_ad_recallers | Estimated ad recallers | Metric |
No
dedup_count
|
estimated ad recaller, ad recallers, ads recallers, estimated recall |
| estimated_ad_recallers_lower_bound | Lower bound of estimated ad recallers | Metric | Yes | — |
| estimated_ad_recallers_upper_bound | Upper bound of estimated ad recallers | Metric | Yes | — |
| frequency | Average number of times each person saw the ad | Metric |
No
ratio
|
freq, average frequency, avg frequency, frequencies |
| full_view_impressions | Impressions when the ad is fully viewed | Metric | Yes | full view impression, fully viewed impressions |
| full_view_reach | Reach when the ad is fully viewed | Metric |
No
dedup_count
|
fully viewed reach |
| height | The height dimension of the image in pixels. | Metric | No | image height, images heights, height in pixels |
| impressions | Total number of impressions | Metric | Yes | impression, ad impression, ads impressions, ad impressions, show, shows, total impressions, total impression |
| inline_link_click_ctr | Click-through rate for inline link clicks | Metric |
No
ratio
|
inline ctr, inline link ctr |
| inline_link_clicks | Total number of inline link clicks | Metric | Yes | inline link click, link clicks, links clicks, link click |
| inline_post_engagement | Engagement on inline posts | Metric | Yes | inline post engagements, post engagement, post engagements |
| instagram_upcoming_event_reminders_set | Number of Instagram upcoming event reminders set | Metric | Yes | — |
| instant_experience_clicks_to_open | Clicks to open instant experience | Metric | Yes | instant experience opens |
| instant_experience_outbound_clicks | Outbound clicks from instant experiences | Metric | Yes | instant experience outbound click |
| interactive_component_tap | Interactive component taps | Metric | Yes | interactive component taps, interactive taps |
| landing_page_view_actions_per_link_click | Landing page view actions per link click | Metric |
No
ratio
|
landing page views per link click, lpv per link click |
| landing_page_view_per_link_click | Landing page views per link click | Metric |
No
ratio
|
lpv per click |
| landing_page_view_per_purchase_rate | Landing page view per purchase rate | Metric |
No
ratio
|
lpv to purchase rate |
| length | Duration of the video. | Metric | Yes | video length, video duration, duration |
| lifetime_budget | The lifetime budget set for the campaign. | Metric | No | — |
| link_clicks_per_results | Link clicks per results | Metric |
No
ratio
|
link clicks per result |
| marketing_messages_click_rate_benchmark | Marketing messages click rate benchmark | Metric |
No
ratio
|
— |
| marketing_messages_cost_per_delivered | Marketing messages cost per delivered | Metric |
No
ratio
|
cost per delivered marketing message |
| marketing_messages_cost_per_link_btn_click | Marketing messages cost per link button click | Metric |
No
ratio
|
marketing messages cost per link button click |
| marketing_messages_delivered | Number of marketing messages delivered | Metric | Yes | delivered marketing messages |
| marketing_messages_delivery_rate | Marketing messages delivery rate | Metric |
No
ratio
|
— |
| marketing_messages_link_btn_click | Marketing messages link button clicks | Metric | Yes | marketing messages link button click, marketing messages links button clicks, marketing messages link button clicks |
| marketing_messages_link_btn_click_rate | Marketing messages link button click rate | Metric |
No
ratio
|
marketing messages link button click rate |
| marketing_messages_media_view_rate | Marketing messages media view rate | Metric |
No
ratio
|
— |
| marketing_messages_phone_call_btn_click_rate | Marketing messages phone call button click rate | Metric |
No
ratio
|
marketing messages phone call button click rate |
| marketing_messages_quick_reply_btn_click | Marketing messages quick reply button clicks | Metric | Yes | marketing messages quick reply button click, marketing messages quick reply button clicks |
| marketing_messages_quick_reply_btn_click_rate | Marketing messages quick reply button click rate | Metric |
No
ratio
|
marketing messages quick reply button click rate |
| marketing_messages_read | Number of marketing messages read | Metric | Yes | read marketing messages |
| marketing_messages_read_rate | Marketing messages read rate | Metric |
No
ratio
|
— |
| marketing_messages_sent | Number of marketing messages sent | Metric | Yes | sent marketing messages |
| marketing_messages_spend | Marketing messages spend | Metric | Yes | marketing messages cost |
| marketing_messages_website_add_to_cart | Marketing messages website add to cart | Metric | Yes | marketing messages website atc |
| marketing_messages_website_initiate_checkout | Marketing messages website initiate checkout | Metric | Yes | — |
| marketing_messages_website_purchase | Marketing messages website purchase | Metric | Yes | marketing messages website purchases |
| marketing_messages_website_purchase_values | Marketing messages website purchase values | Metric | Yes | — |
| mobile_app_purchase_roas | Return on ad spend for mobile app purchases | Metric |
No
ratio
|
mobile app roas, app purchase roas |
| objective_result_rate | Objective result rate | Metric |
No
ratio
|
objective rate |
| onsite_conversion_messaging_detected_purchase_deduped | Onsite conversion messaging detected purchase | Metric | Yes | onsite messaging purchase deduped, messaging detected purchase |
| original_height | The original height dimension of the image in pixels. | Metric | No | original image height |
| original_width | The original width dimension of the image in pixels. | Metric | No | original image width |
| outbound_clicks | Total outbound clicks | Metric | Yes | outbound click, external clicks, external click |
| outbound_clicks_ctr | Click-through rate for outbound clicks | Metric |
No
ratio
|
outbound click ctr, outbound ctr |
| page_deletion_marked_delete_time | The time when the page deletion was marked for deletion. | Metric | No | — |
| post_views | Number of views on the video post. | Metric | Yes | post view, videos post views, video post views |
| purchase_per_landing_page_view | Purchase per landing page view | Metric |
No
ratio
|
purchases per lpv |
| purchase_roas | Return on ad spend for purchases | Metric |
No
ratio
|
roas, return on ad spend, purchase return on ad spend, return on advertising spend |
| purchases_per_link_click | Purchases per link click | Metric |
No
ratio
|
purchase per link click |
| qualifying_question_qualify_answer_rate | Rate of qualifying question answer qualification | Metric |
No
ratio
|
— |
| reach | Number of people who saw the ad | Metric |
No
dedup_count
|
unique users, unique user, people reached |
| result_rate | Result rate | Metric |
No
ratio
|
result rates, results rates |
| retention_days | The number of days data for the custom audience will be retained. | Metric | No | retention period, retention window |
| social_spend | Spend in social channels | Metric | Yes | social cost, social channel spend |
| spend | Total amount spent | Metric | Yes | cost, ad spend, ad cost, money spent, amount spent, total spend, total cost |
| spend_cap | The spend cap set for the campaign. | Metric | No | spend caps, spending cap, budget cap |
| time_content_updated | The time when the content of the custom audience was last updated. | Metric | No | — |
| time_created | The time when the custom audience was created. | Metric | No | custom audience created at, audience created time |
| time_updated | The time when the custom audience was last updated. | Metric | No | custom audience updated at, audience updated time |
| unique_actions | Total number of unique actions taken | Metric |
No
dedup_count
|
unique action, unique events, unique event |
| unique_clicks | Total number of unique clicks | Metric |
No
dedup_count
|
unique click, unique tap, unique taps |
| unique_conversions | Unique conversions | Metric |
No
dedup_count
|
unique conversion |
| unique_ctr | Unique click-through rate | Metric |
No
ratio
|
unique click-through rate, unique click through rate |
| unique_inline_link_click_ctr | Unique click-through rate for inline link clicks | Metric |
No
ratio
|
unique inline link ctr |
| unique_inline_link_clicks | Total number of unique inline link clicks | Metric |
No
dedup_count
|
unique inline link click |
| unique_link_clicks_ctr | Unique click-through rate for link clicks | Metric |
No
ratio
|
unique link click ctr |
| unique_outbound_clicks | Total number of unique outbound clicks | Metric |
No
dedup_count
|
unique outbound click |
| unique_outbound_clicks_ctr | Unique click-through rate for outbound clicks | Metric |
No
ratio
|
unique outbound ctr |
| unique_video_continuous_2_sec_watched_actions | Unique video continuous 2 second watched actions | Metric |
No
dedup_count
|
unique 2 second videos views, unique 2 second video views, unique 2-sec videos views, unique 2-sec video views |
| unique_video_view_15_sec | Unique video views of 15 seconds | Metric |
No
dedup_count
|
unique 15 second video view, unique 15-sec video view, unique 15s video view, unique 15 second videos views, unique 15 second video views |
| video_15_sec_watched_actions | Actions where 15 seconds of the video were watched | Metric | Yes | 15 second video view, 15 second videos views, 15 second video views, 15s video view, 15s videos views, 15s video views, 15-sec video view, 15-sec videos views, 15-sec video views |
| video_30_sec_watched_actions | Actions where 30 seconds of the video were watched | Metric | Yes | 30 second video view, 30 second videos views, 30 second video views, 30s video view, 30s videos views, 30s video views, 30-sec video view, 30-sec videos views, 30-sec video views |
| video_avg_time_watched_actions | Average time video was watched | Metric |
No
duration_avg
|
avg video watch time, average video watch time, average time video watched |
| video_continuous_2_sec_watched_actions | Actions where video was continuously watched for 2 seconds | Metric | Yes | 2 second video view, 2 second videos views, 2 second video views, 2-sec video view, 2-sec video views, 2-sec videos views, 2s video view, 2s videos views, 2s video views |
| video_p100_watched_actions | Actions where 100% of the video was watched | Metric | Yes | video completion, videos completions, video completions, 100% video view, 100% video views, 100% videos views, video view to 100%, video 100% |
| video_p25_watched_actions | Actions where 25% of the video was watched | Metric | Yes | video view to 25%, video views to 25%, video 25%, video first quartile, 25% video view, 25% videos views, 25% video views |
| video_p50_watched_actions | Actions where 50% of the video was watched | Metric | Yes | video view to 50%, video views to 50%, video 50%, video midpoint, video second quartile, 50% video view, 50% video views, 50% videos views |
| video_p75_watched_actions | Actions where 75% of the video was watched | Metric | Yes | video view to 75%, video views to 75%, video 75%, video third quartile, 75% video view, 75% videos views, 75% video views |
| video_p95_watched_actions | Actions where 95% of the video was watched | Metric | Yes | video view to 95%, video views to 95%, video 95%, 95% video view, 95% videos views, 95% video views |
| video_play_actions | Actions where the video was played | Metric | Yes | video view, videos views, video views, video play, videos plays, video plays, total video view, total videos views, total video views, total video play, total videos plays, total video plays |
| video_play_retention_0_to_15s_actions | Actions on the video retention curve | Metric | Yes | video retention 0 to 15s, video retention 0-15 seconds |
| video_play_retention_20_to_60s_actions | Actions on the video retention curve | Metric | Yes | videos retention 20 to 60s, video retention 20 to 60s, video retention 20-60 seconds |
| video_play_retention_graph_actions | Actions on the video retention graph | Metric | Yes | video retention graph, video play retention |
| video_thruplay_watched_actions | Video thruplay watched actions | Metric | Yes | thruplay, thruplays, thru play, thru plays, video thruplay, videos thruplays, video thruplays |
| video_time_watched_actions | Actions where time was spent watching the video | Metric | Yes | video watch time, time spent watching video, video time watched |
| video_view_per_impression | Video view per impression | Metric |
No
ratio
|
video views per impression |
| views | Number of views on the video. | Metric | Yes | view, video view count |
| website_ctr | Click-through rate for the website | Metric |
No
ratio
|
website click through rate, website click-through rate |
| website_purchase_roas | Return on ad spend for website purchases | Metric |
No
ratio
|
website roas, web purchase roas |
| width | The width dimension of the image in pixels. | Metric | No | image width, images widths, width in pixels |