一、应用场景介绍

品牌客户小程序私域经营平台，提供商城分析、全触点分析、商品分析、用户洞察等能力。

二、接入准备

填写 客户自接入模式申请接入 (opens new window)，接入场景选择”有数商城分析“。

三、接入内容

总览

腾讯有数场景需要接入的行为和接口如下。

数据类型	行为/接口名称	行为/接口描述	备注
浏览运营	app_launch	启动应用	预置
浏览运营	app_show	显示应用	预置
浏览运营	exit_wxapp	隐藏应用	预置
浏览运营	browse_wxapp_page	浏览页面	可代理
浏览运营	leave_wxapp_page	离开页面	可代理
浏览运营	page_share_app_message	页面分享	可代理
浏览运营	page_pull_down_refresh	下拉刷新页面	可代理
浏览运营	page_reach_bottom	上拉触底页面	可代理
搜索运营	search	搜索	可代理
商品运营	expose_sku_component	曝光商品卡
商品运营	trigger_sku_component	点击商品卡
商品运营	browse_sku_page	浏览商品详情页
商品运营	add_to_cart	加购商品
销售转化	custom_order	购买商品
订单接口	/data-api/v1/order/add_order	添加/更新主订单
订单接口	/data-api/v1/order/add_order_sum	订单汇总接口
微信数据	/data-api/v1/analysis/add_wxapp_visit_page	上报页面访问数据

预置：指使用有数 SDK 可自动上报的行为，无需开发。

可代理：指可开启 pageProxy 自动上报行为，具体方法及注意事项可见各行为描述。

细节（供评估）

订单

请求地址

域名/data-api/v1/order/add_order

请求方法

POST

请求参数

参数名	样例	描述
app_id	abc	分配的app_id
nonce	61794670f155b	随机字符串
sign	sha256	签名算法
timestamp	1569232087	请求时间戳（秒级）
signature	aee30792812d7b09ba7d3aa67c24e16c6a7ea81282ac728ad5966dd1b3eef6d5	签名结果

请求体类型

application/json

请求体参数

名称	类型	必填	描述
dataSourceId	string	Y	数据源id（create方法返回的data.dataSource.id）
orders	array	Y	订单列表 数组最大长度 50
external_order_id	string	Y	商家订单号
create_time	string	Y	订单创建时间，unix时间戳 字段长度为 13 字节
order_source	string	Y	订单来源,枚举值:商家小程序：wxapp；商家app：app；商家H5：mobileweb；商家pcweb：pcweb；线下人工pos：offstore_pos_manual；线下自助收银：offstore_pos_self_help；其他：other
order_type	integer	Y	订单类型；1：普通订单；2：充值订单；3：消费订单（如停车费）；4:预售订单_预付；5：预售订单_尾款；6：商品券订单（指定商品的券，视同为购买了商品）；7：积分订单；8：代金券订单（所有商品可使用的券） 普通购买商品订单传 1 即可
goods_num_total	integer	Y	订单商品总数量
goods_weight	float		订单商品总重量，默认单位为克
goods_amount_total	float	Y	商品总金额，单位默认为元 注：已含单品级别优惠的商品金额，如单品直降
freight_amount	float	Y	订单运费，单位默认为元 注：运费为0时，传0.00
order_amount	float	Y	订单金额，单位默认为元 注：商品总金额+运费金额=订单金额
payable_amount	float	Y	订单应付金额，单位默认为元 注：订单金额-订单级别的优惠金额（如：订单满减）=订单应付金额
payment_amount	float	Y	实付金额，单位默认为元 注：订单应付金额-支付优惠金额（如：微信支付优惠、招商银行优惠等）=订单实付金额
order_status	string	Y	主订单状态，1110待支付，1130未支付取消，1140已支付未发货取消，1150已支付待发货/已支付待核销，1160已发货，1180销售完成/已收货/已核销，2150已失效（违规类订单）
status_change_time	string	Y	状态变更时间，unix毫秒级时间，如 order_status状态为 1150 ，则传 1150（已支付待发货）状态变更的时间
user_info	object	Y	用户信息，json格式
open_id	string	Y	下单人 open_id，order_source = wxapp时，必填
goods_info	array	Y	主订单商品信息，数组类型，每个sku存一个数组单位
external_sku_id	string	Y	sku 编号
sku_name_chinese	string	Y	sku 名称
goods_amount	float	Y	单件商品原价，单位默认为元
current_amount	float		当前商品的单件现价，单位默认为元
payment_amount	float	Y	多件商品实付金额（分摊了优惠的金额）,单位默认为元，注：有数GMV计算使用该字段
is_gift	integer		是否赠品，0代表非赠品，1代表赠品
external_spu_id	string	Y	sku 所属 spu 编号，若无 spu，传输内容请与 external_sku_id 保持一致
spu_name_chinese	string	Y	spu 名称，若无 spu，传输内容请与 sku_name_chinese 保持一致
category_id	string		末级类目 id
category_name	string		末级类目名称
goods_num	integer	Y	商品数量
store_info	object		订单销售门店信息
external_store_id	string		主订单销售门店id
store_name	string		主订单销售门店名称，如是线上门店，可填写线上门店名称
store_city	string		主订单销售门店所属城市
is_deleted	integer		商家标记订单已删除，0：未删除；1：已删除，为空默认为 0

导购分析模块

如需使用导购分析模块，需在以下行为中增加 guide_id 传输，用以追踪导购引流效果。

数据类型	行为/接口名称	行为/接口描述
浏览行为	app_launch	启动应用
浏览行为	app_show	显示应用
浏览行为	exit_wxapp	隐藏应用
浏览行为	browse_wxapp_page	浏览页面
浏览行为	leave_wxapp_page	离开页面
浏览行为	page_share_app_message	分享页面
浏览行为	page_pull_down_refresh	下拉刷新页面
浏览行为	page_reach_bottom	上拉触底页面
搜索行为	search	搜索
商品行为	expose_sku_component	曝光商品卡
商品行为	trigger_sku_component	点击商品卡
商品行为	browse_sku_page	浏览商品详情页
商品行为	add_to_cart	加购商品
下单行为	custom_order	购买商品
订单接口	/data-api/v1/order/add_order	添加/更新主订单

前端示例

"chan": {
	"chan_id": "8_ac3e76c2e5721f5f",
	"guide_id": "100014533",  // 导购 id
	"chan_wxapp_scene": "1037"
}

后端示例

"chan_info": [
    {
        "chan_wxapp": {
            "chan_scene": "1140"
        },
        "chan_id": "8_5a23p4ded6ff6384",
        "guide_id": "100014533"
    }
]

直播分析模块（SDK自动采集）

如需使用直播分析模块，需在以下行为中增加 room_id 传输，用以追踪直播引流效果。

数据类型	行为/接口名称	行为/接口描述
浏览行为	app_launch	启动应用
浏览行为	app_show	显示应用
浏览行为	exit_wxapp	隐藏应用
浏览行为	browse_wxapp_page	浏览页面
浏览行为	leave_wxapp_page	离开页面
浏览行为	page_share_app_message	分享页面
浏览行为	page_pull_down_refresh	下拉刷新页面
浏览行为	page_reach_bottom	上拉触底页面
搜索行为	search	搜索
商品行为	expose_sku_component	曝光商品卡
商品行为	trigger_sku_component	点击商品卡
商品行为	browse_sku_page	浏览商品详情页
商品行为	add_to_cart	加购商品
下单行为	custom_order	购买商品
订单接口	/data-api/v1/order/add_order	添加/更新主订单

前端示例

"chan": {
	"chan_id": "8_ac3e76c2e5721f5f",
	"room_id": "288",  // 直播房间号 id
	"chan_wxapp_scene": "1037"
}

后端示例

"chan_info": [
    {
        "chan_wxapp": {
            "chan_scene": "1140"
        },
        "chan_id": "8_5a23p4ded6ff6384",
        "room_id": "288"
    }
]

广告分析模块（SDK自动采集）

如需使用广告分析模块，需在以下行为中增加 weixinadinfo 传输，用以追踪广告引流效果。

数据类型	行为/接口名称	行为/接口描述
浏览行为	app_launch	启动应用
浏览行为	app_show	显示应用
浏览行为	exit_wxapp	隐藏应用
浏览行为	browse_wxapp_page	浏览页面
浏览行为	leave_wxapp_page	离开页面
浏览行为	page_share_app_message	分享页面
浏览行为	page_pull_down_refresh	下拉刷新页面
浏览行为	page_reach_bottom	上拉触底页面
搜索行为	search	搜索
商品行为	expose_sku_component	曝光商品卡
商品行为	trigger_sku_component	点击商品卡
商品行为	browse_sku_page	浏览商品详情页
商品行为	add_to_cart	加购商品
下单行为	custom_order	购买商品

前端示例

"chan": {
	"chan_id": "8_ac3e76c2e5721f5f",
	"weixinadinfo": "373636588.wx0ajmpjcn7c75jc00.1008.1",  // 广告 id
	"chan_wxapp_scene": "1037"
}

门店分析

如需使用门店分析模块，需在以下行为中增加 store_name 和 external_store_id 传输，用以统计门店经营效果。

数据类型	行为/接口名称	行为/接口描述
浏览行为	app_launch	启动应用
浏览行为	app_show	显示应用
浏览行为	exit_wxapp	隐藏应用
浏览行为	browse_wxapp_page	浏览页面
浏览行为	leave_wxapp_page	离开页面
浏览行为	page_share_app_message	分享页面
浏览行为	page_pull_down_refresh	下拉刷新页面
浏览行为	page_reach_bottom	上拉触底页面
搜索行为	search	搜索
商品行为	expose_sku_component	曝光商品卡
商品行为	trigger_sku_component	点击商品卡
商品行为	browse_sku_page	浏览商品详情页
商品行为	add_to_cart	加购商品
下单行为	custom_order	购买商品
订单接口	/data-api/v1/order/add_order	添加/更新主订单

前端示例

"chan": {
	"chan_id": "8_ac3e76c2e5721f5f",
	"chan_shop_id": "101019",  // 门店 id
	"chan_wxapp_scene": "1037"
}

后端示例

"store_info": {
    "store_name": "广州怡安花园",
    "external_store_id": "101019"  // 门店 id
}

公众号分析

公众号与小程序用户连通条件：

• 公众号与小程序的认证主体一致
• 公众号与小程序绑定同一个微信开放平台
• 小程序上报数据包含 unionid 字段。请参考SDK公共属性中 unionid 字段。

数据类型	数据传输方式
公众号图文数据	公众号授权

四、数据接入

按照DataNexus (opens new window)<数据接入>-<工作台>完成接入。

五、查看已接入的数据

六、数据分发

1、完成数据授权

微信扫码登录DataNexus (opens new window)，进入<数据接入>-<接入工具>-<我的应用>，选择“应用名称”为“有数商城分析”，“应用ID”为“11”，点击【开启授权】。

授权状态变更为“已授权”。

3、启动数据推送

请告知您的技术同学已完成数据授权，请他们开始推送数据。

FAQ

问：可以一次性勾选多个应用场景接入吗？

答：可以的，选择多个应用场景后，您<工作台>中的【接入文档】及校验标准将自动调整为多场景的交集，以便您一次开发可同时满足多种应用。