作为商家，你可能想要以产品 Pin 图的形式将产品上传到 Pinterest。产品 Pin 图采用特殊格式，可让 Pinterest 上浏览内容的用户知道相应产品可供购买。这类 Pin 图包含产品标题和描述，以及价格和库存信息。
将零售目录的数据来源添加到 Pinterest，一次性上传多个产品作为产品 Pin 图。接下来，你就可以在 Pinterest 上以购物广告的形式推广这些产品。你可以选择提供托管数据来源的网址链接，或者手动上传数据来源。
添加零售目录之前，你需要：
如果你不符合上述要求，不妨
零售目录的运作方式取决于你选择如何添加数据来源，我们可以从数据来源访问你的零售目录。
如果你提供托管数据来源的网址链接，我们会每天访问该数据来源，以便为你的零售目录中的每个产品动态创建产品 Pin 图。请确保经过更新的数据来源每天都可供访问，以保证产品详细信息始终处于最新状态。你甚至可以提前安排数据接入。
如果你手动上传数据来源， 我们将在数据来源上传时，以及你每次更新后上传时访问你的数据来源，以便为你的零售目录中的每个产品创建产品 Pin 图或更新现有 Pin 图的元数据。
如有任何错误，我们会提醒你。请务必尽快检查并修复错误，以确保产品信息准确无误并更新及时。如果出现错误，则可能是因为你的整个页面未更新，页面中的某些商品未更新，或者需要进行一些格式更改。
我们每个零售目录最多可处理 2,000 万件产品。如果你的产品超过 2,000 万件，请
仅当你托管数据来源时，本部分才适用。如果你要手动上传数据来源，则可以跳过本部分。
你需要在 FTP/SFTP/WebDAV 服务器上或使用 HTTP/HTTPS 直接下载链接托管自己的数据来源。应确保可以通过用户代理进行访问，并且不需要任何 IP 或 SSH 密钥白名单。如果你使用直接下载链接，则不得要求我们进行额外的导航才能访问文件。
我们支持以下格式：
| 制表符分隔 (TSV) | （ |
| 逗号分隔 (CSV) | （ |
| XML (RSS 2.0, ATOM 1.0) | （ |
| Google Sheets | （ |
注意：我们接受压缩文件（.zip、.giz、.gz、.bz2 及其他格式），但目前不支持受密码保护的加密压缩文件或 Dropbox 文件。
零售目录需包含以下字段，且这些字段的格式应与如下显示的格式完全一致。如果字段缺失或格式错误，你的整个零售目录将无法接入。
| 列名 | 描述 | 语法/支持的值 | 示例 |
|---|---|---|---|
| id |
代表产品的唯一 ID。 |
最多 127 个字符。 | DS0294-L |
| title | 产品名称（与着陆页上的产品名称相同，包括颜色和尺寸等型号详细信息）。 | 最多 500 个字符。 | 女式牛仔衬衫，大码 |
| description | 产品说明。 | 纯文本（非 HTML）最多 10,000 个字符。 | 采用最优质日本牛仔布制成的休闲牛仔衬衫 |
| link | 产品的登陆页面（需要将用户直接引导至相同的产品并展示相同的数据） |
字符串网址。 最多 511 个字符，网址必须以 http:// 开头（我们不建议使用硬墙）。 |
|
| image_link |
主产品图片的链接（至少 75x75 像素，可通过我们的用户代理访问，且无模板或占位符图片）。 如果你日后更改图片，则需要使用其他链接，否则图片不会更新。 |
字符串网址。 最多 2,000 个字符，以 http:// 或 https:// 开头（对逗号进行编码或将其移除）。 推荐：用引号将字符串括起来。 |
|
| price |
产品的价格（应反映产品的真实成本；如果不是美元，则应包含符合 ISO-4217 标准的货币，否则我们将默认为美元）。 |
<numeric> <ISO 4217> 货币可以放在数字价格值之前或之后，有无空格均可，并遵循 ISO-4217 标准规范。请勿使用 0 值或货币符号。 |
24.99 USD 24.99USD 24,99 USD 24,99USD 24.99 24,99 GBP24.99 GBP 24.99 GBP24,99 GBP 24,99 |
| availability | 产品库存情况。 |
应为下列值之一： 现货 |
现货 |
| item_group_id（仅在产品包含多个型号时必填） | 产品的父级 ID。 | 最多 127 个字符。 | DS0294 |
你可以为零售目录添加可选字段，帮助我们更好地将你的产品与用户对应。你提供的信息越多，你的 Pin 图与查看 Pin 图的用户之间的相关性就越高。
| 列名 | 描述 | 语法/支持的值 | 示例 |
|---|---|---|---|
| product_type | 基于自定义产品分类法的产品分类。 | 最多五个子类别，最多 1,000 个字符，必须用 > 分隔，并用空格括起来（我们不会识别逗号或竖线等其他分隔符）。 | 衣服 > 女式 > 衬衫 > 牛仔布 |
| additional_image_link |
产品的最多 10 张附加图片的链接（至少 75x75 像素，可通过我们的用户代理访问，且无模板或占位符图片）。 我们会为每个附加图片链接创建一张新 Pin 图。如果你日后更改图片，则需要使用其他链接，否则图片不会更新。 |
每个值最多 2,000 个字符，以 http:// 或 https:// 开头（对逗号进行编码或将其移除）。 推荐：用引号将字符串括起来。 |
" |
| mobile_link | 移动优化版登陆页面。 | 必须以 http:// 或 https:// 开头 | |
| sale_price |
产品的折扣价格（应低于原价；如果不是美元，则应包含符合 ISO-4217 标准的货币，否则我们将默认为美元） 如果提供，则销售价格将被视为此商品的当前价格。 |
<numeric> <ISO 4217> 货币可以放在数字价格值之前或之后，有无空格均可，并遵循 ISO-4217 标准规范。请勿使用 0 值或货币符号。 |
14.99 USD 14.99USD 14,99 USD 14,99USD 14.99 14,99 GBP 14.99 GBP14.99 GBP 14,99 GBP14,99 |
| average_review_rating | 产品的平均评价数量。 |
<numeric> 1-5 之间 |
5 |
| number_of_ratings | 产品的评分数量。 | <numeric> | 2 |
| number_of_reviews | 产品的评价数量。 | <numeric> | 4 |
| description_html |
产品的 HTML 描述。 建议：如果描述超过 200 个字符，我们建议使用 HTML 描述。 如果提供此字段，我们将使用该字段而不是必填的描述字段。 |
HTML 格式 | <body> <h1>我的产品</h1> <p>立即购买</p> </body> |
| video_link |
产品视频的托管链接。 所链接的视频文件类型必须为 .mp4、.mov 或 .m4v。 文件大小不得超过 2GB。 |
字符串网址。 最多 2,000 个字符，以 http:// 或 https:// 开头 |
| 列名 | 描述 | 语法/支持的值 | 示例 |
|---|---|---|---|
| item_group_id | 产品的父级 ID。 | 最多 127 个字符 | DS0294 |
|
brand |
产品品牌 | 最多 100 个字符 | Josie’s Denim |
| gtin | 唯一通用产品标识符 | 3234567890126 | |
| mpn | 产品的制造商零件编号 |
最多 70 个字母数字字符 |
"mpn": "PI12345NTEREST" |
| 列名 | 描述 | 语法/支持的值 | 示例 |
|---|---|---|---|
|
color |
产品的主色。 | 最多 30 个字符。 | 蓝色 |
| gender | 与产品相关的性别因素。 | 必须为下列值之一： 男 女 男女通用 |
MALE |
| age_group | 与产品相关的年龄因素。 |
应为下列值之一： 新生儿 |
新生儿 |
| material | 产品的制造材料。 | 最多 30 个字符。 | 棉 |
| pattern | 产品图案。 | 最多 30 个字符。 | 格子图案 |
| size | 产品尺码。 | 最多 30 个字符。 | M |
| size_type | 产品尺寸的其他说明。 |
应为下列值之一： 正常 |
标码 |
| size_system | 你提交产品的国家/地区的尺码系统。 | 国家/地区代码。 |
US |
| alt_text | 产品主图片中显示内容的描述。 | 一个或多个替代文本值，以逗号分隔。替代文本值的数量应与 image_link 字段中图片的数量一致。如果替代文本中包含逗号，则应将逗号编码为 , 或将其移除。多个替代文本应使用逗号分隔。 | 带流苏的浅蓝色钩针婴儿帽 |
| variant_names | 此产品型号的选项（Pinterest 用户会在你的 Pin 图旁边看到这些选项，并可以选择他们想要的选项）。 | 按照你想要的显示顺序列出文本，并以逗号分隔。 | 颜色、尺寸 |
| variant_values | 此产品型号的价值选项（Pinterest 用户会在你的 Pin 图旁边看到这些选项，并可以选择他们想要的选项）。 |
按照你想要的显示顺序列出文本，并以逗号分隔。 应与 variant_names 字段的顺序一致。 |
红色、小号 |
| 成人 | 产品是否为成人用品。成人用品不会在 Pinterest 上显示。 |
应为下列值之一： TRUE |
false |
| 列名 | 描述 | 语法/支持的值 | 示例 |
|---|---|---|---|
| tax | 产品的税务详细信息 |
包含一组元素（最多 4 个）：国家、地区和费率为必填项，tax_ship 为选填项。即使是空白值，也必须输入冒号。 国家:地区:费率（必填）：tax_ship |
US:1025433:6.00:y |
| shipping | 产品的运送详细信息 |
包含一组元素（最多 4 个）：国家、地区和服务均为选填项，价格为必填项。即使是空白值，也必须输入冒号。 国家:地区:服务:价格（必填） |
US::Express:13.12 |
|
shipping_weight |
产品重量。 |
<numeric> <metric> 确保数字字符串和度量单位之间有空格。 |
5 磅 |
| shipping_width | 运输产品所需的包装宽度。 |
<numeric> <metric> 确保数字字符串和度量单位之间有空格。 |
16 in |
| shipping_height | 运输产品所需的包装高度。 |
<numeric> <metric> 确保数字字符串和度量单位之间有空格。 |
12 in |
| free_shipping_label |
你是否为产品提供免运费优惠。 如果提供，请在 free_shipping_limit 字段中输入 0。如果仅在客户消费一定金额后提供免运费优惠，请在 free_shipping_limit 字段中输入该金额。 |
应为下列值之一： TRUE |
true |
| free_shipping_limit | 获享产品免运费优惠的最小订购量。 |
<numeric> <ISO 4217> |
35 美元 |
| 列名 | 描述 | 语法/支持的值 | 示例 |
|---|---|---|---|
| custom_label_0 | 自定义产品分组（最多 5 个） | 最多 511 个字符 | 夏季促销 |
| custom_label_1 | 自定义产品分组（最多 5 个） | 最多 511 个字符 | 热卖 |
| custom_number_0 | 自定义产品数量（最多五个） | 大于或等于 0 且小于或等于 4294967295 的整数 | 1029384 |
| custom_number_1 | 自定义产品数量（最多五个） | 大于或等于 0 且小于或等于 4294967295 的整数 | 2938 |
| 列名 | 描述 | 语法/支持的值 | 示例 |
|---|---|---|---|
| ad_link | 可用于跟踪来自 Pinterest 购物广告的流量的链接。 |
字符串网址。 应发送包含跟踪功能的完整网址，而不仅仅是跟踪参数。 我们目前不支持跟踪浏览次数。 必须以 http:// 或 https:// 开头 |
|
| condition | 产品状况。 |
应为下列值之一： 全新 |
全新 |
| google_product_category | 基于标准 Google 产品分类法的产品分类。 |
文本值和数字代码均可。 |
服装及配饰 > 衣服 > 衬衫及上衣 21 |
请确保遵守我们的
了解如何