洞察報告 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 傳回離線網路衡量指標，但不包含資料解析值。使用這些資料解析進行查詢時，系統將不再傳回行動衡量指標。

注意：上述資料解析仍將支援 Meta 站內衡量指標，例如曝光次數、連結點擊次數等。這些變更亦不會影響 2021 年 4 月 27 日之前的歷史資料，歷史資料的資料解析將可繼續使用。

操作衡量指標

若發生下列情況，將無法使用衡量指標：

• 嘗試在多個歸因設定之間彙整時
• 要求受影響的資料解析時（此限制僅適用於 Meta 站外和操作類型）。

注意：如果透過 action_attribution_windows=1d_click,7d_click,1d_view 查詢（不包括預設視窗），則可使用衡量指標。

一般資料解析

您可使用以下資料解析。

註

• 目前不支援使用 filtering 欄位篩選 app_id 和 skan_conversion_id。
• dma 資料解析不適用於 estimated_ad_recall_rate 衡量指標或 video_thruplay_watched_actions 衡量指標。
• 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。