登录

欢迎来到我们的支持中心

获取整合和上线广告活动的相关帮助。

欢迎来到我们的支持中心. 获取整合和上线广告活动的相关帮助。

Criteo 产品目录源规范

1. 概述

产品目录源是一个文件,其中包含有关您的网站上所有产品的信息。我们将使用此信息构建动态产品横幅广告。

在本文中,您将发现有关可以在目录源中包含哪些内容以及如何为每个字段设置格式的详情。

2 - Criteo 支持的目录源格式

为确保 Criteo 能够检索到您的产品目录源,请使用以下格式之一:

目录源格式 详情 下载

TSV

此格式基于制表符分隔值。必须在文件的第一行中声明标头。应删除包含空格的字段名。

目录源示例

CSV

此格式基于逗号分隔值。 必须在文件的第一行中声明标头。应删除包含空格的字段名。

目录源示例

XML

此格式应遵循 XML 结构的基本要素。产品由一组 XML 节点表示。产品列表必须以 <?xml 声明标签开头。

目录源示例

3 - 要提供的产品信息

所有字段名都必须为英文。产品信息不得包含 HTML 标签或样式标签。

3.1 - 为您的产品做广告的必填字段

3.1.1 id

目录源中的所有产品均需包含此字段, 且不得留空。

id 是唯一产品标识符。它可以包含代表一个且仅代表一个产品的字母数字字符。一旦将某个 id 分配给产品并导入,便不能将该 id 用于不同的产品,也不能将该 id 用于特定产品变更。如果您也填充了 item_group_id,请使用子 ID/SKU 填充 id。

字符要求:id 必须以字母或数字开头,并且只能包含 ASCII 字符。

限制:250

类型:字符串

示例:abc123-black-7.5

3.1.2 title

目录源中的所有产品均需包含此字段, 且不得留空

title 是产品的名称,通常如产品详情页面上所显示。它将用作给定产品横幅广告中的主要文本描述符。因为横幅广告的设计使然,较短的名称(不超过 25 个字符)更可能融入到 Criteo 的格式和布局中。

字符要求:名称必须以字母或数字开头,并且只能包含 ASCII 字符。

限制:150(建议 25)

类型:字符串

示例:Working Boots – Size 7.5

3.1.3 description

description 是一段简短文本,用于提供有关产品的除名称外的更多信息。因为横幅广告的设计使然,较短的描述(不超过 50 个字符)更可能融入到 Criteo 的格式和布局中,然而,并非所有的格式和布局都将具有描述。

字符要求:名称必须以字母或数字开头,并且只能包含 ASCII 字符。如含有 HTML 标签,包括样式、嵌入、对象和锚定标签,请删除所有 HTML 标签。

限制:5000(建议 50)

类型:字符串

示例:Excellent for daily use.

3.1.4 google_product_category

分类级别属性表示所提交的产品分类,按照 Google 产品分类法

如果可将您的产品链接到多个分类,我们只想要最相关的分类。

对于中国大陆客户,此字段可用于主目录与次级分类目录关系。

字符要求:我们仅支持完整分类路径。我们不接受路径的分类 ID。

类型:字符串

示例:Women’s > Shoes > Working Boots

3.1.5 link

目录源中的所有产品均需包含此字段, 且不得留空

link 是产品的专用详情页面。对于给定产品, link 通常是唯一的,但并不一定这样。此 URL 上的产品信息应匹配目录源中提供的对应信息。请为所有 URL 指定协议(http:// 或 https://)。

字符要求:link 必须以协议(http:// 或 https://)开头,后跟产品详情页面的完整 URL。所有符号均必须编码。例如,必须将 $ 替换为 %24。

限制:1024

类型:字符串

示例:http://www.example.com/product/working-boots

3.1.6 image_link

目录源中的所有产品均需包含此字段, 且不得留空

image_link 是一个 URL,指定给定产品的图像文件路径。image_link 用于将产品的图像显示在横幅广告中。理想情况下,图像宽度应介于 300 和 400 像素之间,且大小小于 1MB。该图像必须指定 Content-Type 标头,即 image/png 或 image/jpeg。如果您限制可通过 cURL 访问您的图像,请将我们的用户代理列入白名单,以便我们可以在 Criteo 横幅广告中显示您的图像:curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn。

字符要求:image_link 必须以 http://(不是 https://)开头,且后跟产品图像的完整 URL。所有符号均必须编码。例如,必须将 $ 替换为 %24。但是,image_link 不能在查询字符串(? 后的任何字符)中包含任何符号。

限制:2000

类型:字符串

示例:http://www.example.com/product/image/working-boots.png

3.1.7 additional_image_link

additional_image_link 是一个 URL,指定给定产品的图像文件路径,与 image_link 中提供的路径不同。additional_image_link 用于将产品的图像显示在横幅广告中。理想情况下,图像宽度应介于 300 和 400 像素之间,且大小小于 1MB。该图像必须指定 Content-Type 标头,即 image/png 或 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 不能在查询字符串(? 后的任何字符)中包含任何符号。

限制:1024

类型:字符串

示例:http://www.example.com/product/image/working-boots-side.png

3.1.8 availability

availability 表示是否可在网站上购买产品。您可以使用 3 个可能的值填充 availability:preorder(商品当前无法运送,但仍可购买)、out of stock(商品无法运送,且您不接受此商品的订单)和 in stock(商品可运送并可针对此商品下单)。标记为 out of stock 无存货的商品将不在横幅广告中显示。

字符要求:必须使用以下三个值之一填充 availability:

· preorder

· out of stock

· in stock

限制:25

类型:字符串

示例: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 或 mpn

全球贸易项目代码 (GTIN) 是唯一产品标识符,用于标识全球市场中的产品、服务或商品。

GTIN 包括:

  • GTIN-12 (UPC-A):这是一个 12 位数字,最初在北美使用。
  • GTIN-8 (EAN/UCC-8):这是一个 8 位数字,主要在北美以外的地区使用。
  • GTIN-13 (EAN/UCC-13):这是一个 13 位数字,主要在北美以外的地区使用。
  • GTIN-14(EAN/UCC-14 或 ITF-14):这是一个 14 位数字,用于标识各个包装级别的贸易商品。

字符要求:值必须为 8 位、12 位、13,位或 14 位数字(UPC、EAN、JAN, 或 ISBN)。

MPN 是根据制造商唯一标识产品的编号

对于中国大陆客户,此字段为可选字段。

限制:50

类型:字符串

示例:0001234560012

3.1.12 brand

brand 表示产品的品牌名称。某些产品没有关联明确的品牌。在这种情况下,无需提供此信息。

字符要求:名称必须以字母或数字开头,并且只能包含 ASCII 字符。该字段中不应包含任何 HTML 标签,包括样式标签。

限制:70

类型:字符串

示例:Criteo

3.1.13 adult

adult 属性表示产品是否对所有用户及所有受众展示均是安全的。成人产品不能在 Criteo 横幅广告中展示,且可能导致发布商网络将您的广告活动列入黑名单。如果您希望此产品可推荐且在横幅广告中显示,则可将此字段与“否”值一起使用。

字符要求:值必须为 是 或 否

类型:Boolean

示例:否

3.2 - 可选字段

3.2.1 基本产品信息

名称:product_type

product_type 是产品所属的分类(或分类列表)。在这里填充什么分类没有任何限制,因此您可以使用 product_type 映射到网站上的第一级特定分类。product_type 区分大小写,因此如果您使用 women’s 表示一种产品,使用 Women’s 表示另一种产品,Criteo 会将这些产品看作两个不同的分类。

字符要求:product_type 必须以字母或数字开头,并且只能包含 ASCII 字符。分类之间的分隔必须为 >(XML 目录源为 &gt;)。

限制:500

类型:字符串

示例:Women’s &gt; Shoes &gt; Working Boots

3.2.2 mobile_link

mobile_link 是指向您的产品登录页面的移动端优化版本的链接。此 url 应与您在“link”字段中提供的 url 不同。通过提供移动端链接:您将改善客户的用户体验,并缩短登录页面加载延迟。

字符要求:link 必须以协议(http:// 或 https://)开头,后跟产品详情页面的完整 URL。所有符号均必须编码。例如,必须将 $ 替换为 %24。

限制:2000

类型:字符串

示例:http://m.example.com/product/working-boots

3.2.3 condition

condition 用于使用三个不同的容许值限定产品:“new”、“refurbished”和“used”。

字符要求:仅接受以下 3 个值:

  • 'new' [全新]
  • 'refurbished' [翻新]
  • 'used' [二手]

类型:字符串

示例:new

---

产品变体

3.2.6 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 字符。

限制:250

类型:字符串

示例:abc123

3.2.7 color

详情:此属性表示产品的主要颜色。

限制:100

类型:字符串

示例:Black

3.2.8 gender

因性别而异的商品组中的所有产品的必填项。

字符要求:仅接受以下 3 个值:

  • 'male' [男性]
  • 'female' [女性]
  • 'unisex' [中性]

类型:字符串

示例:male

3.2.9 age_group

此属性用于表示您的产品所针对的年龄组。

字符要求:仅接受以下 5 个值:

  • 'newborn' [新生儿]
  • 'infant' [婴儿]
  • 'toddler' [幼童]
  • 'kids' [儿童]
  • 'adult' [成人]

类型:字符串

示例:adult

3.2.10 material

此属性表示产品的制成材料或面料。因材料而异的商品组中的所有产品的必填项。

限制:200

类型:字符串

示例:leather

3.2.11 pattern

此属性表示产品的图案或印花。因图案而异的商品组中的所有产品的必填项。

限制:100

类型:字符串

示例:Striped

3.2.12 size

此属性表示产品的尺码。因尺码而异的商品组中的所有产品的必填项。

限制:100

类型:字符串

示例:L

3.2.13 size_type

您可以通过添加尺码类型来指定产品的款式。

字符要求:仅接受以下 5 个值:

  • 'regular' [常规]
  • 'petite' [小码]
  • 'plus' [略大]
  • 'big and tall' [高大]
  • 'maternity' [孕妇装]

限制:

类型:字符串

示例:regular

3.2.13 size_system

详情:您可以通过添加尺码系统来指定某个国家/地区的产品尺码确定系统。

字符要求:接受以下 11 个值:US、UK、EU、DE、FR、JP、CN(中国)、IT、BR、MEX、AU

限制:

类型:字符串

示例:US

---

发货信息

3.2.14 shipping

该属性用于指定所支持的每个国家/地区的发货详情,指明价格和服务

类型:字符串

示例:

 <shipping>
<country>US</country>
<service>Standard</service>
<price>15.5 USD</price>
</shipping>

3.2.15 shipping_weight

shipping_weight 代表产品的重量。

字符要求:仅接受以下单位:lb、oz、g、kg

类型:字符串

示例:1 kg

3.2.16 shipping_height

shipping_height 代表产品的高度。

3.2.17 shipping_width

shipping_width 代表产品的宽度

3.2.18 shipping_length

详情:shipping_length 代表产品的长度。

3.2.19 shipping_label

此属性可用于使用您选择的值(如,perishable、bulky 或 promotion)将标签分配给特定产品。

限制:100

类型:字符串

示例:promotion

---

产品包装与产品组合

3.2.20 multipack

此属性指定一包相同产品。

类型:Integer

示例:2

3.2.21 is_bundle

此属性指定一组不同产品。

类型:Boolean

示例:FALSE

3.2.22 promotion_id

详情:此属性指定促销 ID。

限制:String

类型:60

示例:123654

---

其他属性

3.2.23 custom_label_0

添加与产品有关的其他自定义信息。

字符要求:仅授权 5 级自定义标签(0 至 4)

限制:100

类型:字符串

3.2.24 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.25 adwords_redirect

用于单独跟踪所有来自 Google Shopping 的点击的 URL。

限制:200

类型:URL

示例:http://www.mywebsite.com/productpage.html

3.2.26 excluded_destination

“excluded destination”属性可阻止商品在某些目的地显示,即使它在您的产品数据中显示。

3.2.27 expiration_date

不再推荐产品的日期。

限制:10

类型:ISO 8601 格式

示例:2016-07-24

3.2.28 unit_pricing_measure

“unit pricing measure”属性定义商品的度量维度。例如,25floz 或 15oz。

示例:15oz

3.2.29 unit_pricing_base_measure

“unit pricing base measure”属性指定您的单价度量偏好。例如,50floz。

示例:50oz

示例目录结构

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>否</g:adult>

            <g:product_type>Women’s &gt; Shoes &gt; 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>

这篇文章有帮助吗?
1 人中有 1 人觉得有帮助
由 Zendesk 提供技术支持