一、有数开户
功能介绍
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投放端效果页的实时订单数据报表，若可以找到记录的订单号，则表明有订单回传，反之请排查订单未回传的原因。
目前腾讯广告营销平台不断在完善自己的后台，一直以来都在满足商家产品广告投放的需求，并且商家进行腾讯广告营销的效果也是十分不错的。如果有想法的广告主可以随时咨询巨宣网络，积累了丰富的行业运营经验，有专业腾讯广告运营团队，包含了腾讯广告开户、腾讯广告推广等多维度的人员，为企业开展产品推广保驾护航。
