下面整理一份 Criteo Feed 文件格式及字段要求指南,可以直接用于跨境电商或广告投放操作参考:
Criteo 支持以下几种 Feed 文件格式:
| 格式 | 描述 | 建议用途 |
|---|---|---|
| CSV / TSV | 逗号或制表符分隔文本文件 | 小型目录或手动上传 |
| XML | 标准化 XML 格式 | 大型目录或动态更新 |
| Feed URL | 通过 HTTP/HTTPS 提供的在线 Feed | 自动同步商品数据,适合每日更新 |
要求:
文件编码建议 UTF-8。
首行必须包含字段名(Header)。
文件大小:单次上传推荐 ≤ 200 MB,大型目录建议使用 Feed URL 自动同步。
⚠️ 注意:Feed URL 需公开可访问,Criteo 会定期抓取更新。
每条商品记录必须包含以下核心字段:
| 字段 | 类型 | 描述 | 示例 |
|---|---|---|---|
id | string | 商品唯一标识 | SKU12345 |
name | string | 商品名称 | Kids Toy Car |
price | float | 商品价格(数字) | 29.99 |
currency | string | 货币单位(ISO 4217) | USD |
availability | string | 库存状态 | in stock / out of stock |
link | URL | 商品详情页 URL | https://www.example.com/product/123 |
image_link | URL | 商品主图 URL | https://www.example.com/images/123.jpg |
添加这些字段可以优化广告效果:
| 字段 | 描述 | 示例 |
|---|---|---|
category | 商品类别(可多级) | Toys > Vehicles > Cars |
brand | 品牌名称 | Hot Wheels |
description | 商品描述 | Red racing car for kids 3-6 years |
condition | 商品状态 | new / used |
gtin | 全球贸易项目编码(条码) | 1234567890123 |
mpn | 制造商型号 | HW-CAR-001 |
sale_price | 促销价格 | 24.99 |
sale_start_date / sale_end_date | 促销时间 | 2026-03-01 / 2026-03-31 |
小技巧:如果商品会打折,务必提供
sale_price和促销时间字段,这样 Criteo 动态广告会显示折扣信息,提升点击率。
Price & Sale Price:只允许数字或小数点(如 29.99),不要包含货币符号。
Availability:仅支持 in stock、out of stock、preorder。
Link & Image Link:必须可访问 HTTPS URL,否则广告无法拉取图片。
Category:建议使用 > 分隔的层级结构,方便广告自动分类。
| 问题 | 说明 | 解决方法 |
|---|---|---|
| 文件编码错误 | Feed 文件非 UTF-8 | 用 Excel / Google Sheet 保存为 UTF-8 |
| 图片无法访问 | 图片 URL 非公开或有防盗链 | 上传到可公开访问的服务器或 CDN |
| ID 重复 | 同一目录内商品 ID 重复 | 保证每条记录的 ID 唯一且稳定 |
| 价格格式错误 | 包含 $ 或其他符号 | 去掉符号,仅保留数字和小数点 |
✅ 总结
Criteo Feed 是动态广告投放的核心数据源,格式规范和字段完整性直接影响广告效果。
必填字段:id、name、price、currency、availability、link、image_link
推荐字段:category、brand、description、condition、gtin、sale_price 等