微信公众号数据接入
最近更新时间：2024.03.27 16:37:51
首次发布时间：2021.11.18 19:35:25
接入微信公众号数据，会默认上报微信公众号用户的关注、扫码、菜单访问、取消关注等事件，用于微信公众号的用户行为分析。
1.1 新增公众号
a.进入“数据管理-数据集成-数据接入-外部数据源”，点击微信公众号，进入接入配置。
如您所在环境为旧版与上图不一致，可进入"数据管理-微信公众号"的公众号管理页面，点击「新接入公众号」，接入公众号。
b. 进入接入公众号页面，填写要接入公众号的信息，获取access_token、填写接收消息地址等。
1.2 获取access_token
可以通过「从微信服务器」和「从中控服务器」两种方式，来获取access_token。
a. 从微信服务器获取
可以通过微信提供的接口，直接从微信服务器获取access_token，需要填写Token、Secret，填写正确后，会默认从微信提供的接口获取access_token。
b. 从中控服务器获取
如果有其他业务同时使用了Token，需自搭建的中控服务，来统一获取、维护access_token，在分析平台中可从中控服务来获取access_token。
说明：
- 中控服务器地址：填写自建的可以获取到access_token中控服务地址；
- access_token：从中控服务器获取的返回值中解析access_token，通过JSONPah表达式解析，填写JSONPath表达式(可参考：https://github.com/json-path/JsonPath)，点击「测试」，测试是否解析成功，解析成功则可正常获取。
c. 配置IP白名单
获取access_token，需在微信公众平台后台配置上增长分析平台的IP白名单，配置后，获取access_token接口才可调用成功。
- 火山引擎增长分析 IP白名单 ，SaaS-字节云版为以下四个名单：
220.243.131.172
220.243.131.173
123.58.10.238
123.58.10.239
- 火山引擎增长分析 IP白名单 ，SaaS-云原生版如下：
- 火山引擎增长分析 IP白名单 ，私有化版本需要您在服务器的出口IP中查看。
1.3 配置接收微信消息和事件的接口信息
配置接收微信消息相关信息，支持接收不同加密方式数据及生成接收数据的服务URL地址。
说明：
- 加密方式
- 安全模式
- EncodingAESKey：用作消息体加解密密钥，与微信公众平台填写一致。
- 安全模式
- 明文模式
- 服务URL
接收数据URL根据部署的内外网域名自动生成。
- 当前域名：即finder后台域名，适合有自建的微信callback服务器，通过内网向Finder转发的情况。
- 上报域名：即SDK数据上报域名，适合从微信服务器直接向Finder发送的情况
同时，需在微信公众平台后台配置接收数据的地址(当前域名/上报域名，如果有自建的微信callback服务器，需配置自建的微信callback服务器地址)
1.4 匿名用户唯一标识设置
设置以UnionID或OpenID来作为匿名用户唯一标识，非必选。
- 接入公众号数据，根据您的设置以UnionID或OpenID来作为匿名用户唯一标识，获取UnionID或OpenID，增长分析平台会转换整型设置web_id。
提示：微信公众号绑定到微信开放平台帐号后会出现该字段，否则该字段的值等同于 OpenID。
完成接入公众号和接收微信消息填写后，会根据填写的接入公众号信息，调微信对应接口，同步公众号历史数据；创建用户，设置属性，并记录「关注」事件。
- 当「开启」时，状态为：
- 数据同步正常：历史数据同步完成
- 连接错误：无法与公众号进行实时数据接收或同步时
- 当「关闭」时，状态为：
- 数据同步暂停
- 删除
- 删除公众号；
- 不会删除已经同步和接收的数据；
- 从一个应用删除后，可以添加到其他应用中。
完成接入公众号和接收微信消息填写后，会根据填写的接收微信消息，接收公众号实时数据；并进行事件的埋点上报。
开启、关闭、删除、状态等公众号管理与同步历史数据相同。
用户属性
微信用户字段 | Finder用户属性 | Finder用户属性中文名 | 类型 | 处理说明 |
|---|---|---|---|---|
openid | {微信appID}.wechat_openid | string | ||
unionid | {微信appID}.wechat_unionid | UnionID | string | |
language | wechat_language | 用户语言（微信） | string | |
subscribe_time | {微信appID}.wechat_subscribe_time | datetime | 将关注时间作为用户的user_register_time，牵扯到历史数据导入 | |
remark | {微信appID}.wechat_remark | 微信备注 | string | |
tagid_list | {微信appID}.wechat_tagid_list | list | 将在微信中给用户打的标签，作为用户的list属性： | |
{微信appID}.wechat_tag_list | 微信用户标签 | list | 同上 | |
groupid | {微信appID}.wechat_groupid | string | ||
qr_scene | {微信appID}.wechat_qr_scene | 作为事件属性 | ||
qr_scene_str | {微信appID}.wechat_qr_scene_str | 作为事件属性 | ||
subscribe_scene | {微信appID}.wechat_subscribe_scene | 微信关注来源 | string | ADD_SCENE_SEARCH 公众号搜索，ADD_SCENE_ACCOUNT_MIGRATION 公众号迁移，ADD_SCENE_PROFILE_CARD 名片分享，ADD_SCENE_QR_CODE 扫描二维码，ADD_SCENE_PROFILE_LINK 图文页内名称点击，ADD_SCENE_PROFILE_ITEM 图文页右上角菜单，ADD_SCENE_PAID 支付后关注，ADD_SCENE_WECHAT_ADVERTISEMENT 微信广告，ADD_SCENE_OTHERS 其他 |
事件属性
事件 | 事件中文名 | 属性/字段 | 微信字段 | 属性类型 | 说明 | 微信接口 |
|---|---|---|---|---|---|---|
wechat_subscribe | 公众号关注 | subscribe_scene | subscribe_scene | string | 用户新关注（包括扫码关注），对应微信事件为subscribe | |
qr_scene | qr_scene | string | 仅扫码关注时有值 | |||
qr_scene_str | qr_scene_str | string | 仅扫码关注时有值 | |||
wechat_unsubscribe | 公众号取关 | 对应微信事件unsubscribe | ||||
wechat_scan | 公众号扫码 | qr_scene | qr_scene | string | 仅扫码关注时有值 | |
qr_scene_str | qr_scene_str | string | 仅扫码关注时有值 | |||
wechat_location | 上报地理位置 | latitude | latitude | string | 对应微信事件LOCATION | |
longitude | longitude | string | ||||
precision | precision | string | ||||
wechat_menu_click | 微信菜单点击 | key | EventKEY | string | 对应微信事件CLICK/VIEW | |
wechat_text_message | 给公众号发文本消息 | message_type | MsgType | string | 文档中的MsgType字段 | |
message_id | MsgId | numberic | 文档中的MsgId字段 | |||
content | Content | string | 当MsgType为text时候，该属性取值为文档中的Content字段，超过属性长度限制部分自动截断 | |||
wechat_image_message | 给公众号发图片消息 | message_type | MsgType | string | 文档中的MsgType字段 | |
message_id | MsgId | numberic | 文档中的MsgId字段 | |||
media_id | MediaId | string | ||||
pic_url | PicUrl | string | ||||
wechat_voice_message | 给公众号发语音消息 | message_type | MsgType | string | 文档中的MsgType字段 | |
message_id | MsgId | numberic | 文档中的MsgId字段 | |||
media_id | MediaId | string | ||||
wechat_video_message | 给公众号发视频消息 | message_type | MsgType | string | 文档中的MsgType字段 | |
message_id | MsgId | numberic | 文档中的MsgId字段 | |||
media_id | MediaId | string | ||||
thumb_media_id | ThumbMediaId | string | ||||
wechat_shotvideo_message | 给公众号发短视频消息 | message_type | MsgType | string | 文档中的MsgType字段 | |
message_id | MsgId | numberic | 文档中的MsgId字段 | |||
media_id | MediaId | string | ||||
thumb_media_id | ThumbMediaId | string | ||||
wechat_location_message | 给公众号发位置消息 | message_type | MsgType | string | 文档中的MsgType字段 | |
message_id | MsgId | numberic | 文档中的MsgId字段 | |||
location_x | Location_X | string | ||||
location_y | Location_Y | string | ||||
scale | Scale | string | ||||
label | Label | string | ||||
wechat_link_message | 给公众号发链接消息 | message_type | MsgType | string | 文档中的MsgType字段 | |
message_id | MsgId | numberic | 文档中的MsgId字段 | |||
title | Title | string | ||||
description | Description | string | ||||
url | url | string |