You need to enable JavaScript to run this app.
导航

微信公众号数据接入

最近更新时间2023.11.03 14:40:29

首次发布时间2021.11.18 19:35:25

接入微信公众号数据,会默认上报微信公众号用户的关注、扫码、菜单访问、取消关注等事件,用于微信公众号的用户行为分析。注:SaaS云原生版本暂不支持此功能。

1. 接入公众号

1.1 新增公众号

a.进入“数据管理-数据集成-数据接入-外部数据源”,点击微信公众号,进入接入配置。
alt

alt

如您所在环境为旧版与上图不一致,可进入"数据管理-微信公众号"的公众号管理页面,点击「新接入公众号」,接入公众号。

image.png

b. 进入接入公众号页面,填写要接入公众号的信息,获取access_token、填写接收消息地址等。

image.png

1.2 获取access_token

可以通过「从微信服务器」和「从中控服务器」两种方式,来获取access_token。

a. 从微信服务器获取

可以通过微信提供的接口,直接从微信服务器获取access_token,需要填写Token、Secret,填写正确后,会默认从微信提供的接口获取access_token。

image.png

b. 从中控服务器获取

如果有其他业务同时使用了Token,需自搭建的中控服务,来统一获取、维护access_token,在分析平台中可从中控服务来获取access_token。

image.png

说明:

  • 中控服务器地址:填写自建的可以获取到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白名单 ,私有化版本需要您在服务器的出口IP中查看。

image.png

1.3 配置接收微信消息和事件的接口信息

配置接收微信消息相关信息,支持接收不同加密方式数据及生成接收数据的服务URL地址。

image.png

说明:

  • 加密方式

    • 安全模式
      • EncodingAESKey:用作消息体加解密密钥,与微信公众平台填写一致。
  • 明文模式

  • 服务URL

接收数据URL根据部署的内外网域名自动生成。

  • 当前域名:即finder后台域名,适合有自建的微信callback服务器,通过内网向Finder转发的情况。

  • 上报域名:即SDK数据上报域名,适合从微信服务器直接向Finder发送的情况

同时,需在微信公众平台后台配置接收数据的地址(当前域名/上报域名,如果有自建的微信callback服务器,需配置自建的微信callback服务器地址)

image.png

1.4 匿名用户唯一标识设置

设置以UnionID或OpenID来作为匿名用户唯一标识,非必选。

  • 接入公众号数据,根据您的设置以UnionID或OpenID来作为匿名用户唯一标识,获取UnionID或OpenID,增长分析平台会转换整型设置web_id。

提示:微信公众号绑定到微信开放平台帐号后会出现该字段,否则该字段的值等同于 OpenID。

image.png

2. 历史数据同步

完成接入公众号和接收微信消息填写后,会根据填写的接入公众号信息,调微信对应接口,同步公众号历史数据;创建用户,设置属性,并记录「关注」事件。

image.png

  • 当「开启」时,状态为:

    • 数据同步正常:历史数据同步完成
  • 连接错误:无法与公众号进行实时数据接收或同步时

  • 当「关闭」时,状态为:

    • 数据同步暂停
  • 删除

    • 删除公众号;
  • 不会删除已经同步和接收的数据;

  • 从一个应用删除后,可以添加到其他应用中。

3. 接收微信消息和事件

完成接入公众号和接收微信消息填写后,会根据填写的接收微信消息,接收公众号实时数据;并进行事件的埋点上报。

image.png

开启、关闭、删除、状态等公众号管理与同步历史数据相同。

4. 用户属性和事件属性定义

用户属性

微信用户字段Finder用户属性Finder用户属性中文名类型处理说明
openid{微信appID}.wechat_openidstring
unionid{微信appID}.wechat_unionidUnionIDstring
languagewechat_language用户语言(微信)string
subscribe_time{微信appID}.wechat_subscribe_timedatetime将关注时间作为用户的user_register_time,牵扯到历史数据导入
remark{微信appID}.wechat_remark微信备注string

tagid_list

{微信appID}.wechat_tagid_list

list

将在微信中给用户打的标签,作为用户的list属性:
wechat_tagid_list:保存微信用户标签id
wechat_tag_list:保存微信用户标签
其中tagid到标签名称的转换参考这个接口

{微信appID}.wechat_tag_list微信用户标签list同上
groupid{微信appID}.wechat_groupidstring
qr_scene{微信appID}.wechat_qr_scene作为事件属性
qr_scene_str{微信appID}.wechat_qr_scene_str作为事件属性
subscribe_scene{微信appID}.wechat_subscribe_scene微信关注来源stringADD_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_scenesubscribe_scenestring用户新关注(包括扫码关注),对应微信事件为subscribe事件推送
qr_sceneqr_scenestring仅扫码关注时有值
qr_scene_strqr_scene_strstring仅扫码关注时有值
wechat_unsubscribe公众号取关对应微信事件unsubscribe
wechat_scan公众号扫码qr_sceneqr_scenestring仅扫码关注时有值
qr_scene_strqr_scene_strstring仅扫码关注时有值
wechat_location上报地理位置latitudelatitudestring对应微信事件LOCATION
longitudelongitudestring
precisionprecisionstring
wechat_menu_click微信菜单点击keyEventKEYstring对应微信事件CLICK/VIEW
wechat_text_message给公众号发文本消息message_typeMsgTypestring文档中的MsgType字段普通消息
message_idMsgIdnumberic文档中的MsgId字段
contentContentstring当MsgType为text时候,该属性取值为文档中的Content字段,超过属性长度限制部分自动截断
wechat_image_message给公众号发图片消息message_typeMsgTypestring文档中的MsgType字段
message_idMsgIdnumberic文档中的MsgId字段
media_idMediaIdstring
pic_urlPicUrlstring
wechat_voice_message给公众号发语音消息message_typeMsgTypestring文档中的MsgType字段
message_idMsgIdnumberic文档中的MsgId字段
media_idMediaIdstring
wechat_video_message给公众号发视频消息message_typeMsgTypestring文档中的MsgType字段
message_idMsgIdnumberic文档中的MsgId字段
media_idMediaIdstring
thumb_media_idThumbMediaIdstring
wechat_shotvideo_message给公众号发短视频消息message_typeMsgTypestring文档中的MsgType字段
message_idMsgIdnumberic文档中的MsgId字段
media_idMediaIdstring
thumb_media_idThumbMediaIdstring
wechat_location_message给公众号发位置消息message_typeMsgTypestring文档中的MsgType字段
message_idMsgIdnumberic文档中的MsgId字段
location_xLocation_Xstring
location_yLocation_Ystring
scaleScalestring
labelLabelstring
wechat_link_message给公众号发链接消息message_typeMsgTypestring文档中的MsgType字段
message_idMsgIdnumberic文档中的MsgId字段
titleTitlestring
descriptionDescriptionstring
urlurlstring