1 - 概述
产品目录源是一个文件，其中包含有关您的网站上所有产品的信息。我们将使用此信息构建动态产品横幅广告。
在本文中，您将发现有关可以在目录源中包含哪些内容以及如何为每个字段设置格式的详情。
2 - Criteo 支持的目录源格式
为确保 Criteo 能够检索到您的产品目录源，请使用以下格式之一：
|
目录源格式 |
详情 |
下载 |
|
TSV |
此格式基于制表符分隔值。必须在文件的第一行中声明标头。字段名可以包含空格或下划线（例如image_link 或 image link） |
|
|
CSV |
此格式基于逗号分隔值。必须在文件的第一行中声明标头。字段名可以包含空格或下划线（例如image_link 或 image link） |
|
|
XML |
此格式应遵循 XML 结构的基本要素。产品由一组 XML 节点表示。产品列表必须以 <?xml 声明标签开头。 |
3 - 要提供的产品信息
所有字段名都必须为英文。产品信息不得包含 HTML 标签或样式标签。
3.1 - 为您的产品做广告的必填字段
3.1.1 id
|
目录源中的所有产品均需包含此字段， 且不得留空。 id 是唯一产品标识符，代表一个且仅代表一个产品。一旦将某个 id 分配给产品并导入，便不能将该 id 用于不同的产品，也不能将该 id 用于特定产品变更。如果您也填充了 item_group_id，请使用子 ID/SKU 填充 id。 |
字符要求：id 只能包含 ASCII 字符，不能包含引号。
限制：240
类型：字符串
示例：abc123-black-7.5
3.1.2 title
|
目录源中的所有产品均需包含此字段， 且不得留空 title 是产品的名称，通常如产品详情页面上所显示。它将用作给定产品横幅广告中的主要文本描述符。 Criteo 预测搜索建议： 如果要重复使用您的 Google Shopping 目录源，我们建议您将最长的 title 置于 'title' 中，而较短且更适于显示的 title 置于 'display_ads_title' 内 |
字符要求：name 必须以字母或数字开头。
限制：150
类型：字符串
示例：Working Boots – Size 7.5
3.1.3 description
|
description 是一段简短文本，用于提供有关产品的除名称外的更多信息。因为横幅广告的设计使然，较短的描述（不超过 50 个字符）更可能融入到 Criteo 的格式和布局中，然而，并非所有的格式和布局都将具有描述。 |
字符要求：description 必须以字母或数字开头。请从此字段中删除所有 HTML 标签，包括样式、嵌入、对象和锚定标签。
限制：5000
类型：字符串
示例：Excellent for daily use.
3.1.4 google_product_category
|
分类级别属性表示所提交的产品分类，按照 Google 产品分类法。 如果可将您的产品链接到多个分类，我们只想要最相关的分类。 |
字符要求：我们接受 ID 和完整分类路径
类型：字符串
示例：Women’s > Shoes > Working Boots 或 2271
3.1.5 link
|
目录源中的所有产品均需包含此字段， 且不得留空 link 是产品的专用详情页面。对于给定产品， link 通常是唯一的，但并不一定这样。此 URL 上的产品信息应匹配目录源中提供的对应信息。请为所有 URL 指定协议（http:// 或 https://）。 如果您正在运行 Criteo Predictive Search，则该字段中的域名必须与 Google Merchant Center 中声明的域相匹配。 |
字符要求：link 必须以协议（http:// 或 https://）开头，后跟产品详情页面的完整 URL。所有符号均必须编码。例如，必须将 $ 替换为 %24。
限制：1024
类型：字符串
示例：http://www.example.com/product/working-boots
3.1.6 image_link
|
目录源中的所有产品均需包含此字段， 且不得留空 image_link 是一个 URL，指定给定产品的图像文件路径。image_link 用于将产品的图像显示在横幅广告中。理想情况下，图像应至少为 800x800 像素，且小于 16MB。 该图像必须指定 Content-Type 标头，即 image/png、image/gif 或 image/jpeg。如果您限制可通过 cURL 访问您的图像，请将我们的用户代理列入白名单，以便我们可以在 Criteo 横幅广告中显示您的图像：curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn。 |
字符要求：image_link 必须以 http:// 或 https:// 开头，且后跟产品图像的完整 URL。所有符号均必须编码。例如，必须将 $ 替换为 %24。
限制：2000
类型：字符串
示例：http://www.example.com/product/image/working-boots.png
3.1.7 additional_image_link
|
additional_image_link 是一个 URL，指定给定产品的图像文件路径。additional_image_link 用于将产品的图像显示在横幅广告中。理想情况下，图像应至少为 800x800 像素，且小于 16MB。 该图像必须指定 Content-Type 标头，即 image/png、image/gif 或 image/jpeg。如果您限制可通过 cURL 访问您的图像，请将我们的用户代理列入白名单，以便我们可以在 Criteo 横幅广告中显示您的图像：curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn。 |
字符要求：additional_image_link 必须以 http://（不是 https://）开头，且后跟产品图像的完整 URL。所有符号均必须编码。例如，必须将 $ 替换为 %24。但是，additional_image_link 不能在查询字符串（? 后的任何字符）中包含任何符号。
限制：2000
类型：字符串
示例：http://www.example.com/product/image/working-boots-side.png
3.1.8 availability
|
针对 Criteo 预测搜索，此字段为必填 availability 表示是否可在网站上购买产品。您可以使用 3 个可能的值填充 availability：preorder（商品当前无法运送，但仍可购买）、out of stock（商品无法运送，且您不接受此商品的订单）和 in stock（商品可运送并可针对此商品下单）。标记为 out of stock 无存货的商品将不在横幅广告中显示。 字符要求：必须使用以下三个值之一填充 availability： · preorder · out of stock · in stock |
限制：16
类型：字符串
示例：in stock
3.1.9 price
|
这是制造商建议的商品出售价格。如果给定产品“打折促销”，则 price 将被填充为较高的价格。price 应与网站的货币相同。使用数字值填充 price 时，仅使用点号 (.) 作为小数点分隔符，不使用千位分隔符。 |
字符要求：小数点分隔符必须为点号 (.)，且不使用千位分隔符。
限制：14
类型：字符串
示例： 1299.99
3.1.10 sale_price
|
sale_price 是产品可用于在网站上购买的价格，如果给定商品“打折促销”，则 sale_price 将被填充为较低的价格。sale_price 应与网站的货币相同。使用数字价格填充 sale_price 时，仅使用点号 (.) 作为小数点分隔符，不使用千位分隔符。 |
字符要求：小数点分隔符必须为点号 (.)，且不使用千位分隔符。
限制：14
类型：字符串
示例： 1199.99
3.1.11 gtin (upc, ean)
|
针对 Criteo 预测搜索，此字段为必填 全球贸易项目代码 (GTIN) 是唯一产品标识符，用于标识全球市场中的产品、服务或商品。 GTIN 包括：
字符要求：值必须为 8 位、12 位、13,位或 14 位数字（UPC、EAN、JAN, 或 ISBN）。 |
限制：50
类型：字符串
示例：0001234560012
3.1.12 mpn
MPN 是根据制造商唯一标识产品的编号
限制：70
类型：字符串
示例：4060882
3.1.13 brand
|
针对 Criteo Sponsored Products，此字段为必填 brand 表示产品的品牌名称。某些产品没有关联明确的品牌。在这种情况下，无需提供此信息。 |
字符要求： 名称必须以字母或数字开头，并且只能包含 ASCII 字符。该字段中不应包含任何 HTML 标签，包括样式标签。
限制：70
类型：字符串
示例：Criteo
3.1.14 adult
|
针对 Criteo 预测搜索，此字段为必填 adult 属性表示产品是否向所有用户及所有受众展示均是安全的。成人产品不能在 Criteo 横幅广告中展示，且可能导致发布商网络将您的广告活动列入黑名单。如果您希望此产品为不可推荐且不在横幅广告中显示，也可将此字段与“yes”值一起使用。 |
字符要求：值必须为 yes 或 no
类型：Boolean
示例：no
3.1.15 product_type
|
针对 Criteo Sponsored Products，此字段为必填 product_type 是产品所属的分类（或分类列表）。product_type 字段列出您的商品分类，或该产品的商品分类集。它与您的网站分类必须相匹配。层次结构中的每一级都需要用“>”进行分隔。如果产品属于多个分类，请以逗号 (,) 分隔的形式发送不同分类，将主分类排在第一位。product_type 区分大小写，因此如果您使用 women’s 表示一种产品，使用 Women’s 表示另一种产品，Criteo 会将这些产品看作两个不同的分类。 |
字符要求：product_type 必须以字母或数字开头，并且只能包含 ASCII 字符。分类之间的分隔符必须为 >（XML 目录源为 >）。我们只支持完整分类路径。如果产品属于多个分类，请以逗号 (,) 分隔的形式发送不同分类，将主分类排在第一位。我们不接受路径的分类 ID。必须将 ID 填入 product_type_key 字段。
限制：500
类型：字符串
示例：
- 单个分类：Computing > Keyboards and Mice > Mice > Wireless Mice
- 多个分类：Computing > Keyboards and Mice > Mice > Wireless Mice,Gifts > For Dad > Mice
3.1.16 product_type_key
|
针对 Criteo Sponsored Products，此字段为必填 此字段列出唯一 ID 及 product_type 或 product_type 集的层次结构。层次结构中的每个键都需要用“>”进行分隔。如果产品属于多个分类，请以逗号 (,) 分隔的形式进行发送，将主分类排在阵列的第一位。 |
字符限制：product_type_key 只能包含 ASCII 字符。 分类之间的分隔符必须为 >（XML 目录源为 >）。如果产品属于多个分类，请以逗号 (,) 分隔的形式发送不同分类，将主分类排在第一位。
限制：500
类型：字符串
示例：
- 单个分类：XY1 > YZ1 > Z1
- 多个分类：XY1 > YZ1 > Z1 , AB1 > BC2 > A
3.1.17 number_of_reviews
|
针对 Criteo Sponsored Products，建议填写此字段 此字段包含该产品的评论数量。如果您希望在广告中显示此信息，则需要 number_of_review。 |
限制：8
类型：Integer
示例：2456
3.1.18 product_rating
|
针对 Criteo Sponsored Products，建议填写此字段 此字段表示该产品的评分。如果您希望在广告中显示此信息，则需要 product_rating。 |
字符要求：小数点分隔符必须为点号 (.)，且不使用千位分隔符。
限制：8
类型：字符串
示例：4.5
3.1.19 filters
|
针对 Criteo Sponsored Products，此字段为必填 filters 是用于指定同一类别不同产品之间差异的属性。应该以逗号分隔的属性名称值对列表的形式提供 filters。它们必须匹配网站上可用的匹配此产品的 filters 列表。这对于 Criteo 发布的产品非常重要。 |
字符要求：键=值对必须以逗号 (,) 分隔，多个值则以管道符 (|) 分隔。
限制：2000
类型：字符串
示例：Color=Red|Black, Size=XL, Screen Size = 15"
3.2 - 可选字段
3.2.1 mobile_link
mobile_link 是指向您的产品登录页面的移动端优化版本的链接。此 url 应与您在“link”字段中提供的 url 不同。通过提供移动端链接：您将改善客户的用户体验，并缩短登录页面加载延迟。
字符要求：link 必须以协议（http:// 或 https://）开头，后跟产品详情页面的完整 URL。所有符号均必须编码。例如，必须将 $ 替换为 %24。
限制：2000
类型：字符串
示例：http://m.example.com/product/working-boots
3.2.2 condition
condition 用于使用三个不同的容许值限定产品：“new”、“refurbished”和“used”。
字符要求：仅接受以下 3 个值：
- 'new' [全新]
- 'refurbished' [翻新]
- 'used' [二手]
类型：字符串
示例：new
---
产品变体
3.2.3 item_group_id
item_group_id 是唯一父级产品标识符，可包含字母数字字符，代表一个可表示为一个子产品集合的产品。一旦将某个 item_group_id 分配给产品并导入，便不能将该 item_group_id 用于不同的产品，也不能将该 item_group_id 用于特定产品变更。由于 item_group_id 可代表一个产品集合，因此许多产品可具有相同的 item_group_id 值
字符要求：item_group_id 只能包含 ASCII 字符，不能包含引号。
限制：240
类型：字符串
示例： abc123
3.2.4 color
详情：此属性表示产品的主要颜色。
限制：100
类型：字符串
示例：Black
3.2.5 gender
因性别而异的商品组中的所有产品的必填项。
字符要求：仅接受以下 3 个值：
- 'male' [男性]
- 'female' [女性]
- 'unisex' [中性]
类型：字符串
示例：male
3.2.6 age_group
此属性用于表示您的产品所针对的年龄组。
字符要求：仅接受以下 5 个值：
- 'newborn' [新生儿]
- 'infant' [婴儿]
- 'toddler' [幼童]
- 'kids' [儿童]
- 'adult' [成人]
类型：字符串
示例：adult
3.2.7 material
此属性表示产品的制成材料或面料。因材料而异的商品组中的所有产品的必填项。
限制：200
类型：字符串
示例：leather
3.2.8 pattern
此属性表示产品的图案或印花。因图案而异的商品组中的所有产品的必填项。
限制：100
类型：字符串
示例：Striped
3.2.9 size
此属性表示产品的尺码。因尺码而异的商品组中的所有产品的必填项。
限制：100
类型：字符串
示例：L
3.2.10 size_type
您可以通过添加尺码类型来指定产品的款式。
字符要求：仅接受以下 5 个值：
- 'regular' [常规]
- 'petite' [小码]
- 'plus' [略大]
- 'big and tall' [高大]
- 'maternity' [孕妇装]
限制：无
类型：字符串
示例：regular
3.2.11 size_system
详情：您可以通过添加尺码系统来指定某个国家/地区的产品尺码确定系统。
字符要求：接受以下 11 个值：US、UK、EU、DE、FR、JP、CN（中国）、IT、BR、MEX、AU
限制：无
类型：字符串
示例：US
---
对于市场卖家
3.2.12 cross_sellers_product_id
仅当您是市场并经销多个卖家的一种产品时，才需要此字段。
cross_sellers_product_id 是一个唯一产品标识符，将指向不同卖家销售的同一种产品的多个 id 分组在一起。将 cross_sellers_product_id 分配给某个产品并导入后，便不能将该 cross_sellers_product_id 用于不同的产品，也不能将该 cross_sellers_product_id 用于特定的产品变更。由于 cross_sellers_product_id 代表的是产品集合，因此多个产品可以具有相同的 cross_sellers_product_id 值
字符要求：cross_sellers_id 必须以字母或数字开头，并且只能包含 ASCII 字符。
限制：250
类型：字符串
示例： abc123
3.2.13 seller_name
仅当您是市场并经销多个卖家的一种产品时，才需要此字段。
seller_name 标识卖家的显示名称。在卖家页面上或购物框中，该名称通常与特定产品一起显示。在 seller_name 和 seller_id 之间应该有一对一的对应关系。
限制：200
类型：字符串
示例：My Electronics Store
3.2.14 seller_id
仅当您是市场并经销多个卖家的一种产品时，才需要此字段。
seller_id 是唯一标识符，它表示零售网站上的卖家。在 seller_id 和 seller_name 之间应该有一对一的对应关系。
限制：200
类型：字符串
示例：3265fd
---
发货信息
3.2.15 shipping
该属性用于指定所支持的每个国家/地区的发货详情，指明价格和服务
类型：字符串
示例：
<shipping>
<country>US</country>
<service>Standard</service>
<price>15.5 USD</price>
</shipping>
3.2.16 shipping_weight
shipping_weight 代表产品的重量。
字符要求：仅接受以下单位：lb、oz、g、kg
类型：字符串
示例：1 kg
3.2.17 shipping_height
shipping_height 代表产品的高度。
3.2.18 shipping_width
shipping_width 代表产品的宽度
3.2.19 shipping_length
详情：shipping_length 代表产品的长度。
3.2.20 shipping_label
此属性可用于使用您选择的值（如，perishable、bulky 或 promotion）将标签分配给特定产品。
限制：100
类型：字符串
示例：promotion
---
产品包装与产品组合
3.2.21 multipack
此属性指定一包相同产品。
类型：Integer
示例：2
3.2.22 is_bundle
此属性指定一组不同产品。
类型：Boolean
示例：FALSE
3.2.23 promotion_id
详情：此属性指定促销 ID。
限制：String
类型：60
示例：123654
3.2.24 promo_text
详情：此字段包含该产品的促销文本
限制：String
类型：60
示例：Special Buy
---
其他属性
3.2.25 custom_label_0
添加与产品有关的其他自定义信息。
字符要求：仅授权 5 级自定义标签（0 至 4）
限制：100
类型：字符串
3.2.26 sale_price_effective_date
此属性与“sale_price”一起使用，指定销售价格有效性的日期范围。
字符要求：开始和结束日期由正斜杠分隔。开始日期采用格式 (YYYY-MM-DD) 指定，后跟字母“T”（销售的开始时间），然后是销售的时区表达式，如 ISO 8601 标准所定义。结束日期应采用相同格式。
限制：51
示例：2016-03-01T13:00-0800/2016-03-11T15:30-0800
3.2.27 adwords_redirect
用于单独跟踪所有来自 Google Shopping 的点击的 URL。
限制：200
类型：URL
示例：http://www.mywebsite.com/productpage.html
3.2.28 excluded_destination
“excluded destination”属性可阻止商品在某些目的地显示，即使它在您的产品数据中显示。
3.2.29 expiration_date
不再推荐产品的日期。
限制：10
类型：ISO 8601 格式
示例：2016-07-24
3.2.30 unit_pricing_measure
“unit pricing measure”属性定义商品的度量维度。例如，25floz 或 15oz。
示例：15oz
3.2.31 unit_pricing_base_measure
“unit pricing base measure”属性指定您的单价度量偏好。例如，50floz。
示例：50oz
3.2.32 display_ads_title
如果您愿意，可使用此字段在展示广告中显示不同的标题（不同于“title”）。
由于较短的标题更可能适应我们的展示横幅广告，而较长的标题则能够更好地用于 Criteo 搜索，因此我们建议在“title”中使用完整的/长标题，而在“display_ads_title”中则使用较短的标题。
限制：150（建议 25）
类型：字符串
3.2.33 display_ads_value
以显示商品价格的相同货币包含商品利润。也可以使用某个倍数的利润来隐藏实际产品利润，但是该倍数在产品之间应该保持一致。
值限制：产品价格的 10 倍
类型：字符串
示例：299.99
3.2.34 map_price
map_price 字段表示产品的“最低广告价格”。如果出于某种原因，您不能在广告中显示低于 map_price 的价格，此字段值永远不会显示在我们的广告中且必须指定。如果产品的当前价格低于 map_price，则不会在广告中显示价格。
字符要求：小数点分隔符必须为点号 (.)，且不使用千位分隔符。
类型：字符串
示例：1299.99
3.2.34 model_number
model_number 用于区分系统产品中的一种产品。品牌经常使用 model_number 来区分同一类别中的类似产品。有时候，可能会在具有不同 id 值的类似变型产品中显示相同的 model_number。
限制：200
字符限制：model_number 只能包含 ASCII 字符。
类型：字符串
示例：AXY27
示例目录结构
XML 目录源示例
XML
|
<rss xmlns:g="http://base.google.com/ns/1.0"version="2.0"> <channel> <title>Your Website</title> <link>http://www.yoursite.com/us/</link> <description>Your Website</description> <item> <g:id>abc123-black-7.5</g:id> <g:title>Working Boots Size 7.5</g:title> <g:description>Excellent for daily use</g:description> <g:google_product_category>Women’s > Shoes > Working Boots</g:google_product_category> <g:link>http://www.example.com/product/working-boots</g:link> <g:image_link>http://www.example/com/product/image/working-boots.png</g:image_link> <g:additional_image_link>http://www.example.com/product/image/working-boots-side.png</g:additional_image_link> <g:additional_image_link>http://www.example.com/product/image/working-boots-side_2.png</g:additional_image_link> <g:availability>in stock</g:availability> <g:price>1299.99</g:price> <g:sale_price>1199.99</g:sale_price> <g:gtin>0001234560012</g:gtin> <g:brand>Criteo</g:brand> <g:adult>no</g:adult> <g:product_type>Women’s > Shoes > Working Boots</g:product_type> <g:mobile_link>http://m.example.com/product/working-boots</g:mobile_link> <g:condition>new</g:condition> <g:availability>in stock</g:availability> <g:availability_date>2016-06-25T13:00-0800</g:availability_date> <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date> <g:item_group_id>abc123</g:item_group_id> <g:color>Black</g:color> <g:gender>male</g:gender> <g:age_group>adult</g:age_group> <g:material>leather</g:material> <g:pattern>Striped</g:pattern> <g:size>L</g:size> <g:size_type>regular</g:size_type> <g:size_system>US</g:size_system> <g:shipping> <g:country>US</g:country> <g:service>Standard</g:service> <g:price>5.5 USD</g:price> </g:shipping> <g:shipping_weight>1 kg</g:shipping_weight> <g:shipping_label>promotion</g:shipping_label> <g:multipack>2</g:multipack> <g:is_bundle>FALSE</g:is_bundle> <g:custom_label_0>custom data 0</g:custom_label_0> <g:custom_label_1>custom data 1</g:custom_label_1> <g:custom_label_2>custom data 2</g:custom_label_2> <g:custom_label_3>custom data 3</g:custom_label_3> <g:custom_label_4>custom data 4</g:custom_label_4> <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date> <g:adwords_redirect>http://www.mywebsite.com/productpage.html</g:adwords_redirect> <g:excluded_destination>Shopping</g:excluded_destination> <g:expiration_date>2016-07-24</g:expiration_date> <g:unit_pricing_measure>15oz</g:unit_pricing_measure> <g:unit_pricing_base_measure>50oz</g:unit_pricing_base_measure> </item> </channel> </rss> |
