腾讯广告运营开发侧指引

一、有数开户

功能介绍

1. 有数介绍

腾讯广告营销平台腾讯有数提供一整套数据服务及接口解决方案，为CPS商品广告提供数据通道服务。接入方开发同学将负责有数API的接入，在测试环境上报和正式环境上报商品、订单等数据。

使用指引

2. 有数开户

请填写有数开户申请表《腾讯有数服务申请(商户开发模式)》， 接入目的选择“CPS商品广告”。

填写《申请表》约 1 个工作日后，请使用在《申请表》中登记的手机号，微信扫码登录腾讯有数数据管理，进入<数据接入>-<接入工具>-<密钥管理>，可获得开发账号及测试 token。

二、接口对接及有数测试环境上报

使用指引

1. 接口对接方案

接口对接阶段，请您参考指引，完成以下接口的对接：

1.1 添加数据仓库接口：

每个接口上报数据前都需都添加一个数据仓库，每种数据源类型的数据仓库只可添加一次，该数据仓库在传输数据时可重复使用。

1.2 获取数据仓库接口

1.3 商详新增接口：

注意，若以腾讯优选联盟身份接入请勿填写接口中佣金&推广状态相关字段。

1.4 商详变更接口：

注意，若以腾讯优选联盟身份接入请勿填写接口中佣金&推广状态相关字段。

1.5 订单新增接口：

注意，若以腾讯优选联盟身份接入请勿填写接口中佣金&推广状态相关字段。

1.6 订单状态变更接口

1.7 退款订单新增接口

1.8 退款订单状态变更接口

2. 测试环境上报、测试、验收

2.1 数据上报

在测试环境上报数据，使用腾讯有数<数据接入>-<接入工具>-<日志查询>进行调试。点击【 JSON 】可看到日志明细。提示信息为“✔️”表示数据通过校验。如下图所示，为前端上报数据在指定时间端，沙盒环境报错的情况。

2.2 有数测试环境测试

1） 首次提测

接入状态全部变为“接入中”时，接入状态会自动进入“测试数据测试中”，否则，接入流程不会进入下一阶段。

注意，有数测试需要0.5至1个工作日的时间，请您耐心等待。若1个工作日后，仍未获得测试结果反馈，请联系有数小助手。

2） 测试结果

有数测试助手完成测试，测试结果可见下图消息中心（如测试单无法查看，请联系有数小助手解决）。

3） 继续送测

如需继续送测，可关注“智慧零售数据服务”公众号，随时发起重测并接收测试进度消息提醒。

4） 后续流程

通过数据测试后，可进行下一步：邮件报备有数（邮件报备一般由您的腾讯广告运营侧进行，从项目启动对接时就可发送邮件，请确保在AMS数据实测验收前完成）。

三、有数正式环境上报

使用指引

1. 预上线阶段

腾讯有数<数据接入>-<接入工具>-<接入进度>所有接口显示“接入完成”，表明进入预上线阶段，可查看正式token进行正式环境上报。

2. 正式环境上报

2.1 替换正式token

进入<数据接入>-<接入工具>-<密钥管理>，可查看正式 token ，替换正式token之后，可以进行正式环境的上报。

2.2 后端url替换

后端 API 测试环境 url：https://test.zhls.qq.com/， 替换为后端 API 生产环境 url：https://zhls.qq.com/。

四、Q&A

常见问题

1. 有数接口相关

问题1： 申请有数开户时，勾选了其他业务，会有影响吗？

回答： 会的，请与有数小助手取得联系，挂起CPS业务外的接口。

问题2： 如果之前已经全量接入有数的情况下，对接CPS业务是否需要重新建一个CPS业务的数据仓库？

回答： 您可以参考《有数数据仓库介绍》，结合期望的应用场景，进行评估。

问题3： 有数的待接入接口中，出现了指引中没提到的接口，怎么办呢？

回答： 这是因为申请有数账户时，勾选了其他业务造成的。请与有数小助手取得联系，挂起CPS业务外的接口。

2. 接口字段相关

问题1： 销量字段是否可以不传？

回答： 请确保填写销量字段，销量佣金比例等等因素都是推荐商品的评价依据，不传销量字段可能会影响商品露出。

问题2： 有数测试阶段上报数据时，tx_cps_id字段如何获取呢？

回答： 有数测试阶段只会验证数据的格式，因此您只需要根据数据格式规范上报定值即可。

问题3： 前台类目和后台类目有区别吗，如果类目与AMS的不一致怎么办？

回答： 我们会根据上报的商品信息通过模型进行类目识别，因此不用担心类目不一致的问题。此外，前台类目是面向C端消费者的类目体系，后台类目是后台存储的类目体系，您可以任意选择一个类目体系进行上报。

问题4： 如果我们没有店铺体系，那么怎么处理店铺信息相关字段呢？

回答： 若您没有店铺体系，可以将店铺信息写死为一个固定值进行上报。

3. 订单状态上报相关

问题1： 什么情况下会使用退款订单新增接口上报退款单呢？

回答： 请参考下图，进行订单状态的上报。

4. 下单自测相关

问题1： 如果希望进行自测，请问怎么进行下单自测呢？

回答： 您可以登录CPS投放端，进入商品页，点击“验证下单”button，之后手机扫码完成下单，并记录订单号。之后，您可以在CPS投放端效果页的实时订单数据报表，若可以找到记录的订单号，则表明有订单回传，反之请排查订单未回传的原因。

目前腾讯广告营销平台不断在完善自己的后台，一直以来都在满足商家产品广告投放的需求，并且商家进行腾讯广告营销的效果也是十分不错的。如果有想法的广告主可以随时咨询巨宣网络，积累了丰富的行业运营经验，有专业腾讯广告运营团队，包含了腾讯广告开户、腾讯广告推广等多维度的人员，为企业开展产品推广保驾护航。

公司优势

开户流程

注意事项