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`	多重客戶帳戶的 Aggregator 帳戶 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。	新生兒、嬰兒、幼兒、兒童、成人
`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 地域代碼清單。	美國、瑞士
`destinations.pending_countries`	`STRING, REPEATED`	優惠待處理的 CLDR 地域代碼清單。	美國、瑞士
`destinations.disapproved_countries`	`STRING, REPEATED`	優惠遭拒登的 CLDR 地域代碼清單。	美國、瑞士
`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