The Insights API can return several metrics which are estimated or in-development. In some cases a metric may be bothestimated and in-development. Insights breakdown values are estimated. For more information, see Insights API, Estimated and Deprecated Metrics.

Breakdowns

The following breakdowns are available.

age

country

dma

gender

frequency_value

hourly_stats_aggregated_by_advertiser_time_zone

hourly_stats_aggregated_by_audience_time_zone

impression_device

place_page_id

publisher_platform

platform_position

device_platform

product_id

region

ad_format_asset

body_asset

call_to_action_asset

description_asset

image_asset

link_url_asset

title_asset

video_asset

Notes:

frequency_value is used with reach only. For example, how frequently a unique user saw an ad.

By design, image_asset and video_asset breakdowns are not available at the ad account level for assets used in Dynamic Creative.

Hourly Breakdowns

Hourly stats are now an available breakdown using the following breakdowns:

hourly_stats_aggregated_by_advertiser_time_zone

hourly_stats_aggregated_by_audience_time_zone

See Combining Breakdowns for limits on number of breakdowns you may request with the hourly breakdown. Hourly breakdowns do not support unique fields, which are any fields prepended with unique_*, reach or frequency. reach and frequency fields will return 0 when hourly breakdowns are in use.

In this example, post_engagement is a sum of link_click, comment, like, and post_reaction where post_reaction is the count of all Reactions, including likes. total_actions is a sum of top-level actions for an object such as page_engagement, mobile_app_install, and app_custom_event.

Combining Breakdowns

Due to storage constraints, only some permutations of breakdowns are available. Permutations marked with an asterisk (*) can be joined with action_type, action_target_id and action_destination which is the name for action_target_id.