You need to enable JavaScript to run this app.
导航
微信公众号三方授权接入
最近更新时间:2025.06.13 11:03:47首次发布时间:2025.06.13 11:03:47
我的收藏
有用
有用
无用
无用

如果您的微信公众号为三方平台托管状态,或者您的微信公众号数据有多个分析主体希望对不同主体分别进行数据分析,您可使用微信公众号三方授权接入的方式上报微信公众号数据。本文为您介绍微信公众号三方授权接入的操作要点和详细步骤。

注意事项
  • 当前从私有化5.1.0版本开始支持“微信公众号三方授权”方式进行接入,且此功能默认关闭,如果您希望使用此功能,请联系火山引擎技术支持人员打开功能开关。
  • 当前暂不支持采集历史数据。
  • 当前一个微信公众号支持通过三方授权方式接入不同的应用中,如果您的微信公众号的数据分析主体有多个主体,可联合多主体功能,将微信公众号绑定到不同的应用(主体)中,后续分析时可选择对应主体进行数据分析。
    多主体功能详情请参见使用多主体

接入公众号
  1. 进入“数据管理-数据集成-数据接入-外部数据源”,点击微信公众号三方授权,进入接入配置。
    Image

  2. 单击新接入公众号,进入接入公众号页面,配置接入的基本信息、授权等配置。
    Image

    配置模块

    配置说明

    基本信息

    在数据接入名称处自定义数据接入的名称,用于标识接入的公众号。

    账号授权

    单击界面的“点击认证”链接,页面会跳转至公众号授权二维码页面。请公众号管理员扫描二维码,根据界面提示完成对DataFinder的授权操作。

    注意

    • 进行授权操作时,请务必保持授予了消息管理权限、用户管理权限,否则授权无效。
    • 完成授权操作后,界面会提示“已授权”,如果没有提示“已授权”,可单击刷新,直至界面显示“已授权”。

    接入配置

    在“上报地址”中配置数据上报地址,注意,请配置为批量上报的地址(即地址URL尾部有“list”的地址)。私有化环境的数据上报地址请联系管理员进行咨询。

    匿名用户唯一标识设置

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

    说明

    如果您的微信公众号和小程序绑定了,此处可以选择使用UnionID作为匿名用户ID,后续数据上报至DataFinder后可通过UnionID将小程序和公众号的数据进行关联,将用户识别为同一个用户。

接收/关闭接收数据
  • 完成接入配置后,数据即开始自动采集上报。
  • 如果您不需要继续采集上报,可直接删除对应的接入配置。
    Image

参考:支持介入的用户属性和事件属性列表

用户属性

微信用户字段

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