X 购物管理器
产品规范指南
要求的规范
在将 CSV 文件上传到 X 购物管理器时，请确保其中包含了以下所有的字段。
产品属性和类型
描述
产品属性和类型
id
类型： 字符串
描述
最大字符数限制： 100
商品的唯一 ID。 如有可能，请使用 SKU。 如果同一个 ID 有多个实例，则所有实例都将被忽略。
示例值：
- TWSHOES-22
产品属性和类型
标题
类型： 字符串
描述
最大字符数限制： 150
产品的名称。 应与通过 link 或 mobile_link 属性给出的登陆产品页面的产品名称相同。
示例值：
- X Premium 运动鞋
产品属性和类型
描述
类型： 字符串
描述
最大字符数限制： 5,000（开放性文本）
产品的描述。 该字段不支持 HTML 且必须为纯文本。
示例值：
- 作为 X 的首款同类产品，X Premium 运动鞋是一款彰显潮流、尽显时尚的运动鞋。 选用透气软棉布面料。 蓝色配色，与 X 的品牌相配。
产品属性和类型
供应情况
类型： 字符串
描述
商品当前的供应情况。 从下表中选择一个可能的值。
可能的值：
- 现货
- 可供订购
- 预订
- 缺货
- 停售
产品属性和类型
状况
类型： 字符串
描述
所售商品的状况。 从下表中选择一个可能的值。
可能的值：
- 全新
- 二手
- 翻新
产品属性和类型
价格
类型： 字符串
描述
商品的价格。 以数字格式输入价格，后接 3 位 ISO 币种代码 （ISO 4217 标准），并在价格与币种之间留一个空格。 使用句点“.”作为小数点。
示例值：
- 99.99 USD
- 20.00 CAD
产品属性和类型
链接
类型： 字符串
描述
特定于产品的产品页面 URL，用户可以在上面购买该商品。 如果用户使用的移动设备，同时还包含了 mobile_link，则正在进行查看的用户将被转到通过 mobile_link 属性提供的 URL。
我们将根据 RFC 对 URL 进行验证。 具体而言，它必须包括“https”或“http”。
示例值：
- https://www.X.com/twtr_blue
产品属性和类型
image_link
类型： 字符串
描述
你的商品主要图片的 URL。 如果你稍后更改图片，那么新图片必须使用不同的 URL，否则图片将不会更新。
图片规范：
- 所有图片必须为 JPG、GIF、WEBP 或 PNG 格式。
- 我们强烈建议采用正方形 (1:1) 格式的产品图片。
- 最小图片尺寸为 500 x 500 像素。
- 图片文件大小限制： 5 MB。
示例值：
- https://t.co/demin_jeans_452.jpg
产品属性和类型
品牌、GTIN 和/或 MPN
类型： 字符串
描述
只用提供品牌、GTIN 和/或 MPN 属性中的一 (1) 项，但只要有，我们希望将所有这些属性都包括在内。
所有这些属性的最大字符数限制： 100
- 品牌指的是商品的品牌名称。 示例值： X
- GTIN 是指商品的全球贸易项目代码（唯一的通用产品标识符）。 输入商品的 UPC、EAN、JAN 或 ISBN。示例值：012345678901
- MPN 是指商品的制造商部件号。示例值：TW123456TTER
可选规范
在要上传到 X 购物管理器的 CSV 文件中，以下所有字段均为可选，但在很多情况下，建议为你在 X 上展示的产品提供额外的背景信息。
产品属性和类型
描述
产品属性和类型
mobile_link
类型： 字符串
描述
特定于产品的移动优化版产品页面 URL，用户可以在上面购买该商品。 如果用户使用的移动设备，则正在进行查看的用户将被转到通过 mobile_link 属性提供的 URL。
我们将根据 RFC 对 URL 进行验证。 具体而言，它必须包括“https”或“http”。
示例值：
- https://lite.twttr.com/twtr_blue
产品属性和类型
additional_image_link
类型： 字符串
描述
要添加更多的商品图片，请使用 additional_image_link。 URL 应以逗号加以分隔。 遵循与 image_link 属性中所提及的相同规范。 你最多可以包括 10 张额外的图片。
示例值：
- https://t.co/jeans_1.jpg, https://t.co/jeans_2.jpg, https://t.co/demin_jeans_3.jpg
产品属性和类型
google_product_category
类型： 字符串
描述
产品属性和类型
product_type
类型： 字符串
描述
根据你的企业的自定义产品分类法（如有），该商品所属的类别。 你也可以输入 Google 产品类别 (google_product_category)。 子类别必须以“>”分开发送。 > 前后必须留空。 请注意，该类别会在某些情况下向 X 用户显示。
示例值：
- 服装 > 男式 > 裤子 > 牛仔布
产品属性和类型
库存
类型： 整数
描述
必须 >= 0
该商品可在 X 上销售的数量。 如果包括此字段，当要向用户显示的商品的供应情况字段被设置为现货时，该商品的库存值必须为 1 或更大。 否则，当要向用户显示的商品的供应情况字段被设置为可供订购或预订时，则该值可以大于或等于 0。
示例值：
- 10000
产品属性和类型
sale_price
类型： 字符串
描述
必须 >= 0
商品的折扣价格。 以数字格式输入价格，后接 3 位 ISO 币种代码 （ISO 4217 标准），并在价格与币种之间留一个空格。 使用句点“.”作为小数点。 sale_price 必须低于价格。
示例值：
- 89.99 USD
- 15.00 CAD
产品属性和类型
sale_price_effective_date
类型： 一个或两个 ISO-8601 时间戳
描述
商品的销售期间的时间范围，包括你的销售开始和结束的日期、时间和时区。 如果没有输入销售日期，任何设置了 sale_price 的商品将保持在售状态，直到你删除它们的销售价格。
可以只提供开始日期而不提供结束日期，在这种情况下，销售价格将从开始日期保持在售状态，直到销售价格被删除为止。
格式： YYYY-MM-DDT23:59+00:00/YYYY-MM-DDT23:59+00:00
开始日期必须早于结束日期。
详细说明：
- 按 YYYY-MM-DD 输入开始日期。
- 在开始日期后输入“T”。
- 以 24 小时格式输入开始时间（00:00 至 23:59），后接 UTC 时区（-12:00 至 +14:00）。
- 输入“/”，然后以同样的格式输入商品的销售结束日期和时间。
以下示例使用 PST 时区 (-08:00)。
示例值：
- 2020-06-28T09:00-08:00/2020-07-28T23:59-08:00
产品属性和类型
item_group_id
类型： 字符串
描述
最大字符数限制： 100
使用 item_group_id 属性将产品变体分门别类。 变体是一组类似的商品，它们之间只存在产品细节的差异，如尺寸、颜色、age_group 和性别。 如果你的产品存在变体，则该字段为必填。
示例值：
- twtrshoes1234_12
产品属性和类型
性别
类型： 字符串
描述
根据性别来确定商品尺寸。 从下表中选择一个可能的值。
可能的值：
- 女性
- 男性
- 中性
产品属性和类型
颜色
类型： 字符串
描述
最大字符数限制： 100
产品的主要颜色。 用一个或多个词来描述这种颜色。 不要使用十六进制代码。
示例值：
- 蓝
- 森林绿
产品属性和类型
尺码
类型： 字符串
描述
最大字符数限制： 100
以字词、缩写或数字表示的商品尺码。
示例值：
- 中号
- M
- 6
产品属性和类型
age_group
类型： 字符串
描述
商品的相关年龄组。 从下表中选择一个可能的值。
可能的值：
- 成人
- 所有年龄
- 青少年
- 儿童
- 幼儿
- 婴儿
- 新生儿
产品属性和类型
custom_label
类型： 字符串
描述
最多五个自定义字段 (custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4)，用于输入在创建基于筛选器的产品集时要按照其来筛选商品的任何额外信息。
例如，你可以使用一个自定义标签字段来指明所有属于夏季销售的产品，然后将这些产品筛选到一个产品集中。 这些字段支持任何字符串值。
示例：
- 节日促销
准备好开始了吗？
