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。 | 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 |
商家为同一商品的所有款式/规格提供的共用标识符。如果未提供,则为 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 |
商品的其他类别。 | |
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 |