洞察報告 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（不含預設時限）查詢，則可取得衡量數據。

一般資料細節

您可使用下列資料細節。

資料細節	說明
`action_device`	您正在追蹤的轉換事件發生的裝置。例如，如果用戶在桌面電腦上完成轉換，則為「Desktop」。
`action_canvas_component_name`	全螢幕展示廣告中的元件名稱。
`action_carousel_card_id`	用戶看到您的廣告時展開互動的特定輪播圖卡編號。
`action_carousel_card_name`	用戶看到您的廣告時展開互動的特定輪播圖卡。這些圖卡均以其標題識別。
`action_destination`	用戶點擊您的廣告後前往的目的地。這可以是您的 Facebook 專頁、您轉換像素的外部網址，或使用軟件開發套件（SDK）配置的應用程式。
`action_reaction`	您的廣告或加強推廣帖子的心情數量。廣告的心情按鈕可讓用戶就其內容分享不同的反應，如：「讚好」、「勁正」、「哈哈」、「嘩」、「慘慘」或「嬲嬲」。
`action_target_id`	用戶點擊您的廣告後前往的目的地編號。這可以是您的 Facebook 專頁、您轉換像素的外部網址，或使用軟件開發套件 (SDK) 配置的應用程式。
`action_type`	系統向用戶展示廣告後（即使用戶沒有點擊廣告），您的廣告、專頁、應用程式或活動會採取的動作。動作類型包括：專頁讚好、應用程式安裝、轉換、活動回覆等。
`action_video_sound`	用戶播放您的影片廣告時的音效狀態（開啟／關閉）。
`action_video_type`	影片衡量數據資料細節。
`ad_format_asset`	與展示次數、點擊次數或動作有關的廣告格式素材編號
`age`	您接觸到的用戶之年齡範圍。
`app_id`	與所要求的廣告帳戶或宣傳活動相關的應用程式編號。應用程式資訊（包括其編號）可以於應用程式管理中心中查看。此資料細節僅由 `total_postbacks` 欄位支援。
`body_asset`	與展示次數、點擊次數或動作有關的正文素材編號。
`call_to_action_asset`	與展示次數、點擊次數或動作有關的呼籲字句素材編號。
`country`	您接觸到的用戶之所在國家／地區。這項資料將根據用戶家鄉、現居城市及他們瀏覽 Meta 時一般身處的地理位置等資訊而定。
`description_asset`	與展示次數、點擊次數或動作有關的說明素材編號。
`device_platform`	用戶在瀏覽或點擊廣告時使用的裝置類型（流動裝置或桌面電腦），具體如廣告分析報告中所示。
`dma`	指定市場區域（DMA）是尼爾森公司（Nielsen Company）用於評估當地電視收視的美國 210 個地理區域。
`frequency_value`	您的觸及率和頻率宣傳活動向每個帳戶管理中心帳戶展示某個廣告的次數。
`gender`	您接觸到的用戶之性別。用戶如果未有列出其性別，則會顯示為「未指定」。
`hourly_stats_aggregated_by_advertiser_time_zone`	按廣告展示次數彙整的每小時資料細節（以廣告客戶的時區計算）。例如，如果您的廣告已安排在上午 9 點至 11 點之間刊登，但它們所接觸的廣告受眾橫跨多個不同時區，則它們可能會在廣告客戶所在時區的上午 9 點至下午 1 點之間刊登。這些統計數據將彙整為四組：上午 9 點至上午 10 點、上午 10 點至上午 11 點、上午 11 點至中午 12 點，以及中午 12 點至下午 1 點。
`hourly_stats_aggregated_by_audience_time_zone`	按廣告展示次數彙整的每小時資料細節（以廣告受眾的時區計算）。例如，如果您的廣告已排定在上午 9 點至 11 點之間刊登，但它們所接觸的廣告受眾橫跨多個不同時區，則可能會在廣告客戶所在時區的上午 9 點至下午 1 點之間刊登。這些統計數據將彙整為兩組：上午 9 點至 10 點和上午 10 點至上午 11 點。
`image_asset`	與展示次數、點擊次數或動作有關的圖像素材編號。
`impression_device`	您向 Meta 用戶展示上一個廣告時，用戶正在使用的裝置。例如，如果用戶是在 iPhone 看到您的廣告，則為「iPhone」。
`is_conversion_id_modeled`	布林值標示代表 `conversion_bits` 是否已模型化。`0` 代表 `conversion_bits` 未模型化，`1` 代表 `conversion_bits` 已模型化。此資料細節僅由 `total_postbacks_detailed` 欄位支援。
`link_url_asset`	與展示次數、點擊次數或動作有關的網址素材編號。
`place_page_id`	與展示次數或點擊次數有關的地點專頁編號。帳戶級別洞察報告和 `page_place_id` 彼此並不相容，因此**無法一同查詢。
`platform_position`	您的廣告在某個平台內的具體展示位置，如 Facebook 桌面版動態消息或 Instagram 流動版動態消息。
`product_id`	與展示次數、點擊次數或動作有關的商品編號。
`publisher_platform`	您廣告的展示平台，如 Facebook、Instagram 或 Audience Network。
`region`	您接觸到的用戶之所在地區。這項資料將根據用戶家鄉、現居城市及他們瀏覽 Facebook 時一般身處的地理位置等資訊而定。
`skan_campaign_id`	原始宣傳活動編號；自 iOS 15+ 版本開始，系統接收此編號作為 SKAN 回傳的一部分。備註：此資料細節僅由 `total_postbacks_detailed` 欄位支援。
`skan_conversion_id`	針對應用程式 SKAdNetwork 配置架構中配置的事件和／或事件組合所指派的轉換編號（又稱為「優先順序編號」）。您可以在 Meta 事件管理工具中查看和調整應用程式事件配置。您可以前往此處進一步了解配置 Apple SKAdNetwork 應用程式事件的詳情。備註：此資料細節僅由 `total_postbacks` 欄位支援。
`title_asset`	與展示次數、點擊次數或動作有關的標題素材編號。
`user_segment_key`	進階高效速成購物宣傳活動（ASC）的用戶族群（例如全新族群、現有族群）。現有用戶由 ASC 設定中的自訂廣告受眾指定。
`video_asset`	與展示次數、點擊次數或動作有關的影片素材編號。

備註

目前不支援使用 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 資料細節。
所有活用型廣告創意素材資料細節只支援特定衡量數據：

活用型廣告創意資料細節	活用型廣告創意資料細節的支援衡量數據
`ad_format_asset` `body_asset` `call_to_action_asset` `description_asset` `image_asset` `link_url_asset` `title_asset` `video_asset`	`impressions` `clicks` `spend` `reach` `actions` `action_values`

下列呼叫依據 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 相等，這是因為 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 的名稱）結合。

排列組合
`action_converted_product_id`：僅供協作廣告使用。
`action_type *`
`action_type, action_converted_product_id`：僅供協作廣告使用。
`action_target_id *`
`action_device *`
`action_device, impression_device *`
`action_device, publisher_platform *`
`action_device, publisher_platform, impression_device *`
`action_device, publisher_platform, platform_position *`
`action_device, publisher_platform, platform_position, impression_device *`
`action_reaction`
`action_type, action_reaction`
`age *`
`gender *`
`age, gender *`
`app_id, skan_conversion_id`
`country *`
`region *`
`publisher_platform *`
`publisher_platform, impression_device *`
`publisher_platform, platform_position *`
`publisher_platform, platform_position, impression_device *`
`product_id *`
`hourly_stats_aggregated_by_advertiser_time_zone *`
`hourly_stats_aggregated_by_audience_time_zone *`
`action_carousel_card_id / action_carousel_card_name`
`action_carousel_card_id / action_carousel_card_name`
`action_carousel_card_id / action_carousel_card_name, impression_device`
`action_carousel_card_id / action_carousel_card_name, country`
`action_carousel_card_id / action_carousel_card_name, age`
`action_carousel_card_id / action_carousel_card_name, gender`
`action_carousel_card_id / action_carousel_card_name, age, gender`

限制

video_* 欄位無法配搭任何每小時統計資料細節要求。
video_avg_time_watched_actions 欄位無法配搭地區資料細節要求。
在沒有指定 action_breakdowns 參數時，系統會將 action_type 隱含新增為 action_breakdowns。