王尘宇

搜狐广告汇算-DPA商品库，技术对接白皮书

一、商品库简介

1.1什么是商品库

商品库:广告主在搜狐平台管理其推广的商品或服务的商品数据管理工具,存储的数据包括商品图片、点击地址以及属性标签(名称、价格、品类、描述、库存等等),商品数据以结构化形式存储。

商品:商品指包含了图片、名称、落地页、价格、品类、描述等相关商品属性标签在内的结构化数据。

商品广告:商品广告是指基于商品库中的商品,将商品信息与搜狐大数据结合,为不同用户展现不同的商品,千人千面动态呈现,提高广告投放效果。

1.2为什么要对接商品数据

统一接入商品数据后,广告主能够使用汇算广告投放系统投放广告,实现一次接入多次使用,提高工作效率。

在搭建广告创意时,可以使用商品数据轻松创建广告动态创意标题和图片,实现海量素材千人千面的动态展现,提升广告推广效果。

在更新素材时,客户仅需更新商品数据,当更新后的商品审核通过后,立即触发使用该商品的全端素材更新,提高素材更新的效率。

二、如何对接商品数据

商品数据的对接包含选择商品库对接方式、准备商品数据、创建商品库、更新及删除商品数据等一系列工作。

2.1选择商品库对接方式

需根据客户的商品数据量级、商品更新频率、自身技术能力选择合适的商品库对接方式,并根据每种对接方式的要求准备相关的商品数据。目前支持在线填写手工上传、自动更新三种对接方式。

2.1.1在线填写

适用客户:适合商品数量及商品信息少、无需时常更新、无技术开发支持的客户。

对接方式:在汇算系统中录入商品,支持在线修改、删除商品。

2.1.2手工上传

适用客户:适合商品数量较少、商品更新频率较低、技术开发资源紧张的客户。

对接方式:在汇算系统中手工上传本地文件录入商品,可在线修改、删除已录入商品,支持通过编辑商品文件并重新上传的方式来新增、更新、删除商品。

文件类型:支持EXCEL、XML 两种类型文件。

2.1.3自动更新

适用客户:适合商品数量较多、商品更新较频繁,且拥有一定技术开发能力的客户。

对接方式:通过汇算系统中填写商品文件地址的方式进行自动对接,仅支持通过定期更新商品文件的方式来新增、更新、删除商品。此功能处于内测阶段,如需使用请联系搜狐汇算运营经理。

文件类型:支持XML格式文件或索引XML文件。

2.2准备商品数据

商品数据由必填字段、选填字段组成,手工上传和自动对接两种方式需要客户提前确认商品的字段结构,并按照每种对接方式的要求,准备商品数据,开发相应的商品库文件。

2.2.1数据格式

根据客户所处行业, 在搜狐汇算工具箱的商品库管理模块下载最新的商品库行业模板。

2.2.2字段填写要求

填写的商品数据需满足以下要求:

a)每条商品的必填字段 [id , name , clickurl]不可缺失,否则商品无法对接。

b)选填字段如不需要,可删除。为了保证投放效果,建议尽可能多的填写商品信息。

c)所有图片格式字段必须是 JPG或PNG格式,包括logo 字段,否则影响投放。自定义图片字段(如image1 ),对图片尺寸无强制要求,可用于制作商品广告动态创意图片,可直接用于广告投放。

d)填写的字段必须符合校验规则，如果不符合校验规则则商品无法对接。关于个字段的具体要求,请关注商品库行业模板。

2.2.3 EXCEL文件格式要求

如您选择通过EXCEL文件对接商品数据, 需要注意以下文件要求:

a)文件大小要求 :建议不超过30M。

b)商品数据必须在Excel文件的sheet1中。

c)商品库模板的前五行不可删除 ,请从第六行开始录入商品。

2.2.4 XML文件格式要求

如您选择对接XML格式商品文件,需注意以下文件要求:

a) 手工.上传仅支持每次上传一 个XML文件,每个文件不超过200M。

b)自动更新支持以索引XML的方式-次对接多个XML文件且单个XML文件建议不超过200M , 索引XML中不限制文件个数,目前商品库仅支持HTTP、HTTPS、FTP 协议。请确保索引文件中所有链接均有效，所有索引文件放在sitemapindex块中, sitemap块代表一个索引子文件。 loc 代表索引地址，lastmod记录了对应文件的最后更新时间。商品库不会根据lastmod对XML文件进行过滤。

c)基于XML1.0规范若商品数据中包含XML格式无法识别的无效字符，请务必将该字符进行替换或过滤,以免造成商品入库失败或带来后续的广告展现问题。

XML有效字符范围如下:

#x9| #xA| #xD| [#x20-#xD7FF] | [#xE000- #xFFFD]| [#x10000-#x10FFF]

d)如果商品数据包含非法或其他特殊符号,请使用实体弓|用替换或使用CDATA块包装。CDATA部分由"<![CDATA["开始,由"]]>" 结束,CDATA部分不能包含字符串"I]>"。 也不允许嵌套的CDATA部分。标记CDATA部分结尾的"]]>"不能包含空格或折行。

e)此功能处于内测阶段,如需使用请联系搜狐汇算运营经理。

2.3创建及管理商品库

准备好商品数据后,即可登录搜狐汇算广告投放系统,点击工具箱中的商品库管理模块,进行商品库创建及管理。下文将针对每种对接方式下的商品库创建及管理方式进行详细说明。

2.3.1在线填写

创建商品库.

步骤1:进入汇算后台的工具箱,点击商品库管理模块,进入商品库管理页。

步骤2:在商品库管理页面点击[新增商品库]按钮,进入新增商品库页面,

在此页面中,您可进行以下操作。

a)下载商品库模板介绍 ,可作为模板选择和商品字段填写要求的参考。

b)根据您所在行业选择模板,若已提供的行业模板未包含您所在行业,可选择通用模板,或与搜索汇算运营经理联系。

c)输入您的商品库的名称。

d)选择上传方式为在线填写。选择完成后进入[下-步]。

步骤3:创建好商品库后, 需要根据您的商品数据、投放诉求,勾选您需要的商品字段,作为录入商品时使用的模板。

a) 必填项:根据投放需求选择图片尺寸,至少选择一种尺寸的图片(默认选择大图图片) ,可多选。

b)非必填项:非必填项可用于广告组中筛选商品、广告创意个性化替换、商品推荐;建议根据各字段要求,尽可能多的填写字段,带来更好的投放效果。

注:录入商品时,模板已勾选的字段都将成为必填项,按要求填写后才可保存,不可为空值。

步骤4:设置好商品库模板后,即可开始新增商品。

您需要按照模板中选择字段的要求,逐个填写每个商品信息。当商品中所有字段均按要求填写完成后,点击[保存]按钮,即可保存此商品;若需要继续添加，可点击[保存并继续添加] ,继续添加商品。

搜狐广告平台新增商品

步骤1:找到上传方式为在线填写的商品库,点击[查看商品] ,进入商品管理页面。

步骤2:在商品管理页面中点击[新增商品]按钮。

步骤3: 按照字段要求,填写完整的字段信息。新增商品页需填写的字段为新增商品库版块所选择的必填项和非必填项,填写完成后点击保存。