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 商品对应的商家提供的Feed 标签；如果未提供，则为 -。 美国
channel STRING 商品的渠道，即 online 或 local。 本地、在线
expiration_date TIMESTAMP 商家提供的商品过期日期和时间，在插入时指定。如果未提供，则设置为 null。 2023-10-14 00:00:00 UTC
google_expiration_date TIMESTAMP 商品在 Google 购物中过期的日期和时间。绝不会设置为 null。 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 商家提供的共用标识符，用于标识同一商品的所有款式。如果未提供，则为 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 字段所示。 NULL
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