追蹤廣告刊登位置和成效

Google Ads API 提供多種檢視畫面，可用來分析廣告顯示位置和成效： managed_placement_view、 group_placement_view、 detail_placement_view 和 performance_max_placement_view。每個檢視畫面都會從不同角度呈現刊登位置資料。如要取得可立即執行的 Google Ads 查詢語言 (GAQL) 和 curl 查詢，複製 Google Ads UI 中的刊登位置畫面，請參閱查詢錦囊妙計。

自選刊登位置檢視

• 顯示內容：managed_placement_view 資源會提供成效資料，這些資料是根據您在廣告群組中指定的正面刊登位置條件匯總而成。這個檢視畫面包含在 Google Ads 使用者介面中，透過「內容」>「刊登位置」管理的所有五種條件類型：網站、YouTube 頻道、YouTube 影片、行動應用程式和行動應用程式類別。
• 使用者介面中的對應項目：「內容」>「刊登位置」
• 查詢建立工具：在查詢建立工具中探索

目標刊登位置條件類型

managed_placement_view 資源中的每一列都會填入與其 ad_group_criterion.type 值相符的 AdGroupCriterion 欄位，並將其他刊登位置欄位留空：

UI 刊登位置類型	ad_group_criterion.type值	條件詳細資料欄位	附註
網站	PLACEMENT	ad_group_criterion.placement.url	目標網站或網域網址。
YouTube 頻道	YOUTUBE_CHANNEL	ad_group_criterion.youtube_channel.channel_id	YouTube 頻道 ID。ad_group_criterion.display_name 欄位會傳回頻道名稱。
YouTube 影片	YOUTUBE_VIDEO	ad_group_criterion.youtube_video.video_id	YouTube 影片 ID。ad_group_criterion.display_name 欄位會傳回影片標題。
應用程式	MOBILE_APPLICATION	ad_group_criterion.mobile_application.app_id、ad_group_criterion.mobile_application.name	應用程式 ID (格式為 {platform}-{platform_native_id}，iOS 為 1-，Android 為 2-) 和應用程式名稱。
應用程式類別	MOBILE_APP_CATEGORY	ad_group_criterion.mobile_app_category.mobile_app_category_constant	資源名稱，格式為 mobileAppCategoryConstants/{mobile_app_category_id}。請參閱「行動應用程式類別名稱和階層」。

查詢示例

如要擷取過去 30 天內所有目標刊登位置類型的成效指標，請選取 ad_group_criterion.type 欄位和類型專屬欄位：

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.display_name,
  ad_group_criterion.placement.url,
  ad_group_criterion.youtube_channel.channel_id,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.mobile_application.app_id,
  ad_group_criterion.mobile_application.name,
  ad_group_criterion.mobile_app_category.mobile_app_category_constant,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

注意：在 SELECT 子句中選取 segments 欄位 (例如 segments.date)，會排除指標為零的指定刊登位置 (請參閱「依區隔排除零指標」)。如要擷取所有已設定的刊登位置條件，但不含指標，請直接查詢 ad_group_criterion 資源。

行動應用程式類別名稱和階層

在 Google Ads 使用者介面中，指定的行動應用程式類別會顯示完整的應用程式商店路徑，例如「應用程式類別」>「Apple App Store」>「教育」。查詢 Google Ads API 時，請留意下列行為：

• 歸因行動應用程式類別常數：mobile_app_category_constant 資源不是 managed_placement_view 資源的歸因資源。請改為選取 ad_group_criterion.mobile_app_category.mobile_app_category_constant 欄位 (例如 mobileAppCategoryConstants/60503)，或在不需要指標時查詢 ad_group_criterion 資源。
• 僅顯示葉類別顯示名稱：ad_group_criterion.display_name 和 mobile_app_category_constant.name 欄位都只會傳回葉類別顯示名稱，例如 "Education" 或 "Games"。這兩個欄位都不包含上層應用程式商店路徑。
• 解析應用程式商店路徑：Google Play 和 Apple App Store 會在不同的條件 ID 之間共用葉類別名稱。舉例來說，條件 ID 60005 (/All Apps/Google Play/Education)、60060 (/All Apps/Google Play/Family/Education) 和 60503 (/All Apps/Apple App Store/Education) 都會在 name 和 display_name 欄位中傳回 "Education"。從資源名稱中擷取 {mobile_app_category_id} 後置字串，然後在「行動應用程式類別」表格或 CSV 檔案中查詢其完整階層路徑。

群組刊登位置檢視畫面

• 顯示內容：group_placement_view 資源會顯示廣告在多媒體廣告聯播網和 YouTube 上「實際放送」的位置，無論刊登位置是明確指定，還是由 Google 系統自動偵測。包括網站、YouTube 頻道或影片，以及應用程式。
• 使用者介面對應項目：內容 > 廣告顯示位置
• 查詢建立工具：在查詢建立工具中探索

查詢示例

下列查詢會擷取過去 30 天內，廣告顯示位置 (網域、行動應用程式和 YouTube 頻道) 的成效指標：

SELECT
  campaign.id,
  ad_group.id,
  group_placement_view.display_name,
  group_placement_view.target_url,
  group_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS

「總計：其他」列

為加快報表產生速度，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 資源中個別刊登位置資料列的總和，可能會低於廣告群組或廣告活動的總指標。詳情請參閱「關於『廣告顯示位置』報表」一文。如要進一步瞭解門檻和缺少中繼資料對跨檢視比較有何影響，請參閱「刊登位置檢視之間的指標差異」和「刊登位置詳細資料不適用的資料列」。

指定刊登位置設定

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 資源類似，這個檢視畫面會省略未達最低活動門檻的低活動刊登位置 (請參閱「總計：其他」列一節)。

注意：detail_placement_view 資源會回報精細層級 (個別網址和影片 ID) 的資料，並可能傳回高基數資料。請務必依日期範圍或特定廣告活動和廣告群組篩選查詢，以免酬載過大和查詢逾時。

查詢示例

為限制結果數量，下列查詢會擷取 7 天內的網址層級和影片層級刊登位置指標。如果是大型帳戶，請依 campaign.id 或 ad_group.id 欄位進一步篩選：

SELECT
  campaign.id,
  ad_group.id,
  detail_placement_view.display_name,
  detail_placement_view.target_url,
  detail_placement_view.group_placement_target_url,
  detail_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS

如要排除刊登位置中繼資料無法使用的資料列，請新增 AND detail_placement_view.target_url IS NOT NULL (請參閱「刊登位置詳細資料無法使用的資料列」)。如果不需要傳回 resource_name 欄位，請附加 PARAMETERS omit_unselected_resource_names = true 子句。

刊登位置檢視畫面之間的指標差異

系統會分別評估各個精細程度層級的最低活動門檻：

• 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 (內部 ID 14)，且未設定 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 欄位簡化資料列，否則可能會覆寫不同刊登位置的指標，導致中繼資料無法使用。如要在 GAQL 中排除中繼資料無法使用的資料列，請篩選 target_url 或 display_name 欄位，因為 placement 和 resource_name 欄位無法篩選。例如，使用 WHERE group_placement_view.target_url IS NOT NULL 或 WHERE detail_placement_view.target_url IS NOT NULL。

最高成效刊登位置檢視

• 顯示內容：performance_max_placement_view 資源會提供最高成效廣告活動廣告放送位置的曝光資料 (metrics.impressions)。在 v24 和更新版本中，您可以依 segments.ad_network_type 區隔 performance_max_placement_view (v23 不支援)。
• 使用者介面對應項目：洞察和報表 > 報表編輯器 > 最高成效廣告活動刊登位置
• 查詢建立工具：在查詢建立工具中探索

查詢示例

下列查詢會擷取過去 30 天內，最高成效廣告活動按廣告聯播網類型區隔的刊登位置曝光次數：

SELECT
  campaign.id,
  performance_max_placement_view.display_name,
  performance_max_placement_view.target_url,
  performance_max_placement_view.placement_type,
  segments.ad_network_type,
  metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS

選擇刊登位置檢視畫面

• 使用 managed_placement_view 評估您目前指定和出價的刊登位置成效。
• 使用 group_placement_view 瞭解廣告顯示位置的完整範圍，特別是在使用「觀察」設定時，可發掘新的指定目標或排除條件。
• 使用 detail_placement_view，取得廣告顯示位置的特定網址或影片最精細的詳細資料，通常在 group_placement_view 中找出感興趣的網域或頻道後使用。
• 使用 performance_max_placement_view 檢查最高成效廣告活動的刊登位置曝光。