# 外站联合归因

# 一、能力简介

对于通过外站媒体平台进行微信小程序推广引流的场景，we 分析提供外站联合归因能力，为开发者带来以下价值：

支持阅读归因：不仅能看到通过推广组件点击直接跳转打开小程序的转化，还能看到浏览广告后用户主动在微信打开对应小程序的转化行为，帮助广告主看到更完整的投放效果。
长效跟踪：支持长达 30 天的归因窗口，覆盖用户决策周期。
完整数据呈现：提供归因明细与统计分析，满足各类分析需求。

当前该能力已支持小红书平台，其他平台敬请期待。

# 二、使用说明

# 2.1 开通功能

登录We 分析平台https://wedata.weixin.qq.com，前往菜单“we 分析--经营工具--推广分析--外站联合归因”，进行相关协议确认与开通后，即可使用本功能。

# 2.2 提供监测链接给媒体平台

把以下监测链接，提供给到外站媒体平台侧。

监测链接：

https://servicewechat.com/bizwxaconvattr/sendattrtracks?advertiser_id=__ADVERTISER_ID__&mini_program_id=__MINI_PROGRAM_ID__&caid=__CAID__&callback_param=__CALLBACK_PARAM__&click_id=__CLICK_ID__&ip=__IP__&oaid=__OAID_MD5__&request_id=__REQUESTID__&ts=__TS__&ua=__UA__&campaign_id=__CAMPAIGN_ID__&unit_id=__UNIT_ID__&creativity_id=__CREATIVITY_ID__&placement=__PLACEMENT__&wx_path=__WX_PATH__

# 2.3 获取转化明细

数据统计口径：当用户发生小程序访问行为后，平台会基于访问发生的时间，匹配前 30 天的广告阅读行为，若能匹配成功，则会生成一条数据。

若一次访问行为能关联多次广告阅读行为（clickid），即用户曾经看过多次广告，则会分别记录一条数据，即一次访问（session_id）匹配一次阅读行为（clickid），映射一条数据。因此，一次访问可能会记录多条数据。

微信平台提供两种方式获取转化明细：

# 2.3.1 方式一：消息推送【建议方式】

通过小程序通用的消息推送能力，将监测数据准实时通知你。

筛选 event：wxa_conversion_attribution，即为本业务的消息。

消息推送的 xml 格式示例：

<xml>
  <ToUserName><![CDATA[gh_demo_to_user]]></ToUserName>
  <FromUserName><![CDATA[oDemoFromUser001]]></FromUserName>
  <CreateTime>1700000000</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[wxa_conversion_attribution]]></Event>

  <!-- ===== 第 1 条 trace ===== -->
  <traces>
    <ctx_request_id><![CDATA[demo-request-001]]></ctx_request_id>
    <ctx_click_id><![CDATA[demo-click-001]]></ctx_click_id>
    <ctx_ts>1700000100</ctx_ts>
    <ctx_ip><![CDATA[demo_ip_hash_001]]></ctx_ip>
    <ctx_ua><![CDATA[DemoUserAgent/1.0]]></ctx_ua>
    <ctx_callback_param><![CDATA[demo_callback_token_001]]></ctx_callback_param>
    <ctx_advertiser_id>10001</ctx_advertiser_id>
    <ctx_campaign_id>20001</ctx_campaign_id>
    <ctx_unit_id>30001</ctx_unit_id>
    <ctx_creativity_id>40001</ctx_creativity_id>
    <ctx_placement><![CDATA[demo_placement_a]]></ctx_placement>
    <ctx_mini_program_id><![CDATA[gh_demo_mini_program]]></ctx_mini_program_id>
    <session_click_time>1700001000001</session_click_time>
    <session_id><![CDATA[demo_session_001]]></session_id>
    <wx_biz_app_id><![CDATA[wx_demo_appid_001]]></wx_biz_app_id>
    <wx_biz_id>50001</wx_biz_id>
    <wx_promotion_id><![CDATA[promo_demo_001]]></wx_promotion_id>
    <wx_material_id><![CDATA[material_demo_001]]></wx_material_id>
    <wx_action_mode>0</wx_action_mode>
    <wx_open_id><![CDATA[oDemoOpenId001]]></wx_open_id>
    <wx_path_url><![CDATA[/pages/sub-page]]></wx_path_url>
    <wx_path_query><![CDATA[id=12345]]></wx_path_query>
    <ext_report_time><![CDATA[1700001000101]]></ext_report_time>
  </traces>

  <!-- ===== 第 2 条 trace ===== -->
  <traces>
    <ctx_request_id><![CDATA[demo-request-002]]></ctx_request_id>
    <ctx_click_id><![CDATA[demo-click-002]]></ctx_click_id>
    <ctx_ts>1700000200</ctx_ts>
    <ctx_ip><![CDATA[demo_ip_hash_002]]></ctx_ip>
    <ctx_ua><![CDATA[DemoUserAgent/1.0]]></ctx_ua>
    <ctx_callback_param><![CDATA[demo_callback_token_002]]></ctx_callback_param>
    <ctx_advertiser_id>10002</ctx_advertiser_id>
    <ctx_campaign_id>20002</ctx_campaign_id>
    <ctx_unit_id>30002</ctx_unit_id>
    <ctx_creativity_id>40002</ctx_creativity_id>
    <ctx_placement><![CDATA[demo_placement_b]]></ctx_placement>
    <ctx_mini_program_id><![CDATA[gh_demo_mini_program]]></ctx_mini_program_id>
    <session_click_time>1700001000002</session_click_time>
    <session_id><![CDATA[demo_session_002]]></session_id>
    <wx_biz_app_id><![CDATA[wx_demo_appid_002]]></wx_biz_app_id>
    <wx_biz_id>50002</wx_biz_id>
    <wx_promotion_id><![CDATA[promo_demo_002]]></wx_promotion_id>
    <wx_material_id><![CDATA[material_demo_002]]></wx_material_id>
    <wx_action_mode>1</wx_action_mode>
    <wx_open_id><![CDATA[oDemoOpenId002]]></wx_open_id>
    <wx_path_url><![CDATA[/pages/sub-page]]></wx_path_url>
    <wx_path_query><![CDATA[id=12345]]></wx_path_query>
    <ext_report_time><![CDATA[1700001000202]]></ext_report_time>
  </traces>

  <!-- ===== 第 3 条 trace ===== -->
  <traces>
    <ctx_request_id><![CDATA[demo-request-003]]></ctx_request_id>
    <ctx_click_id><![CDATA[demo-click-003]]></ctx_click_id>
    <ctx_ts>1700000300</ctx_ts>
    <ctx_ip><![CDATA[demo_ip_hash_003]]></ctx_ip>
    <ctx_ua><![CDATA[DemoUserAgent/1.0]]></ctx_ua>
    <ctx_callback_param><![CDATA[demo_callback_token_003]]></ctx_callback_param>
    <ctx_advertiser_id>10003</ctx_advertiser_id>
    <ctx_campaign_id>20003</ctx_campaign_id>
    <ctx_unit_id>30003</ctx_unit_id>
    <ctx_creativity_id>40003</ctx_creativity_id>
    <ctx_placement><![CDATA[demo_placement_c]]></ctx_placement>
    <ctx_mini_program_id><![CDATA[gh_demo_mini_program]]></ctx_mini_program_id>
    <session_click_time>1700001000003</session_click_time>
    <session_id><![CDATA[demo_session_003]]></session_id>
    <wx_biz_app_id><![CDATA[wx_demo_appid_003]]></wx_biz_app_id>
    <wx_biz_id>50003</wx_biz_id>
    <wx_promotion_id><![CDATA[promo_demo_003]]></wx_promotion_id>
    <wx_material_id><![CDATA[material_demo_003]]></wx_material_id>
    <wx_action_mode>0</wx_action_mode>
    <wx_open_id><![CDATA[oDemoOpenId003]]></wx_open_id>
    <wx_path_url><![CDATA[/pages/sub-page]]></wx_path_url>
    <wx_path_query><![CDATA[id=12345]]></wx_path_query>
    <ext_report_time><![CDATA[1700001000303]]></ext_report_time>
  </traces>
</xml>

备注：推送的字段中，ext_report_time 是访问行为的上报时间，一般可忽略。

# 2.3.2 方式二：主动查询接口

在调用接口前，请登录 we 分析平台 wedata.weixin.qq.com，前往菜单“数据管理--API管理--归因分析--外站联合归因”中点击开启功能。

查看 ACCESS_TOKEN 获取方式

查询接口调用方式与具体字段内容：在你的后台服务中，发起 HTTPS 请求，并设置对应请求参数，以此拉取相关图表的统计数据。

POST https://api.weixin.qq.com/wedata/wedata_get_data?access_token=ACCESS_TOKEN

请求参数：

参数	类型	必填	说明
chart_id	string	是	固定填写 `1001001005`
target_id	string	否	固定填写 `T001`
begin_date	string	是	起始日期，格式 YYYYMMDD
end_date	string	是	截止日期，格式 YYYYMMDD
time_unit	number	是	固定填写 `0`

返回内容：

属性ID	类型	说明
errcode	number	错误码，如正常则为 0，其他错误码参考指引底部的“补充说明”
errmsg	string	错误信息
chart_name	string	拉取数据的图表名称
require_info	object	拉取数据的各项请求参数
chart_result	array<object>	图表数据，具体内容结构，详见“chart_result 内容”

chart_result 内容：

属性ID	类型	说明
target_id	string	指标 ID
chart_header	array<string>	chart_data 里，value 字段下每一个数值所对应的含义
chart_data	array<object>	对应图表的每一点/行数据内容

chart_header 说明：

模块	字段	说明
日期信息	`ds`	日期，形如：20260424
广告参数信息	`ctx_callback_param`	加密字段, 广告参数信息: 举例比如用来区分联调或者生产环节，宏：`_CALLBACK_PARAM__`
	`ctx_request_id`	标识广告请求唯一 ID，用于排查（用于串联RTA一请/二请/曝光/点击的串联），宏：`__REQUESTID__`
	`ctx_click_id`	带来该转化行为的阅读行为ClickID，宏: `__CLICK_ID__`
	`ctx_ts`	ClickID 对应的时间戳，宏: `__TS__`
	`ctx_mini_program_id`	小程序原始 ID: gh_xxx，宏: `__MINI_PROGRAM_ID__`
	`ctx_ip`	用于反作弊，宏：`__IP__` （如果不提供可能会导致无法反作弊，归因成交里会加大被刷单情况）
	`ctx_ua`	UA 样例: Dalvik/2.1.0 (Linux; U; Android 15; 23127PN0CC Build/AQ3A.240627.003) Resolution/1200*2670 Version/8.75.0 Build/8750000 Device/(Xiaomi;23127PN0CC) discover/8.75.0 NetType/WiFi 需要 url encode，宏：`__UA__`
	`ctx_advertiser_id`	该 ClickID 来自的 adv_id: 小红书广告主 adv_id，宏: `__ADVERTISER_ID__`
	`ctx_campaign_id`	广告计划 id，宏：`__CAMPAIGN_ID__`
	`ctx_unit_id`	广告单元 id，宏: `__UNIT_ID__`
	`ctx_creativity_id`	广告创意 id，宏: `__CREATIVITY_ID__`
	`ctx_placement`	放置位置，宏: `__PLACEMENT__`
转化信息	`wx_promotion_id`	we 分析中的推广 ID
	`wx_material_id`	we 分析中的素材 ID
	`wx_biz_id`	业务 id，区分业务平台，0=小红书
	`wx_biz_app_id`	小程序的 appid
	`wx_action_mode`	冗余字段可忽略
	`wx_open_id`	用户在该小程序下的身份 id
	`session_id`	访问转化 ID，用户发生一次访问行为（打开一次小程序）产生的唯一 ID。
	`session_click_time`	访问转化时间
	`wx_path_url`	微信跳转链接路径
	`wx_path_query`	微信跳转链接参数

# 三、注意事项

1、数据延迟

当用户发生小程序访问行为后，平台侧需要一定时间进行数据处理，进行访问行为与之前的广告阅读之间的关联匹配，存在一定耗时。

建议用户发送小程序访问行为的半个小时后，进行查询归因，保障数据完整。

2、访问行为与广告阅读关联的逻辑

当用户发生小程序访问行为后，平台会基于访问发生的时间，匹配前 30 天的广告阅读行为。若一次访问行为能关联多次广告阅读行为（clickid），则会分别记录一条数据，即一次访问（session_id）跟一条阅读行为（clickid）映射一条数据，一次访问可能会记录多条数据。

3、关于主动查询接口与消息推送两者的区别

主动查询接口，需开发者主动调用，支持按日度拉取当天的全量数据；

消息推送，当平台完成归因数据生产后，即会主动推送至开发者设定的服务器。