與其他廣告類型一樣,您可以使用
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
產品群組檢視畫面
「產品群組檢視」會提供購物資訊群組的匯總報表統計資料 (在使用者介面中稱為「產品群組」)。如需「素材資源群組產品群組檢視畫面」範例,請參閱最高成效報表指南。
以下查詢範例會擷取過去 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 使用者介面「產品」檢視畫面中的用途類似。
購物產品的「問題」欄位與 Content API for Shopping 中產品狀態提供的欄位類似,但會額外顯示 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