想分享對 Google Ads API 的意見嗎？立即註冊，等待受邀參與使用者研究調查！

本頁面由 Cloud Translation API 翻譯而成。

報表

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

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

購物成效檢視畫面

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

「購物成效」檢視畫面會擷取相關指標記錄時的產品狀態。這包括 product_title 這類區隔，因為指標記錄後可能會有所變動。

以下是範例查詢，可擷取產品的曝光、點擊、費用、轉換和所有轉換，並以 product_item_id 為依據，擷取過去 30 天內的點擊次數 (按所有轉換、轉換、點擊、費用和曝光的遞減順序排序)：

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

產品群組檢視畫面

產品群組檢視畫面會提供購物商店資訊群組 (在使用者介面中稱為「產品群組」) 的匯總報表統計資料。請參閱最高成效廣告活動報表指南，瞭解素材資源群組產品群組檢視畫面的範例。

以下是範例查詢，可依據過去 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 帳戶中存在的產品，提供屬性和報表統計資料。這份報表可用於檢查客戶、廣告活動和廣告群組層級的統計資料。

以下是範例查詢，可擷取過去 30 天內所有已連結 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'

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

零售廣告主可以存取相關的銷售和利潤指標，例如收益、毛利、毛利率和售出單位。凡是在購物廣告活動中導入透過購物車資料回報的轉換的廣告主，都能使用這些指標，且這些指標與下列報表相容。

下列購物車資料指標可用於購物廣告活動的報表，例如 shopping_performance_view。

metrics.average_cart_size
metrics.average_order_value_micros
metrics.cost_of_goods_sold_micros
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.gross_profit_margin
metrics.gross_profit_micros
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
metrics.orders
metrics.revenue_micros
metrics.units_sold

以下範例說明如何使用購物車資料指標，分析購物廣告活動在過去 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

建立商家資訊群組