微信公众平台开发者文档 / 扫一扫事件推送

扫一扫事件推送

扫一扫事件推送

微信扫一扫


事件推送

用户打开商品主页,用户从商品主页关注或进入公众号等情况下均会触发事件推送。该事件将推送至商户填写的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审核未通过的原因。