與其他廣告類型一樣,您可以使用 GoogleAdsService.SearchStream 擷取購物產品的產品狀態和成效資料。
支援 Google Merchant Center 動態饋給產品的廣告活動,有下列專屬報表:
- 購物成效檢視畫面
- 產品群組檢視畫面
- 素材資源群組產品群組檢視畫面
- 購物產品
- 購物車資料銷售檢視 (適用於 v24 以上版本)
- 最終到達網址擴展素材資源檢視畫面 (適用於第 26 版及更新版本的購物廣告活動)
此外,自第 26 版起,如果購物廣告活動啟用 AI Max (campaign.ai_max_setting.enable_ai_max = true) 和最終到達網址擴展 (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN),final_url_expansion_asset_view 會回報放送的文字自訂素材資源。如需查詢規定和範例,請參閱「最終到達網址擴展素材資源檢視畫面」一節。
購物成效檢視畫面
購物成效檢視會依 product_item_id 等屬性,提供產品的匯總歷來報表統計資料。
這項功能支援所有使用 Google Merchant Center 產品動態饋給的廣告活動類型,包括購物、最高成效、需求開發、影片、應用程式和多媒體廣告活動。
購物成效檢視畫面會擷取記錄相關指標時的產品狀態。這包括 product_title 等區隔,這些區隔在記錄指標後可能已變更。
shopping_performance_view 也支援下列區隔和指標:
segments.ad_sub_network_type(product_group_view和asset_group_product_group_view也支援)。- 按轉換日期區隔的指標:
metrics.conversions_by_conversion_date、metrics.all_conversions_by_conversion_date、metrics.conversions_value_by_conversion_date、metrics.all_conversions_value_by_conversion_date、metrics.value_per_conversions_by_conversion_date和metrics.value_per_all_conversions_by_conversion_date。 - 競爭曝光比重指標:
metrics.search_budget_lost_impression_share、metrics.search_rank_lost_impression_share、metrics.search_budget_lost_absolute_top_impression_share和metrics.search_rank_lost_absolute_top_impression_share。 - v24 以上版本:
segments.conversion_attribution_event_type區隔和metrics.all_*購物車資料指標 (回報所有轉換的購物車資料,包括不可出價轉換)。
以下查詢範例會擷取過去 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
產品報表的歸因邏輯
產品層級報表會使用特定歸因架構,在單一廣告中出現多項產品時,將成效歸功於個別產品。
財務指標
系統會計算metrics.cost_micros和metrics.conversions等財務指標,確保所有產品的總和不會超過廣告活動層級報表。
- 直接互動
- 如果使用者意圖明確且與單一產品相關 (例如直接點選產品),則相關費用和轉換功勞會 100% 歸因於該特定產品。
- 間接互動
- 如果使用者意圖是針對整個廣告 (例如點按廣告標題、行動號召按鈕或影片),相關費用和轉換功勞會平均分配給該廣告中放送的所有產品。
互動指標
互動指標 (例如metrics.impressions和metrics.clicks) 可評估特定產品的參與度。
如果是曝光,系統會在事件發生時,為廣告中的每項產品增加曝光次數,無論產品是否顯示在使用者可視區域中。因此,報表中所有產品的曝光總和,可能會大幅高於對應的廣告活動層級總和。
相反地,metrics.clicks 只會評估該特定產品獲得的點擊。在 Google Ads UI 中,metrics.clicks 欄位會明確標示為「產品點擊」。
產品群組檢視
產品群組檢視畫面提供購物商家資訊群組 (在使用者介面中稱為產品群組) 的匯總報表統計資料。如需素材資源群組產品群組檢視畫面範例,請參閱最高成效廣告活動報表指南。
以下查詢範例會擷取過去 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 Merchant Center 帳戶中產品的屬性和報表統計資料,這些帳戶已連結至 Google Ads 帳戶。這份報表可用於查看客戶、廣告活動和廣告群組層級的統計資料。支援購物、最高成效、需求開發、影片和應用程式廣告活動 (v24 以上版本)。您也可以查詢 shopping_product.product_image_uri,擷取商家提供的產品圖片 URI。
以下查詢範例可擷取過去 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 使用者介面中「產品」檢視畫面的用途類似。
shopping_product 的 issues 欄位與 Merchant API 中的 ProductStatus 類似,但新增了 Google Ads 專屬問題。如要確認問題是否需要在 Google Merchant Center 或 Google Ads 中解決,請先查看回應的 shopping_product.issues.documentation 欄位,其中包含說明中心文章。
產品狀態 (帳戶層級)
如果指定報表時未篩選廣告活動或廣告群組,則會傳回帳戶層級的所有產品。
支援帳戶中所有廣告活動的指標、狀態和問題,類型包括:
- Google 購物
- 最高成效
這項查詢可讓你查看產品狀態 (例如 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 子句中指定含有廣告活動資源的報表,會傳回所選廣告活動中的所有產品。
下列廣告活動類型可使用產品動態饋給,因此支援這項功能:
- Google 購物
- 最高成效
- 需求開發廣告活動
- 影片
- 應用程式 (適用於 v24 以上版本)
這項查詢可讓您查看特定廣告活動中每項產品的狀態,包括造成該狀態的問題。舉例來說,暫停廣告活動會影響產品狀態:
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 子句中同時指定廣告群組資源和廣告活動資源,報表就會傳回所選廣告活動中的所有產品。產品的指標、狀態和問題會反映產品是否包含在所選廣告群組中,或已從中排除。
支援的廣告活動類型如下:
- Google 購物
- 需求開發
- 影片
- 應用程式 (適用於 v24 以上版本;僅支援
impressions、clicks和ctr指標,不支援status或issues)
這項查詢可讓您查看產品在該廣告群組中的狀態。您可以確認產品群組篩選器 (在廣告群組層級) 是否正確套用,並查看每項產品的狀態:
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 DURING LAST_30_DAYS
產品成效 (含購物車資料)
零售廣告主可存取相關的銷售和利潤指標,例如收益、毛利、毛利率和售出產品數量。所有廣告主只要在購物廣告活動中導入透過購物車資料回報的轉換,即可使用這些指標,且這些指標與下列報表相容:
ad_groupad_group_adcampaigncart_data_sales_view(適用於第 24 版以上)customer(所有廣告活動的匯總資料)product_group_viewshopping_performance_viewshopping_product(適用於 v24 及更新版本的metrics.all_*購物車資料指標)
您可以在購物廣告活動的報表 (例如 shopping_performance_view) 中使用下列購物車資料指標:
metrics.average_cart_sizemetrics.average_order_value_microsmetrics.cost_of_goods_sold_microsmetrics.cross_sell_cost_of_goods_sold_microsmetrics.cross_sell_gross_profit_microsmetrics.cross_sell_revenue_microsmetrics.cross_sell_units_soldmetrics.gross_profit_marginmetrics.gross_profit_microsmetrics.lead_cost_of_goods_sold_microsmetrics.lead_gross_profit_microsmetrics.lead_revenue_microsmetrics.lead_units_soldmetrics.ordersmetrics.revenue_microsmetrics.units_sold
在 v24 以上版本中,下列購物車資料指標也可用於回報所有轉換 (包括不可出價轉換):
metrics.all_average_cart_sizemetrics.all_average_order_value_microsmetrics.all_cost_of_goods_sold_microsmetrics.all_cross_sell_cost_of_goods_sold_microsmetrics.all_cross_sell_gross_profit_microsmetrics.all_cross_sell_revenue_microsmetrics.all_cross_sell_units_soldmetrics.all_gross_profit_marginmetrics.all_gross_profit_microsmetrics.all_lead_cost_of_goods_sold_microsmetrics.all_lead_gross_profit_microsmetrics.all_lead_revenue_microsmetrics.all_lead_units_soldmetrics.all_ordersmetrics.all_revenue_microsmetrics.all_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
最終到達網址擴展素材資源檢視畫面
自第 26 版起,如果啟用 AI Max (campaign.ai_max_setting.enable_ai_max = true) 和最終到達網址擴展 (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN),您可以使用 final_url_expansion_asset_view,評估購物廣告活動中放送的文字自訂素材資源層級成效。
查詢 final_url_expansion_asset_view 時,請遵循下列篩選和欄位選取規則:
- 對
final_url_expansion_asset_view執行查詢時,必須篩選campaign.advertising_channel_type、campaign(campaign.id、campaign.resource_name或final_url_expansion_asset_view.campaign) 或ad_group(ad_group.id、ad_group.resource_name或final_url_expansion_asset_view.ad_group) 的至少一項;如果全部省略,則會傳回FinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTER。 - 在帳戶或廣告活動層級查詢購物廣告活動的
final_url_expansion_asset_view時,必須依campaign.advertising_channel_type = 'SHOPPING'篩選 (或使用=依單一廣告群組篩選)。依廣告活動 (campaign.id、campaign.resource_name或final_url_expansion_asset_view.campaign) 篩選時,也需要campaign.advertising_channel_type = 'SHOPPING';如果省略,則會傳回FinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTER,而依單一ad_group篩選則可自行滿足篩選條件。 campaign.advertising_channel_type、campaign或ad_group的篩選器必須對單一值使用=運算子;如果對相同資源類型使用IN或多個條件,則會傳回FinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE。- 如果是購物廣告活動,您可以選取
ad_group欄位並依此篩選,但無法選取asset_group欄位。在購物廣告活動中選取asset_group欄位 (或依ad_group篩選時),會傳回FinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP(如果也選取ad_group欄位,則會傳回CANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUP)。依asset_group篩選並選取ad_group欄位會傳回CANNOT_SELECT_AD_GROUP,同時依ad_group和asset_group篩選則會傳回CANNOT_FILTER_BY_BOTH_AD_GROUP_AND_ASSET_GROUP。
下列查詢會擷取購物廣告活動過去 30 天的素材資源層級成效指標:
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
ad_group.id,
final_url_expansion_asset_view.asset,
final_url_expansion_asset_view.field_type,
final_url_expansion_asset_view.final_url,
final_url_expansion_asset_view.status,
metrics.impressions,
metrics.clicks,
metrics.conversions
FROM final_url_expansion_asset_view
WHERE
campaign.advertising_channel_type = 'SHOPPING'
AND segments.date DURING LAST_30_DAYS