You need to enable JavaScript to run this app.
导航
微信公众号数据接入
最近更新时间:2024.04.30 15:17:25首次发布时间:2024.04.30 15:17:25

接入微信公众号数据,会默认上报微信公众号用户的关注、扫码、菜单访问、取消关注等事件,用于微信公众号的用户行为分析。

1. 接入公众号

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-云原生版如下:

180.184.102.25
111.62.107.192
111.62.107.22

  • 火山引擎增长分析 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。

图片

2. 历史数据同步

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

  • 当「开启」时,状态为:
    • 数据同步正常:历史数据同步完成
  • 连接错误:无法与公众号进行实时数据接收或同步时
  • 当「关闭」时,状态为:
    • 数据同步暂停
  • 删除
    • 删除公众号;
  • 不会删除已经同步和接收的数据;
  • 从一个应用删除后,可以添加到其他应用中。

3. 接收微信消息和事件

完成接入公众号和接收微信消息填写后,会根据填写的接收微信消息,接收公众号实时数据;并进行事件的埋点上报。
图片
开启、关闭、删除、状态等公众号管理与同步历史数据相同。

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

用户属性

微信用户字段

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属性:
wechat_tagid_list:保存微信用户标签id
wechat_tag_list:保存微信用户标签
其中tagid到标签名称的转换参考这个接口

{微信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