報表

和其他廣告類型一樣，您可以使用 GoogleAdsService.SearchStream 擷取購物產品的產品狀態和成效資料。

支援產品的廣告活動有以下專屬報表：

• 購物成效檢視
• 產品群組檢視畫面
• 素材資源群組產品群組檢視畫面
• 購物產品

購物成效資料檢視

購物成效檢視畫面可依據 product_item_id 等屬性，提供產品的歷來匯總報表統計資料。

購物成效檢視畫面會擷取系統記錄相關指標時的產品狀態，包括 product_title 等區隔，可能會在記錄指標後有所變更。

以下查詢範例會擷取最近 30 天內點擊次數 (product_item_id) 的產品曝光次數、點擊次數、費用、轉換次數和所有轉換 (依所有轉換、轉換、點擊、費用和曝光排序)：

SELECT
  segments.product_item_id,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM  shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.clicks > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.cost_micros DESC,
  metrics.impressions DESC

產品群組檢視

產品群組檢視畫面提供購物清單 (在 UI 中稱為產品群組) 的匯總報表統計資料。如需「素材資源群組產品群組檢視畫面」的範例，請參閱最高成效廣告活動報表指南。

下方查詢範例會擷取購物商家資訊群組的曝光次數、點擊次數、轉換次數，以及最近 30 天內曾獲得曝光的廣告活動所帶來的曝光、點擊、轉換和所有轉換 (依所有轉換、轉換再到曝光排序，以遞減順序排列)：

SELECT
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.all_conversions
FROM product_group_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.impressions > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

購物產品

「購物產品」報表會針對 Google Ads 帳戶已連結至 Google Merchant Center 帳戶中的產品，提供屬性和報表統計資料。此報表可用來檢查客戶、廣告活動和廣告群組層級的統計資料。

以下查詢範例會擷取所有已連結 Google Merchant Center 帳戶中，所有購物產品的曝光、點擊、轉換和所有轉換 (依所有轉換、轉換、點擊次數和曝光次數，以遞減順序排序)：

SELECT
  shopping_product.resource_name,
  shopping_product.item_id,
  shopping_product.feed_label,
  shopping_product.merchant_center_id,
  metrics.clicks,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM shopping_product
WHERE segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

如要進一步瞭解查詢，請參閱報表指南。

效能注意事項

如果帳戶連結大量產品，購物產品報表可能會傳回大量資料。以下建議有助於提高 GAQL 查詢的效能：

• 相較於帳戶層級，廣告活動和廣告群組層級的查詢速度通常快許多，因為這類查詢包含的產品可能會較少，所需的資料也較少。
• SELECT 子句中的欄位和指標越多，回應時間就越慢。 建議您只選取在查詢中需要的欄位和指標。
• 如果有一或多個問題，系統會傳回更多資料。您可以在 WHERE 中依 shopping_product.status 篩選，瞭解哪些產品可能傳回導致相關狀態的問題。

購物產品報表的用途

「購物產品」報表可讓您靈活地存取使用產品動態饋給的廣告活動。這項工具有助您深入瞭解 Google Merchant Center 帳戶中的產品狀態，也能提供廣告特定資訊，例如成效指標和導致產品無法放送廣告的問題。

本節說明一些與 Google Ads UI 中「產品」檢視畫面類似的常見用途。

購物產品的「問題」欄位類似於 Content API for Shopping 中的 productstatuses 所提供的，但還有 Google Ads 特有的問題。如要確認是否需要在 Google Merchant Center 或 Google Ads 中解決問題，請先查看回應的 shopping_product.issues.documentation 欄位，其中含有說明中心的說明中心文章。

產品狀態 (帳戶層級)

如果在未篩選廣告活動或廣告群組篩選器的情況下指定報表，則會傳回帳戶層級的所有產品。

該報表支援下列類型中所有廣告活動的指標、狀態和問題：

• 購物廣告活動
• 最高成效

這項查詢會顯示產品狀態 (例如 NOT_ELIGIBLE)，以及導致特定狀態的特定產品問題清單：

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product

產品狀態 (廣告活動層級)

如果在 WHERE 子句中指定包含廣告活動資源的報表，報表會傳回所選廣告活動中的所有產品。

支援產品動態饋給的廣告活動類型如下：

• 購物廣告活動
• 最高成效
• 需求開發
• 影片

這項查詢可讓您查看指定廣告活動中產品的狀態。 可讓您查看每個產品的狀態，包括導致狀態的原因。舉例來說，暫停的廣告活動會影響產品狀態：

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"

產品狀態 (廣告群組層級)

若報表同時同時包含廣告群組資源和廣告活動資源，且做為 WHERE 子句的一部分，則會傳回所選廣告活動內含的所有產品。產品的指標、狀態和問題會反映該產品是否在所選廣告群組中納入或排除。

這項查詢可讓您查看該廣告群組的產品狀態。 此分頁可讓您確認產品群組篩選器 (廣告群組層級) 已正確套用，並查看每個產品的狀態：

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.ad_group,
  ad_group.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"
  AND shopping_product.ad_group = "customers/<CUSTOMER_ID>/adGroups/<AD_GROUP_ID>"

按日期篩選的產品指標 (帳戶層級)

如果在 WHERE 子句中指定日期或日期範圍的報表，系統將傳回帳戶層級所有產品的指標，無論指標是否為零。

您無法選取 segments.date，否則會導致 UNSUPPORTED_DATE_SEGMENTATION 錯誤。

這項查詢可讓您查看目前產品在指定日期或其他相容日期值的成效。此屬性可用來為從所有廣告活動匯總的每項傳回產品產生摘要：

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  metrics.clicks,
  metrics.impressions,
  metrics.cost_micros
FROM shopping_product
WHERE
  segments.date = '2024-01-01'

透過購物車資料回報的產品成效

零售業廣告客戶則可查看相關的銷售和利潤指標，例如收益、毛利、毛利利潤和售出單位。這些指標適用於所有購物廣告活動中導入透過購物車資料回報的轉換，且與下列報表相容。

• ad_group
• ad_group_ad
• campaign
• customer (匯總所有廣告活動的匯總資料)
• product_group_view
• shopping_performance_view

下列購物車資料指標可用於購物廣告活動 (例如 shopping_performance_view)

以下範例說明如何使用購物車資料指標分析過去 30 天內購物廣告活動的產品層級成效。

SELECT
  segments.product_item_id,
  segments.product_title,
  metrics.average_cart_size,
  metrics.average_order_value_micros,
  metrics.conversions,
  metrics.conversions_value,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin,
  metrics.revenue_micros,
  metrics.units_sold,
  campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
  AND metrics.conversions > 0
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.revenue_micros DESC,
  metrics.conversions_value DESC

透過購物車資料回報的廣告活動成效

購物車資料指標可在廣告活動層級使用，並可與其他成效指標 (例如曝光次數、點擊次數和費用) 搭配使用。

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros,
  metrics.average_order_value_micros,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin
FROM campaign
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.average_order_value_micros DESC,
  metrics.cost_micros DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC