Google Ads API 提供多種檢視畫面,可用來分析廣告顯示位置和成效:
managed_placement_view、
group_placement_view、
detail_placement_view 和
performance_max_placement_view。每種檢視畫面都會從不同角度呈現刊登位置資料。
自選刊登位置檢視
- 顯示內容:
managed_placement_view資源會提供您明確指定的刊登位置 (自選刊登位置) 匯總成效資料。這項指標反映Placement條件的成效。 - 使用者介面中的對應項目:「內容」>「刊登位置」
- 查詢建立工具:在查詢建立工具中探索
查詢示例
如要擷取過去 30 天內,自選刊登位置的成效指標,請按照下列步驟操作:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.placement.url,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
群組刊登位置檢視畫面
- 顯示內容:
group_placement_view資源會顯示廣告在多媒體廣告聯播網和 YouTube 上「實際放送」的位置,無論刊登位置是明確指定,還是由 Google 系統自動偵測。包括網站、YouTube 頻道或影片,以及應用程式。 - 使用者介面對應項目:內容 > 廣告顯示位置
- 查詢建立工具:在查詢建立工具中探索
「總計:其他」列
為加快報表產生速度,group_placement_view 和 detail_placement_view 資源會排除曝光或互動次數未達最低活動門檻的個別刊登位置。
- 在 Google Ads 使用者介面中:使用者介面會將未達這個活動門檻的刊登位置匯總到標示為「總計:其他」的摘要列。
- 在 Google Ads API 中:API 會從報表結果中省略不符合活動門檻的刊登位置,且不會傳回
group_placement_view.placement或detail_placement_view.placement欄位值為"Other"的摘要列。
因此,group_placement_view 和 detail_placement_view 資源中個別刊登位置資料列的總和,可能會低於廣告群組或廣告活動的總指標。詳情請參閱「關於『廣告顯示位置』報表」一文。如要進一步瞭解門檻和缺少中繼資料對跨檢視比較有何影響,請參閱「刊登位置檢視之間的指標差異」和「刊登位置詳細資料不適用的資料列」。
TargetingSetting 選項
group_placement_view 的行為和效用會受到廣告群組層級 PLACEMENT 維度的 TargetingSetting 影響。這項設定包含 target_restrictions 清單,每個清單都有 bid_only 布林值欄位,用於指定廣告是否只在目標刊登位置顯示,或是在其他刊登位置顯示。請參閱「關於『指定目標』和『觀察項目』設定」一文。
bid_only = false:這個值對應 Google Ads 使用者介面中刊登位置的「指定目標」。如果廣告群組設為「指定目標」,廣告只會在您明確新增為條件的刊登位置上顯示。您可以選擇對這些刊登位置套用出價調整幅度。在這種情況下,group_placement_view大致會反映managed_placement_view,但仍受限於最低活動門檻。bid_only = true:這個值對應 Google Ads UI 中刊登位置的「觀察項目」。如果廣告群組設為「觀察」,廣告就能在多媒體廣告聯播網和 YouTube 上任何符合資格的刊登位置顯示。您也可以對任何指定的刊登位置套用出價調整幅度。在這種情況下,group_placement_view對於發掘廣告顯示的新刊登位置至關重要,您可能會選擇將這些位置新增為自選刊登位置或排除條件。
詳細刊登位置檢視
- 顯示內容:
detail_placement_view資源提供更精細的刊登位置細目,提供網域或頻道層級以外的詳細資料。舉例來說,這份報表可顯示廣告出現的特定網址或 YouTube 影片 ID。 - 使用者介面等效操作:等同於在「內容」>「廣告顯示位置」中選取資料列,然後按一下「查看詳情」。
- 查詢建立工具:在查詢建立工具中探索
- 重要注意事項:與
group_placement_view資源類似,這個檢視畫面會省略未達最低活動門檻的低活動刊登位置 (請參閱「總計:其他」列一節)。
刊登位置檢視畫面之間的指標差異
系統會分別評估各個精細程度層級的最低活動門檻:
group_placement_view資源會評估匯總網域、行動應用程式或 YouTube 頻道的門檻。detail_placement_view資源會分別評估每個網頁網址或 YouTube 影片的門檻。
detail_placement_view 資源會省略未達門檻的個別網頁網址或 YouTube 影片。因此,加總網域或 YouTube 頻道的 detail_placement_view 列 (依 detail_placement_view.group_placement_target_url 欄位篩選) 時,傳回的曝光次數可能會少於對應的 group_placement_view 列。
無法提供刊登位置詳細資料的資料列
對 group_placement_view 或 detail_placement_view 資源執行查詢時,可能會傳回同一個廣告群組中的多個資料列,其中 placement、display_name 和 target_url 欄位未設定,且 resource_name 值相同 (例如以 ~MTRf 結尾)。
發生這種情況的原因如下:
- 內部刊登位置分組:這兩種檢視畫面都會依不重複的內部刊登位置 ID,而非
resource_name或placement字串欄位,將成效指標分組。 - 刊登位置中繼資料無法使用:在 Google Ads 使用者介面中,如果刊登位置在後端對照表中沒有中繼資料,就會顯示為「不明」、「頻道已無法使用」或「影片已無法使用」。在 API 中,每個不同的刊登位置 ID 仍會傳回指標列,但
placement、display_name和target_url欄位未設定。 - 合成資源名稱:
resource_name欄位中的{base64_placement}尾碼是從{type_id}_{placement}進行 Base64 編碼,其中{type_id}是內部刊登位置類型 ID,而非PlacementType列舉編號。如果placement_type欄位為WEBSITE(內部 ID14),且未設定placement欄位,則字串"14_"會編碼為MTRf(同樣地,MOBILE_APPLICATION會將"55_"編碼為NTVf,YOUTUBE_VIDEO會將"89_"編碼為ODlf,YOUTUBE_CHANNEL會將"90_"編碼為OTBf)。 因此,如果同一個廣告群組中有多個相同類型的刊登位置,且中繼資料無法使用,則這些刊登位置會共用相同的resource_name值,但會回報不同的指標資料列。
在用戶端程式碼中處理 group_placement_view 或 detail_placement_view 結果時,請勿僅依 resource_name 欄位簡化資料列,否則可能會覆寫不同刊登位置的指標,導致中繼資料無法使用。如要在 Google Ads 查詢語言中排除中繼資料無法使用的資料列,請篩選 target_url 或 display_name 欄位 (例如 WHERE
detail_placement_view.target_url IS NOT NULL),因為 placement 和 resource_name 欄位無法篩選。
最高成效刊登位置檢視
- 顯示內容:
performance_max_placement_view資源會提供最高成效廣告活動廣告放送位置的曝光資料 (metrics.impressions)。在 v24 和更新版本中,您可以依segments.ad_network_type區隔performance_max_placement_view(v23 不支援)。 - 查詢建立工具:在查詢建立工具中探索
該使用哪種檢視畫面?
- 使用
managed_placement_view評估您目前指定和出價的刊登位置成效。 - 使用
group_placement_view瞭解廣告顯示位置的完整範圍,特別是在使用「觀察」設定時,可發掘新的指定目標或排除條件。 - 使用
detail_placement_view,取得廣告顯示位置的特定網址或影片最精細的詳細資料,通常在group_placement_view中找出感興趣的網域或頻道後使用。 - 使用
performance_max_placement_view檢查最高成效廣告活動的刊登位置曝光。