微信公众平台开发概述 微信开发者规范 微信公众号接口权限说明 微信公众号接口调用频次限制说明 微信开发者平台接入指南 微信公众平台 接口域名说明 微信公众平台 获取access_token 获取微信服务器IP地址 报警排查指引 接口测试号申请 自定义菜单创建接口 自定义菜单查询接口 自定义菜单删除接口 自定义菜单事件推送 个性化菜单接口 获取自定义菜单配置接口 接收普通消息 接收事件推送 被动回复用户消息 消息加解密说明 客服消息 高级群发接口 模板消息接口 模板消息运营规范 获取公众号的自动回复规则 微信网页授权 微信网页开发样式库 微信JS-SDK说明文档 微信web开发者工具 新增临时素材 获取临时素材 新增永久素材 删除永久素材 修改永久图文素材 获取素材总数 获取素材列表 用户标签管理 设置用户备注名 获取用户基本信息(UnionID机制) 获取用户列表 获取用户地理位置 黑名单管理 生成带参数的二维码 长链接转短链接接口 微信认证事件推送 用户分析数据接口 图文分析数据接口 消息分析数据接口 接口分析数据接口 微信卡券接口 创建卡券 投放卡券 核销卡券 管理卡券 卡券事件推送 会员卡专区(一) 会员卡专区(二) 朋友的券专区 特殊票券 第三方开发者模式 卡券错误码 微信门店接口 微信小店接口 语义理解接口 微信服务号设备功能介绍 如何新增产品型号 将消息转发到微信客服 微信客服管理 微信会话控制 微信获取聊天记录 申请开通微信摇一摇 微信设备ID 微信摇一摇页面管理 微信摇一摇上传图片素材 管理设备与页面的关联关系 微信摇一摇数据统计 摇一摇关注的JSAPI 摇一摇事件通知 html5页面获取设备信息 微信摇一摇获取设备及用户信息 摇一摇红包介绍说明 摇一摇周边错误码 微信连Wi-Fi开发者指引 Wi-Fi硬件鉴权协议接口说明 Wi-Fi软件服务管理接口说明 开通微信连Wi-Fi插件 Wi-Fi门店管理 Wi-Fi设备管理 配置微信WiFi联网方式 微信商家主页管理 Wi-Fi数据统计 连网后下发消息 微信卡券投放 微信Wi-Fi接口返回错误码 微信连网过程常见错误码 微信扫一扫接入指南 微信上进行商品创建 微信商品发布 微信商品管理 扫一扫事件推送 一物一码专区 扫一扫错误码 在线帮助工具

微信门店

微信公众平台开发者文档

浏览43352
更新时间2022-04-11

扫一扫事件推送

微信扫一扫


事件推送

用户打开商品主页,用户从商品主页关注或进入公众号等情况下均会触发事件推送。该事件将推送至商户填写的URL(登录微信公众平台=>开发者中心设置)。 开发者可通过事件推送完成数据统计、用户身份识别等操作,实现更加精准的运营。

微信服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次。关于重试的消息排重,推荐使用FromUserName + CreateTime 排重。假如服务器无法保证在五秒内处理并回复,可以直接回复空串,微信服务器不会对此作任何处理,并且不会发起重试。

打开商品主页事件推送

当用户打开商品主页,无论是通过扫码,还是从其他场景(会话、收藏或朋友圈)打开,微信均会推送该事件到商户填写的URL。推送的内容包括用户基本信息,以及商品主页对应的码信息。

推送XML示例

<xml>
 <ToUserName><![CDATA[gh_4e47c9c9ecad]]></ToUserName>
 <FromUserName><![CDATA[okkeXs1nI-xU4ql8-5BXkv1f0gDo]]></FromUserName>
 <CreateTime>1438250110</CreateTime>
 <MsgType><![CDATA[event]]></MsgType>
 <Event><![CDATA[user_scan_product]]></Event>
 <KeyStandard><![CDATA[ean13]]></KeyStandard>
 <KeyStr><![CDATA[6901481811083]]></KeyStr>
 <Country><![CDATA[中国]]></Country>
 <Province><![CDATA[广东]]></Province>
 <City><![CDATA[揭阳]]></City>
 <Sex>1</Sex>
 <Scene>2</Scene>
 <ExtInfo><![CDATA[123]]></ExtInfo>
</xml>

推送参数说明

参数 说明
ToUserName 商户的公众号原始id。
FromUserName 用户的openid。
CreateTime 消息创建时间(整型)。
MsgType 消息类型,event。
Event 事件类型,user_scan_product为打开商品主页事件。
KeyStandard 商品编码标准。
KeyStr 商品编码内容。
Country 用户在微信内设置的国家。
Province 用户在微信内设置的省份。
City 用户在微信内设置的城市 。
Sex 用户的性别,1为男性,2为女性,0代表未知。
Scene 打开商品主页的场景,1为扫码,2为其他打开场景(如会话、收藏或朋友圈)。
ExtInfo 调用“获取商品二维码接口”时传入的extinfo,为标识参数。

关注公众号事件推送

当用户在商品主页中关注公众号,微信会推送该事件到商户填写的URL。推送的内容包括关注用户的基本信息、时间、关注场景及对应的码信息。

推送XML示例

<xml>
  <ToUserName><![CDATA[gh_fbe8a958756e]]></ToUserName>
  <FromUserName><![CDATA[otAzGjrS4AYCmeJM1GhEOcHXXTAo]]></FromUserName>
  <CreateTime>1433259128</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[subscribe]]></Event>
  <EventKey><![CDATA[scene|keystandard|keystr|extinfo]></EventKey>
</xml>

推送参数说明

参数 说明
ToUserName 商户的公众号原始id。
FromUserName 用户的openid。
CreateTime 消息创建时间(整型)。
MsgType 消息类型,event。
Event 事件类型,subscribe为关注公众号事件。
EventKey ”分割。①scene表示场景:scanbarcode为扫码场景,scanimage为扫封面(图像)场景。②keystandard表示商品编码标准:barcode为条码。③keystr表示商品编码内容。④extinfo表示调用“获取商品二维码接口”时传入的extinfo,为标识参数。

进入公众号事件推送

当用户从商品主页进入公众号会话时,微信会推送该事件到商户填写的URL。推送的内容包括用户的基本信息、时间、关注场景及对应的条码信息。

推送XML示例

<xml>
  <ToUserName><![CDATA[gh_fbe8a958756e]]></ToUserName>
  <FromUserName><![CDATA[otAzGjrS4AYCmeJM1GhEOcHXXTAo]]></FromUserName>
  <CreateTime>1433259128</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[user_scan_product_enter_session]]></Event>
  <KeyStandard><![CDATA[ena13]]></KeyStandard>
  <KeyStr><![CDATA[6954767461373]]></KeyStr>
  <ExtInfo><![CDATA[]]></ExtInfo>
</xml>

推送参数说明

参数 说明
ToUserName 商户的公众号原始id。
FromUserName 用户的openid。
CreateTime 消息创建时间(整型)。
MsgType 消息类型,event。
Event 事件类型,user_scan_product_enter_session为进入公众号事件。
KeyStandard 商品编码标准。
KeyStr 商品编码内容。
ExtInfo 调用“获取商品二维码接口”时传入的extinfo,为标识参数。

地理位置信息异步推送

当用户打开商品主页,微信会将该用户实时的地理位置信息以异步事件的形式推送到商户填写的URL。商户可利用该信息做数据分析,形成差异化运营方案或指导生产。

推送的地理位置信息为“省”一级,如广东省。由于用户的网速影响,异步推送的响应速度可能较慢。


推送XML示例

<xml>
  <ToUserName><![CDATA[gh_fbe8a958756e]]></ToUserName>
  <FromUserName><![CDATA[otAzGjrS4AYCmeJM1GhEOcHXXTAo]]></FromUserName>
  <CreateTime>1434541327</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[user_scan_product_async]]></Event>
  <KeyStandard><![CDATA[qrcode]]></KeyStandard>
  <KeyStr><![CDATA[lincolntest2]]></KeyStr>
  <ExtInfo><![CDATA[123]]></ExtInfo>
  <RegionCode><![CDATA[440105]]></RegionCode>
</xml>

推送参数说明

参数 说明
ToUserName 商户的公众号原始id。
FromUserName 用户的openid。
CreateTime 消息创建时间(整型)。
MsgType 消息类型,event。
Event 事件类型,user_scan_product_async为异步事件。
KeyStandard 商品编码标准。
KeyStr 商品编码内容。
ExtInfo 调用“获取商品二维码接口”时传入的extinfo,为标识参数。
RegionCode 用户的实时地理位置信息(目前只精确到省一级),可在国家统计局网站查到对应明细:http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/201504/t20150415_712722.html

商品审核结果推送

提交审核的商品,完成审核后,微信会将审核结果以事件的形式推送到商户填写的URL。

推送XML示例

<xml>
 <ToUserName><![CDATA[gh_404e58ec528e]]></ToUserName>
 <FromUserName><![CDATA[od_ikt8qi21-hVTtYgm8xSfTLH5w]]></FromUserName>
 <CreateTime>1450429257</CreateTime>
 <MsgType><![CDATA[event]]></MsgType>
 <Event><![CDATA[user_scan_product_verify_action]]></Event>
 <KeyStandard><![CDATA[ean13]]></KeyStandard>
 <KeyStr><![CDATA[6901481811083]]></KeyStr>
 <Result><![CDATA[verify_ok]]></Result>
 <ReasonMsg><![CDATA[]]></ReasonMsg>
</xml>

推送参数说明

参数 说明
ToUserName 商户的公众号原始id。
FromUserName 扫一扫审核系统。
CreateTime 消息创建时间(整型)。
MsgType 消息类型,event。
Event 事件类型,user_scan_product_verify_action为审核结果事件。
KeyStandard 商品编码标准。
KeyStr 商品编码内容。
Result 审核结果。verify_ok表示审核通过,verify_not_pass表示审核未通过。
ReasonMsg 审核未通过的原因。

相关视频

更多

免费

php8,我来也
初级php8,我来也

34万次学习

收藏

免费

Thinkphp6.0正式版视频教程
中级Thinkphp6.0正式版视频教程

39.6万次学习

收藏

免费

细说PHP第一季
中级细说PHP第一季

31万次学习

收藏

精品课程

更多
前端入门_HTML5
前端入门_HTML5

共29课时

64.9万人学习

CSS视频教程-玉女心经版
CSS视频教程-玉女心经版

共25课时

41.2万人学习

JavaScript极速入门_玉女心经系列
JavaScript极速入门_玉女心经系列

共43课时

76.6万人学习

独孤九贱(1)_HTML5视频教程
独孤九贱(1)_HTML5视频教程

共25课时

64.1万人学习

独孤九贱(2)_CSS视频教程
独孤九贱(2)_CSS视频教程

共22课时

24.3万人学习

独孤九贱(3)_JavaScript视频教程
独孤九贱(3)_JavaScript视频教程

共28课时

36.2万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时

133.1万人学习

热门下载

更多
phpStudy 2018最新版
phpStudy 2018最新版

集成PHP7,16种组合,超全大合集

下载

VC9 32位
VC9 32位

VC9 32位 phpstudy集成安装环境运行库

下载

VC11 32位
VC11 32位

VC11 32位 phpstudy集成安装环境运行库​

下载

php程序员工具箱完整版
php程序员工具箱完整版

程序员工具箱 v1.0 php集成环境

下载

VC14 32位
VC14 32位

VC14 32位 phpstudy安装环境运行库

下载

SublimeText3汉化版
SublimeText3汉化版

中文版,非常好用

下载

Notepad++ Windows版
Notepad++ Windows版

Notepad++ 8.9.7 Windows版官方安装包,适合 Windows 用户进行代码编辑、文本处理、语法高亮和插件扩展配置。

下载