成效分析 API 细分条件

您可以利用细分条件将成效分析 API 结果分成不同的组。

成效分析 API 可以返回一些已做出预估和/或逐步发展的指标。成效分析细分条件值为预估结果。详情请参阅成效分析 API 下的“预估指标和停用指标”部分。

限制

不可使用的字段

指定细分条件时，无法请求下列字段：

• app_store_clicks
• newsfeed_avg_position
• newsfeed_clicks
• relevance_score
• newsfeed_impressions

Meta 站外操作指标限制

以下细分条件将不再适用于 Meta 站外操作指标。

类型 1

• region
• dma
• hourly_stats_aggregated_by_audience_time_zone
• hourly_stats_aggregated_by_advertiser_time_zone

类型 2

• action_device
• action_destination
• action_target_id
• product_id
• action_carousel_card_id/action_carousel_card_name
• action_canvas_component_name

包含以上细分条件的查询的相关规则：

• 类型 1 — 成效分析 API 不会返回不支持的站外指标（例如，包含类型 1 细分条件的操作指标）。
• 类型 2 — 成效分析 API 将继续返回站外网站指标，但这些指标中不包含细分条件的值。使用这些细分条件进行查询时，成效分析 API 将不再返回移动指标。

注意：Meta 站内指标（例如，展示次数、链接点击量等）仍然支持以上列出的细分条件。更改也不会对 2021 年 4 月 27 日之前的历史数据产生影响；历史数据的细分条件将继续可用。

操作指标

指标在以下情景中不可用：

• 当用户试图跨多个归因设置进行整合时
• 当请求中涵盖受影响的细分条件时（此限制仅适用于 Meta 站外和操作类型）。

注意：当使用 action_attribution_windows=1d_click,7d_click,1d_view（不包含默认时间窗）一起查询时，指标可用。

一般细分条件

可使用下列细分条件。

注意事项

• 当前不支持使用 filtering 字段筛选 app_id 和 skan_conversion_id。
• estimated_ad_recall_rate 指标和 video_thruplay_watched_actions 指标不可使用 dma 细分条件。
• dma 细分条件使用取样方法来计算覆盖人数等独立指标。在 DMA 区域众多但广告量相对较少的情况下，这些独立指标可能不会在样本中体现出来，或者会按比例增加到 2 次方。因此，为了提高准确性，最好也查询相应的展示次数。
• frequency_value 仅能与 reach 结合使用。例如，独立用户观看广告的频次。
• 根据设计，动态素材中所用的素材在广告帐户层级不提供 image_asset 和 video_asset 细分条件。
• 广告操作video_p25_watched_actions、video_p50_watched_actions、video_p75_watched_actions、video_p95_watched_actions 以及 video_p100_watched_actions 不支持 region 细分条件。
• 所有的动态素材细分条件仅支持一套数量有限的指标：

下列调用会按照 age 和 gender 将结果分组。

curl -G \
  -d "breakdowns=age,gender" \
  -d "fields=impressions" \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"

每小时细分条件

每小时统计数据现包含下列细分条件：

• hourly_stats_aggregated_by_advertiser_time_zone
• hourly_stats_aggregated_by_audience_time_zone

请参阅组合细分条件，以了解您在使用每小时细分条件发送请求时，可以使用的细分条件数量上限。每小时细分条件不支持唯一字段（即以 unique_* 开头的任何字段）、reach 或 frequency。如果使用每小时细分条件，reach 和 frequency 字段将返回 0。

curl -G \
-d "fields=impressions" \
-d "breakdowns=hourly_stats_aggregated_by_audience_time_zone" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"

操作细分条件

对 actions 字段中的结果执行分组。您可以将下列细分条件用于 action_breakdowns：

action_breakdowns 字段可用的细分条件值如下所示。

• action_device
• conversion_destination
• matched_persona_id
• matched_persona_name
• signal_source_bucket
• standard_event_content_type
• action_canvas_component_name
• action_carousel_card_id
• action_carousel_card_name
• action_destination
• action_reaction
• action_target_id
• action_type
• action_video_sound
• action_video_type

在没有指定 action_breakdowns 参数的情况下，action_type 会被隐式添加为 action_breakdowns。

actions 总数

计算各组结果 (actions) 中返回的所有值的总和。

total_actions - 33
    page_engagement - 10
        post_engagement - 10
            link_click - 2
            comment - 3
            post_reaction - 3
            like - 2
    mobile_app_install - 12
    app_custom_event - 11
        app_custom_event.fb_mobile_activate_app - 6
        app_custom_event.other - 5

在此示例中，post_engagement 是 link_click、comment、like 和 post_reaction 的总和，其中 post_reaction 是包括赞在内的所有心情的计数。字段 total_actions 是对某个对象采取的高级操作次数之和，例如 page_engagement、mobile_app_install 和 app_custom_event。

组合细分条件

由于存储限制，只能使用部分细分条件的排列组合。带有星号 (*) 标记的排列可与 action_type、action_target_id 和 action_destination（action_target_id 的名称）组合使用。

限制

• 不能通过任何每小时统计细分条件来请求 video_* 字段。
• 不能通过区域细分条件来请求 video_avg_time_watched_actions 字段。
• 在没有指定 action_breakdowns 参数的情况下，action_type 会被隐式添加为 action_breakdowns。