目录使用入门

你似乎正从尚未支持目录功能的地区查看这些内容。查看哪些地区的 Pinterest Business 帐户支持目录功能。

了解更多

创建目录前,需要完成以下这些步骤。单击下方链接跳转至所需区块:

目录是否适合你?

目录是一种页面接入工具,专为在自己网站上销售产品的企业而设计。目录使用要求:

  • 一个 Pinterest 企业帐户
  • 一个数据来源:一个包含产品列表及其相应属性的文件,又称产品目录或产品页面
  • 一个已声明所有权的网站
  • 一个符合我们的商家准则的网站,带有通俗易懂、方便查找的运送政策、退款政策和联系信息
  • 数据来源托管:一种持续托管和存储产品数据来源的方法,你可以每天向 Pinterest 发送相关数据来源

如果你不满足上述条件,但想要创建购物 Pin 图,可以与电子商务网站合作,设计你的 Pinterest 产品。到目前为止,我们已经完成了与 GoDataFeed 和 Productsup 整合。你还可以在 Pinterest 上以其他方式推广你的内容。

数据来源概述

什么是数据来源?

数据来源(通常又称产品目录、产品页面或数据页面)是一个文件,其中包含你的产品列表及其以特定方式构建的相应属性。通过每天处理该文件,即可为你的产品动态创建 Pin 图。

数据来源的工作原理

要向 Pinterest 提交数据来源,你需要提供一个 URL 链接,跳转至我们可以访问数据来源文件的位置。我们将验证该文件,并为通过验证的每个项目创建产品 Pin 图。查看关于数据来源规范的更多内容。

维护数据来源

托管数据来源将持续提供关于可用产品的更新信息。Pinterest 将每天接入你的数据来源,并提醒你注意所有错误。尽快查看并修复错误至关重要,以确保产品信息准确无误和实时更新。

错误类型包括:整个页面未更新,页面中的某些项目未更新,或者需要进行一些更改以符合最佳做法。了解关于错误消息故障排除的更多内容。

关于数据来源的更多内容:

  • 每天更新。我们将每隔 24 小时接入一次你的数据来源。确保已更新的整个数据来源每天可用,保证产品详细信息始终处于最新状态。我们不支持定时或按需接入。
  • 托管数据来源。在 FTP/SFTP 服务器上或使用 HTTP/HTTPS 直接下载链接托管你的数据来源。必须可以通过代理访问,并且不需要任何 IP 或 SSH 密钥白名单。如果使用直接下载链接,则 Pinterest 访问相关文件无需任何其他导航。我们不提供数据来源托管服务。
  • 最多 500 万件产品。我们每个帐户最多可处理 500 万件产品。如果数据来源的产品超过 500 万件,我们将处理前 500 万行的产品。
  • 每个企业帐户只能拥有一个数据来源

在 Pinterest 上拥有已声明所有权的网站

数据来源中的所有目标 URL 必须拥有网络域名,并且注册为在 Pinterest 上已声明所有权的网站。一家企业可以申请多个域名,但每个域名只能由一个 Pinterest 企业帐户进行申请。了解如何声明网站所有权

备妥数据来源

创建页面前,需要先创建数据来源,这是个包含产品列表及其相应属性的文件。

目录数据来源托管要求

必须在 FTP/SFTP 服务器上自行提供托管服务,或创建 HTTP/HTTPS 直接下载链接。Pinterest 不为用户提供托管服务。你的数据来源位置应可通过用户代理访问,并且不需要任何 IP 或 SSH 密钥白名单。如果使用 HTTP/HTTPS 形式的直接下载链接,则 Pinterest 访问相关文件必须无需任何其他导航。

目录数据来源格式要求

支持的格式:

格式提示:

  • 如果使用 csv 格式,我们将用双引号括起相关值,以避免任何可能的解析问题
  • 额外的浮点型分隔符(逗号、制表符)可能导致项目或文件无法正常处理
  • 通过检查每行的分隔符数量是否相同,确保正确设置所有列和行的分隔符。
  • 必要值和设定值的页面规范必须符合标准美式英语。
  • 以制表符或逗号分隔的文件、数据来源文件必须为纯文本、UTF-8 或 Latin1 编码。

产品数据要求

请务必遵守商家指南。我们将删除违反相关指南的产品或帐户。

必填字段和选填字段

必填字段共计 7 个。如有遗漏或存在格式错误,页面将无法完整引入。

必填字段:

  • id
  • title
  • description
  • link
  • image_link
  • price
  • availability

还可以添加选填字段,让 Pinterest 更有效地在用户与你的产品间进行匹配。所提供的信息越多,你的 Pin 图与查看 Pin 图的用户之间的相关性就越高。我们强烈建议你添加选填字段,在页面上增加更多详细信息并提高相关性。

必填字段

列名 描述 语法/支持的值 示例 要求
id

用户创建的代表产品的唯一 ID。

只接受 Unicode 字符。

最多 127 个字符 DS0294-L 必填
title 产品名称。必须与登陆页面上的产品名称相同。包括不同型号的详细信息,例如颜色和尺码。 最多 500 个字符 女式牛仔衬衫,大码 必填
description 产品说明。该字段不支持 HTML,必须使用纯文本才能获得最佳体验。 最多 10,000 个字符 该款休闲牛仔衬衫采用最优质的日本牛仔布制成。 必填
link 产品登陆页面。该链接必须直接指向同一产品并展示相同的数据。我们建议不要使用硬墙。URL 必须以 http:// 或 https:// 开头 最多 511 个字符 https://www.example.com/cat/womens-clothing/denim-shirt-0294 必填
image_link

产品图片链接。URL 必须可以通过用户代理访问,并发送准确图片。请确保链接中没有模板或占位符图片。必须以 http:// 或 https:// 开头

如果逗号是图片链接的一部分,则必须进行编码或将其删除,因为目前我们无法处理包含逗号的图片链接。

  https://scene.example.com/image/image.jpg 必填
price 产品价格。美元以外的价格中应包含 ISO-4217 货币代码。否则我们将默认成美元。货币代码前、数字价格值后的空格可有可无。货币代码应遵循 ISO-4217 代码标准。我们不接受 0 值价格。不要使用货币符号。

<numeric>

<ISO 4217>

24.99 USD
24.99USD
24.99
24.99 GBP
必填
availability 产品可得性。必须为下列值之一:”现货”、”缺货“、”预订“。 in stock
out of stock
preorder
现货 必填

选填常规属性

列名 描述 语法/支持的值 示例 要求
product_type 基于自定义产品分类法的产品分类。发送的子分类必须以“ > ”进行分隔。> 前后保留空格。任何其他分隔符将无法识别,例如逗号或竖线。

L0 > L1 > L2 > L3 > L4

最多 1000 个字符

衣服 > 女式 > 衬衫 > 牛仔布 选填
additional_image_link

跳转至产品附加图片的链接。用逗号分隔每个附加图片。我们建议用引号括起整个字符串。必须以 http:// 或 https:// 开头

如果图片链接中有逗号,则必须进行编码或将其删除,因为目前我们无法处理包含逗号的图片链接。
 

我们将为发送的每个附加图片链接创建一个新 Pin 图。

  "https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg" 选填
mobile_link 移动优化版登陆页面。必须以 http:// 或 https:// 开头   https://m.example.com/cat/womens-clothing/denim-shirt-0294 选填
sale_price 产品折扣价格。sale_price 必须低于价格。包括与价格相同设置的货币代码。美元以外的价格中应包含 ISO-4217 货币代码。否则我们将默认成美元。货币代码前、数字价格值后的空格可有可无。我们不接受 0 值。不要使用货币符号。

<numeric>

<ISO 4217>

14.99 USD
14.99USD
14.99
14.99 GBP
选填

选填产品标识符

列名 描述 语法/支持的值 示例 要求
item_group_id 产品父 ID。 最多 127 个字符 DS0294 具有多个不同型号的项目必填

brand

产品品牌。   Josie’s Denim 选填
gtin 唯一通用产品标识符。 数字 3234567890126 选填
mpn 制造商零件编号是由一件产品的制造商所创建的字母数字代码,用于在同一制造商的所有产品中实现对该产品的唯一识别。 字母数字 "mpn":
"PI12345NTEREST"
选填

选填产品特征

列名 描述 语法/支持的值 示例 要求

color

产品主要颜色   蓝色 选填
gender 与产品相关的性别因素。发送时必须为下列值之一:“男”、“女”、“不分男女” male
female
unisex
选填
age_group 将人口统计范围应用于产品的年龄组。必须为下列值之一:“新生儿”、“婴儿”、“幼儿”、“孩子”、“成人” newborn
infant
toddler
kids
adult
成人 选填
material 产品的制造材料。   选填
pattern 产品款式说明。   格子图案 选填
size 产品尺码。   M 选填
size_type 尺码附加说明。发送时必须为以下值之一:“正常”、“小码”、“大码”、“big_and_tall”、“产妇用” regular
petite
plus
big_and_tall
maternity
标码 选填
size_system 表示你要在其中提交产品的国家/地区的尺码系统。 国家代码

US
UK

选填

选填税务及运输数据

列名 描述 语法/支持的值 示例 要求
tax 每个税务属性组可以包含 4 个子属性:国家:地区:费率(必填):tax_ship

即使是空白值,所有冒号也是必填项。
国家:地区:费率(必填):tax_ship US:1025433:6.00:y 选填
shipping 每个递送属性组可以包含 4 个子属性:国家、地区、服务和价格(必填)。

即使是空白值,所有冒号也是必填项。
国家:地区:服务:价格(必填)

US:CA:Ground:0 USD

US::Express:13.12

选填

shipping_weight

产品重量。确保在数字字符串和度量单位之间保留空格。 <numeric> <metric> 3 kg
5 lbs
选填
shipping_width 运输产品所需的包装宽度。确保在数字字符串和度量单位之间保留空格。 <numeric> <metric> 16 in 选填
shipping_height 运输产品所需的包装高度。确保在数字字符串和度量单位之间保留空格。 <numeric> <metric> 12 in 选填

选填成人用品标志

列名 描述 语法/支持的值 示例 要求
成人 如果要提交被视为“成人”的项目,请将该属性设置为 TRUE。相关项目不会在 Pinterest 上显示。 TRUE
FALSE
true 选填

选填自定义标签

自定义产品分组。可以用于各种目的,例如当季,促销,热卖。我们最多接受 5 种不同的自定义标签。

你可以使用自定义标签在目录中创建产品组。

列名 描述 语法/支持的值 示例 要求
custom_label_0 自定义产品分组。 最多 1000 个字符

热卖

夏季促销

选填
custom_label_1 自定义产品分组。 最多 1000 个字符   选填
custom_label_2 自定义产品分组。 最多 1000 个字符   选填
custom_label_3 自定义产品分组。 最多 1000 个字符   选填
custom_label_4 自定义产品分组。 最多 1000 个字符   选填

选填购物广告字段

列名 描述 语法/支持的值 示例 要求
ad_link 广告主可以另行指定 URL,用于跟踪来自 Pinterest 购物广告的流量。必须发送包含跟踪的完整 URL,不要仅发送跟踪参数。我们目前不支持浏览次数跟踪。必须以 http:// 或 https:// 开头 字符串 URL https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest 选填
condition 产品状态。必须为下列值之一:“全新”、“二手”、“翻新”。 new
used
refurbished
全新 选填
google_product_category 基于 Google 产品分类法的产品分类。这是一套分类法集合。同时接受文本值和数字代码。 完整分类 服装及配饰 > 衣服 > 衬衫及上衣
212
选填

 

Required and optional fields

There are 7 required fields. If any of these fields are missing, or are not properly formatted, your entire feed will fail ingestion.

Required fields:

  • id
  • title
  • description
  • link
  • image_link
  • price
  • availability

There are also optional fields you can add to help Pinterest better map your products to Pinners. The more information you provide, the more relevant your Pins will be to the Pinners who see them. We strongly recommend adding our optional fields as well to add more detail to your feed and improve relevancy.

Required fields

Column name Description Syntax/supported values Example Requirement
id

The user-created unique ID that represents the product.

Only Unicode characters are accepted.

Max 127 characters DS0294-L required
title The name of the product. Must be the same name as the product from the landing page. Include the variant details, such as color and size. Max 500 characters Women’s denim shirt, large required
description Description of the product. This field does not support HTML and must be in plain text for optimal experience. Max 10,000 characters Casual fit denim shirt made with the finest quality Japanese denim.  required
link The landing page for the product. The link must lead directly to the same product and showcase the same data. We recommend against hardwalls. The URL must start with http:// or https://  Max 511 characters https://www.example.com/cat/womens-clothing/denim-shirt-0294 required
image_link

The link to the product image. The URL must be accessible by a user-agent, and send the accurate image. Please make sure there are no template or placeholder images at the link. Must start with http:// or https://

Commas must be encoded or removed if they are part of the image link, as currently we are unable to process image links containing commas.

  https://scene.example.com/image/image.jpg required
price The price of the product. The price should include currency in ISO-4217 if it is not US dollars. If the currency is not included, we default to US dollars. We accept currency after the numeric price value, with or without space. Currency should follow the standard ISO-4217 code. We do not accept 0 values for price. Do not use currency symbols.

<numeric>

<ISO 4217>

24.99 USD
24.99USD
24.99
24.99 GBP
required
availability The availability of the product. Must be one of the following values: ‘in stock’, ‘out of stock’, ‘preorder’. in stock
out of stock
preorder
in stock required

Optional general attributes

Column name Description Syntax/supported values Example Requirement
product_type The categorization of your product based on your custom product taxonomy. Subcategories must be sent separated by “ > “. The > must be wrapped by spaces. We do not recognize any other delimiters such as comma or pipe.

L0 > L1 > L2 > L3 > L4

Max 1000 characters

Clothing > Women’s > Shirts > Denim optional
additional_image_link

The links to additional images for your product. Separate each additional image with comma. We recommend enclosing the whole string with quotes. Must begin with http:// or https://

Commas must be encoded or removed if they are part of the image link, as currently we are unable to process image links containing commas.
 

We will create a new pin for every additional image link sent.

  "https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg" optional
mobile_link The mobile-optimized version of your landing page. Must begin with http:// or https://   https://m.example.com/cat/womens-clothing/denim-shirt-0294 optional
sale_price The discounted price of the product. The sale_price must be lower than the price. Include currency in the same setup as price. It should include currency in ISO-4217 if it is not US dollars. If the currency is not included, we default to US dollars. We accept currency after the numeric price value, with or without space. We do not accept 0 values. Do not use currency symbols.

<numeric>

<ISO 4217>

14.99 USD
14.99USD
14.99
14.99 GBP
optional

Optional product identifier

Column name Description Syntax/supported values Example Requirement
item_group_id The parent ID of the product.  Max 127 characters DS0294 required for items with multiple variants

brand

The brand of the product.   Josie’s Denim optional
gtin The unique universal product identifier. Numeric 3234567890126 optional
mpn Manufacturer Part Number are alpha-numeric codes created by the manufacturer of a product to uniquely identify it among all products from the same manufacturer.  Alphanumeric "mpn":
"PI12345NTEREST"
optional

Optional product characteristics

Column name Description Syntax/supported values Example Requirement

color

The primary color of the product   blue optional
gender The gender associated with the product. Must be one of the following values if sent: ‘male’, ‘female’, ‘unisex’ male
female
unisex
female optional
age_group The age group to apply a demographic range to the product. Must be the one of the following values: ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, ‘adult’ newborn
infant
toddler
kids
adult
adult optional
material The material used to make the product.   cotton optional
pattern Description of the pattern used for the product.   plaid optional
size The size of the product.   M optional
size_type Additional description for the size. Must be one of the following values if sent: ‘regular’, ‘petite’, ‘plus’, ‘big_and_tall’, ‘maternity’ regular
petite
plus
big_and_tall
maternity
regular optional
size_system Indicates the country’s sizing system in which you are submitting your product. Country code

US
UK

optional

Optional tax and shipping data

Column name Description Syntax/supported values Example Requirement
tax Each tax attribute group can consist of 4 sub-attributes: country:region:rate (required):tax_ship
All colons, even for blank values, are required.
country:region:rate(required):tax_ship US:1025433:6.00:y optional
shipping Each delivery attribute group can consist of 4 sub-attributes: country, region, service, and price (required).
All colons, even for blank values, are required.
country:region:service:price(required)

US:CA:Ground:0 USD

US::Express:13.12

optional

shipping_weight

The weight of the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 3 kg
5 lbs
optional
shipping_width The width of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 16 in optional
shipping_height The height of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 12 in optional

Optional adult product flag

Column name Description Syntax/supported values Example Requirement
adult Set this attribute to TRUE if you are submitting items that are considered “adult”. These will not be shown on Pinterest. TRUE
FALSE
true optional

Optional custom labels

Custom grouping of products. These can be used for a variety of purposes such as seasonal, promotions, best sellers. We accept up to 5 different custom labels.

You will be able to create product groups in Catalogs using custom labels.

Column name Description Syntax/supported values Example Requirement
custom_label_0 Custom grouping of products. Max 1000 characters

Best sellers

Summer promotion

optional
custom_label_1 Custom grouping of products. Max 1000 characters   optional
custom_label_2 Custom grouping of products. Max 1000 characters   optional
custom_label_3 Custom grouping of products. Max 1000 characters   optional
custom_label_4 Custom grouping of products. Max 1000 characters   optional

Optional shopping ad fields

Column name Description Syntax/supported values Example Requirement
ad_link Allows advertisers to specify a separate URL that can be used to track traffic coming from Pinterest shopping ads. Must send full URL including tracking, do not send tracking parameters only. At this time we do not support impression tracking. Must begin with http:// or https:// string URL https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest optional
condition The condition of the product. Must be one of the following values: ‘new’, ‘used’, ‘refurbished’. new
used
refurbished
new optional
google_product_category The categorization of the product based on the standardized Google Product Taxonomy. This is a set taxonomy. Both the text values and numeric codes are accepted. Full taxonomy Apparel & Accessories > Clothing > Shirts & Tops
212
optional

 

创建 Pinterest 标签

Pinterest 标签是一段 JavaScript 代码,放在网站上用来搜集转化分析信息,并根据用户在网站上的操作确定目标受众。

请确保通过 Pinterest 标签发送购物专用字段。

  • 必须拥有通过以下转换类型执行 Pinterest 标签:PageVisitsAddToCartCheckouts
  • 必须以 PageVisitAddToCartCheckouts 属性传送“product_id”事件数据。
    • Product_id 必须在行项目(在转化视图页面中不可见)下传送。
    • 请使用标签助手浏览器插件复查是否已将产品 ID 传回产品详细信息页面。
  • 标签中传递的 product_id 数据必须与数据来源中提供的“item_group_id”或“id”相符
  • 过去 7 天内传回产品 ID 的 PageVisit 和 AddtoCart 事件组合最小值为 100K

下一步是什么?

查看数据来源接入指南,了解如何将产品页面连接至 Pinterest。

仍需要帮助?
联系我们