Google Merchant Center 產品資料表結構定義

將 Google Merchant Center 報表資料移轉至 BigQuery 時,產品和產品問題資料的格式主要會對應至 Content API 的 products 和 productstatuses 資源相關欄位格式。

如果您使用的是個別商家 ID,資料會寫入名為 Products_MERCHANT_ID 的資料表;如果您使用的是 MCA 帳戶,資料會寫入名為 Products_AGGREGATOR_ID 的資料表。

結構定義

Products_ 資料表包含下列結構定義:

欄 BigQuery 資料類型 說明 範例資料
product_data_timestamp TIMESTAMP 產品資料的時間戳記。 2023-09-14 11:49:50 UTC
product_id STRING 產品的 Content API REST ID,格式為 channel:content_language:feed_label:offer_id。這是主鍵。 online:en:AU:666840730
merchant_id INTEGER 商家帳戶 ID。 1234
aggregator_id INTEGER 多重客戶帳戶的集結網站帳戶 ID。 12345
offer_id STRING 商家提供的產品 ID。 tddy123uk
title STRING 項目名稱。 TN2351 黑色 USB
description STRING 項目的說明。 TN2351 黑色 USB 重新定義了 XJS 對 LLCD 體驗的影響。
link STRING 商家提供的產品到達網頁網址。 https://www.example.com/tn2351-black-usb/6538811?skuId=1234
mobile_link STRING 商家提供的針對行動裝置最佳化版本到達網頁網址。 https://www.example.com/tn2351-black-usb/6538811?skuId=1234
image_link STRING 商家提供的主要產品圖片網址。 https://www.example.com/tn2351-black-usb/6538811?skuId=1234
additional_image_links STRING、REPEATED 商家提供的商品圖片其他網址。
content_language STRING 項目的雙字母 ISO 639-1 語言代碼。 en
target_country STRING 由於產品現在可指定多個國家/地區,因此這項屬性已淘汰 (一律設為 NULL)。請改用下列欄位讀取各指定國家/地區的狀態:destinations.approved_countries、destinations.pending_countries、destinations.disapproved_countries。問題現在可能只適用於特定指定國家/地區,如 issues.applicable_countries 欄位所示。 null
feed_label STRING 商家為商品提供的動態饋給標籤,如未提供則為 -。 美國
channel STRING 項目的管道,可以是 online 或 local。 本地、線上
expiration_date TIMESTAMP 商家提供的商品到期日期和時間,如插入時所指定。如未提供,則設為空值。 2023-10-14 00:00:00 UTC
google_expiration_date TIMESTAMP 商品在 Google 購物中的到期日期和時間。請勿設為空值。 2023-10-14 00:00:00 UTC
adult BOOLEAN 如果商品以成人為目標對象,請設為 true。 true/false
age_group STRING 商家提供的商品目標年齡層。如未提供,則為 NULL。 newborn、infant、toddler、kids、adult
availability STRING 商家提供的商品供應情形狀態。 有現貨、缺貨中
availability_date TIMESTAMP 商家提供的日期和時間,預購產品可出貨的時間。如未提供,則為 NULL。 2023-10-14 00:00:00 UTC
brand STRING 商家提供的商品品牌。如未提供,則為 NULL。 品牌名稱
google_brand_id STRING 商品的 Google 品牌 ID。 12759524623914508053
color STRING 商家提供的商品顏色。如未提供,則為 NULL。 銀色、灰色、多色
condition STRING 商家提供的商品狀況或狀態。 新品、二手、整新品
custom_labels RECORD 商家提供的自訂標籤,用於在購物廣告中自訂商品分組。如未提供,則為 NULL。
custom_labels.label_0 STRING 自訂標籤 0。 我的自訂標籤
custom_labels.label_1 STRING 自訂標籤 1。 我的自訂標籤
custom_labels.label_2 STRING 自訂標籤 2。 我的自訂標籤
custom_labels.label_3 STRING 自訂標籤 3。 我的自訂標籤
custom_labels.label_4 STRING 自訂標籤 4。 我的自訂標籤
gender STRING 商家提供的商品目標性別。如未提供,則為 NULL。 男女通用、男性、女性
gtin STRING 商家提供的商品全球交易品項識別碼 (GTIN)。如未提供,則為 NULL。 3234567890126
item_group_id STRING 商家為同一產品的所有子類提供的共用 ID。如未提供,則為 NULL。 AB12345
material STRING 商家提供的商品材質。如未提供,則為 NULL。 皮革
mpn STRING 商家提供的商品製造商零件編號 (MPN)。如未提供,則設為 NULL。 GO12345OOGLE
pattern STRING 商家提供的模式。如未提供,則為 NULL。 條紋
price RECORD 商家提供的商品價格。
price.value NUMERIC 商品價格。 19.99
price.currency STRING 價格的幣別。 美元
sale_price RECORD 商家提供的商品特價。
sale_price.value NUMERIC 商品的特價價格。如未提供,則為 NULL。 19.99
sale_price.currency STRING 特價價格的幣別。如未提供,則為 NULL。 美元
sale_price_effective_start_date TIMESTAMP 商品特價的開始日期和時間。 2023-10-14 00:00:00 UTC
sale_price_effective_end_date TIMESTAMP 商品特價結束日期和時間。 2023-10-14 00:00:00 UTC
google_product_category INTEGER 商品的 Google 產品類別 ID。如未提供,則為 NULL。 2271
google_product_category_ids INTEGER, REPEATED 項目的 Google 產品類別完整路徑,以一組 ID 的形式儲存。如未提供,則為 NULL。
google_product_category_path STRING 人類可讀的完整路徑版本。如未提供,則為空白。 服飾與配件 > 服飾 > 洋裝
product_type STRING 商家提供的商品類別。 首頁 > 女裝 > 連身裙 > 長連身裙
additional_product_types STRING、REPEATED 商品的額外類別。
promotion_ids STRING、REPEATED 與產品相關聯的促銷 ID 清單。
destinations RECORD、REPEATED 產品的預定目的地。
destinations.name STRING 目的地名稱;僅支援 Shopping。這對應 Merchant Center 中的行銷方式「購物廣告」和「店面商品目錄廣告」。 購物
destinations.status STRING 由於產品現在可指定多個國家/地區,因此這項屬性已淘汰 (一律設為 NULL)。請改用下列欄位讀取各指定國家/地區的狀態:destinations.approved_countries、destinations.pending_countries、destinations.disapproved_countries。問題現在可能只適用於特定指定國家/地區,如 issues.applicable_countries 欄位所示。 空值
destinations.approved_countries STRING, REPEATED 商品獲准刊登的CLDR 地域代碼清單。 US, CH
destinations.pending_countries STRING, REPEATED 商品處於待處理狀態的 CLDR 地域代碼清單。 US, CH
destinations.disapproved_countries STRING, REPEATED 商品遭拒登的 CLDR 地域代碼清單。 US, CH
issues RECORD、REPEATED 與產品相關聯的商品層級問題清單。
issues.code STRING 問題的錯誤代碼。 image_too_generic
issues.servability STRING 這項問題對商品放送的影響。 已拒登,不受影響
issues.resolution STRING 商家是否可以解決問題。 merchant_action, pending_processing
issues.attribute_name STRING 如果問題是由單一屬性造成,則會顯示屬性名稱。否則傳回 NULL。 圖片連結
issues.destination STRING 問題適用的目的地。一律設為 Shopping。 購物
issues.short_description STRING 簡短說明問題 (英文)。 圖片太過籠統
issues.detailed_description STRING 問題詳細說明 (英文)。 使用的圖片必須能夠如實呈現產品
issues.documentation STRING 有助於解決這個問題的網頁網址。 https://support.google.com/merchants/answer/6098288
issues.applicable_countries STRING, REPEATED 問題適用的 CLDR 地域代碼清單。 CH

查詢範例

產品和產品問題統計資料

下列 SQL 範例查詢會提供產品數量、有問題的產品數量,以及每日問題數量。

SELECT
  _PARTITIONDATE AS date,
  COUNT(*) AS num_products,
  COUNTIF(ARRAY_LENGTH(issues) > 0) AS num_products_with_issues,
  SUM(ARRAY_LENGTH(issues)) AS num_issues
FROM
  dataset.Products_merchant_id
WHERE
  _PARTITIONDATE >= 'YYYY-MM-DD'
GROUP BY
  date
ORDER BY
  date DESC

遭到拒絕而無法刊登購物廣告的商品

下列 SQL 範例查詢會提供未獲准在購物廣告中顯示的產品數量,並依國家/地區區分。拒登原因可能是目的地遭排除,或產品有問題。

SELECT
  _PARTITIONDATE AS date,
  disapproved_country,
  COUNT(*) AS num_products
FROM
  dataset.Products_merchant_id,
  UNNEST(destinations) AS destination,
  UNNEST(disapproved_countries) AS disapproved_country
WHERE
  _PARTITIONDATE >= 'YYYY-MM-DD'
GROUP BY
  date, disapproved_country
ORDER BY
  date DESC

有遭拒登問題的產品

下列 SQL 範例查詢會擷取有拒登問題的產品數量,並依國家/地區區分。

SELECT
  _PARTITIONDATE AS date,
  applicable_country,
  COUNT(DISTINCT CONCAT(CAST(merchant_id AS STRING), ':', product_id))
      AS num_distinct_products
FROM
  dataset.Products_merchant_id,
  UNNEST(issues) AS issue,
  UNNEST(issue.applicable_countries) as applicable_country
WHERE
  _PARTITIONDATE >= 'YYYY-MM-DD' AND
  issue.servability = 'disapproved'
GROUP BY
  date, applicable_country
ORDER BY
  date DESC