SDK

通用

如何下载 SDK？

答：打开页面后，mac 系统操作 command + s 或 windows 系统操作 ctrl + s 保存到本地。

问：每个事件的名称是？

答：事件名称在文档【快速接入】-【事件类型】中查看，是每个事件类型中的第一行标题。以页面浏览为例，"type": "browse_wxapp_page"。

问：我们之前上报的小程序 appid 是 wx44c503xxxxxxxxxx，换了个测试的小程序 appid wx06b8e7xxxxxxxxxx，已修改了新小程序的 app.js 文件，发现获取到的 openid 已是新小程序的，但 appid 仍然是旧的。

答：清除缓存。

扫描有数生成的二维码后，打不开小程序怎么办？

答：有数默认生成 B 码（没有数量限制），若不作兼容，扫码后可能打开空白的页面，或报“参数为空”的提示。 B 码的页面参数放在 scene 字段中，扫描打开页面时，需要从 scene 字段中获取参数，请开发同学注意兼容，详见文档 (opens new window)。

商品

问：商品卡曝光、商品卡触发、商品页浏览、商品加购等行为中要求商品 spu 信息必传。但我们商品只到 sku 级别，如何处理？

答：当商品没有 spu 信息时，spu_id 传 sku_id，spu_name 传 sku_name 即可。

问：请问商品卡曝光如何上报？逐个上报影响性能，有没有批量上报的方法？

答：SDK 有队列缓存机制，会批量缓存后一起上报，不会影响性能。

API

通用

问：接口的调用频次是？

答：接口调用频次是 1000 条/秒。单次 100 条。

若出现频次超限提示，可联系 youshu_helper 上调频次。

数据仓库

问：如何使用数据仓库接口？

答：每个接口需创建一个自己的数据仓库，供数据传输使用。

问：创建数据仓库时返回retcode: 16 errmsg: data_source_already_exist，该如何处理？

答：该返回代表该接口已创建过数据仓库，请使用获取数据仓库接口获取已创建好的 dataSourceId 。

问：既然数据仓库每个接口只能创建一个，为何不系统默认生成？

答：有数数据管理是您在腾讯的数据资产管理平台，当同一个接口的数据产生不同数据使用场景时需以 dataSourceId 区分 。如订单传输历史数据场景时，您将使用有数提供的 dataSourceId。

订单

问：订单状态很多，该传哪些状态？

答：必传的订单状态有 1110 待支付，1130未支付取消，1140已支付未发货取消，1150 已支付待发货，1160 已发货，1180 销售完成/已收货。具体可参考枚举列表

问：订单金额如何传输？

答：商品a，单价20 元，2件；商品b， 单价30 元，2件；运费 10 元，满足了满 100 减 10 元的活动，用户最终支付了 100 元，传输内容如下：

goods_amount_total 100 元

freight_amount 10元

order_amount 110元

payable_amount 100元

payment_amount 100元

goods_info[]中

商品a goods_amount = 20元，payment_amount = 36 元

商品b goods_amount = 30元，payment_amount = 54 元

问：接入有数后可以将历史数据导入吗？

答：历史数据可以在用户分析&广告投放使用，经营分析报表暂不支持历史数据的展示。

问：如何传输历史订单？

答：有数将 > t - 1 的订单都视为历史订单。传输历史订单时，请dataSourceId改为10001。

"dataSourceId": "10001"

其他参数规范，与add_order接口一致。

传输完成历史订单后，请及时更换为原dataSourceId。

测试工具

问：异常数据的说明看不懂。

答：举例：props->shipping_shop->shipping_shop_id：$.props.shipping_shop.shipping_shop_id: integer found, string expected 意思是 props 中的 shipping_shop_id 传的类型是 integer，应改为 string 。

问：已上报了行为，为何接入进度-接入状态还是“待接入”？

答：接入状态按小时更新。

数据应用

问：完成对接后，还需多久可以使用有数呢？

答：数据对接是您使用腾讯数据产品的基础服务。完成对接后，数据服务将告知有数，由有数引导您进入权限申请步骤。