微信掃一掃事件推送

2021-09-26 14:20 更新

掃一掃事件推送

目錄

1 事件推送

1.1 打開商品主頁事件推送

1.2 關(guān)注公眾號事件推送

1.3 進(jìn)入公眾號事件推送

1.4 地理位置信息異步推送

1.5 商品審核結(jié)果推送

微信掃一掃


事件推送

用戶打開商品主頁,用戶從商品主頁關(guān)注或進(jìn)入公眾號等情況下均會觸發(fā)事件推送。該事件將推送至商戶填寫的URL(登錄微信公眾平臺=>開發(fā)者中心設(shè)置)。 開發(fā)者可通過事件推送完成數(shù)據(jù)統(tǒng)計、用戶身份識別等操作,實(shí)現(xiàn)更加精準(zhǔn)的運(yùn)營。


微信服務(wù)器在五秒內(nèi)收不到響應(yīng)會斷掉連接,并且重新發(fā)起請求,總共重試三次。關(guān)于重試的消息排重,推薦使用FromUserName + CreateTime 排重。假如服務(wù)器無法保證在五秒內(nèi)處理并回復(fù),可以直接回復(fù)空串,微信服務(wù)器不會對此作任何處理,并且不會發(fā)起重試。

打開商品主頁事件推送

當(dāng)用戶打開商品主頁,無論是通過掃碼,還是從其他場景(會話、收藏或朋友圈)打開,微信均會推送該事件到商戶填寫的URL。推送的內(nèi)容包括用戶基本信息,以及商品主頁對應(yīng)的碼信息。

推送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>

推送參數(shù)說明

參數(shù)說明
ToUserName商戶的公眾號原始id。
FromUserName用戶的openid。
CreateTime消息創(chuàng)建時間(整型)。
MsgType消息類型,event。
Event事件類型,user_scan_product為打開商品主頁事件。
KeyStandard商品編碼標(biāo)準(zhǔn)。
KeyStr商品編碼內(nèi)容。
Country用戶在微信內(nèi)設(shè)置的國家。
Province用戶在微信內(nèi)設(shè)置的省份。
City用戶在微信內(nèi)設(shè)置的城市 。
Sex用戶的性別,1為男性,2為女性,0代表未知。
Scene打開商品主頁的場景,1為掃碼,2為其他打開場景(如會話、收藏或朋友圈)。
ExtInfo調(diào)用“獲取商品二維碼接口”時傳入的extinfo,為標(biāo)識參數(shù)。

關(guān)注公眾號事件推送

當(dāng)用戶在商品主頁中關(guān)注公眾號,微信會推送該事件到商戶填寫的URL。推送的內(nèi)容包括關(guān)注用戶的基本信息、時間、關(guān)注場景及對應(yīng)的碼信息。

推送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>

推送參數(shù)說明

參數(shù)說明
ToUserName商戶的公眾號原始id。
FromUserName用戶的openid。
CreateTime消息創(chuàng)建時間(整型)。
MsgType消息類型,event。
Event事件類型,subscribe為關(guān)注公眾號事件。
EventKey”分割。①scene表示場景:scanbarcode為掃碼場景,scanimage為掃封面(圖像)場景。②keystandard表示商品編碼標(biāo)準(zhǔn):barcode為條碼。③keystr表示商品編碼內(nèi)容。④extinfo表示調(diào)用“獲取商品二維碼接口”時傳入的extinfo,為標(biāo)識參數(shù)。

進(jìn)入公眾號事件推送

當(dāng)用戶從商品主頁進(jìn)入公眾號會話時,微信會推送該事件到商戶填寫的URL。推送的內(nèi)容包括用戶的基本信息、時間、關(guān)注場景及對應(yīng)的條碼信息。

推送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>

推送參數(shù)說明

參數(shù)說明
ToUserName商戶的公眾號原始id。
FromUserName用戶的openid。
CreateTime消息創(chuàng)建時間(整型)。
MsgType消息類型,event。
Event事件類型,user_scan_product_enter_session為進(jìn)入公眾號事件。
KeyStandard商品編碼標(biāo)準(zhǔn)。
KeyStr商品編碼內(nèi)容。
ExtInfo調(diào)用“獲取商品二維碼接口”時傳入的extinfo,為標(biāo)識參數(shù)。

地理位置信息異步推送

當(dāng)用戶打開商品主頁,微信會將該用戶實(shí)時的地理位置信息以異步事件的形式推送到商戶填寫的URL。商戶可利用該信息做數(shù)據(jù)分析,形成差異化運(yùn)營方案或指導(dǎo)生產(chǎn)。

推送的地理位置信息為“省”一級,如廣東省。由于用戶的網(wǎng)速影響,異步推送的響應(yīng)速度可能較慢。


推送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>

推送參數(shù)說明

參數(shù)說明
ToUserName商戶的公眾號原始id。
FromUserName用戶的openid。
CreateTime消息創(chuàng)建時間(整型)。
MsgType消息類型,event。
Event事件類型,user_scan_product_async為異步事件。
KeyStandard商品編碼標(biāo)準(zhǔn)。
KeyStr商品編碼內(nèi)容。
ExtInfo調(diào)用“獲取商品二維碼接口”時傳入的extinfo,為標(biāo)識參數(shù)。
RegionCode用戶的實(shí)時地理位置信息(目前只精確到省一級),可在國家統(tǒng)計局網(wǎng)站查到對應(yīng)明細(xì):http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/201504/t20150415_712722.html

商品審核結(jié)果推送

提交審核的商品,完成審核后,微信會將審核結(jié)果以事件的形式推送到商戶填寫的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>

推送參數(shù)說明

參數(shù)說明
ToUserName商戶的公眾號原始id。
FromUserName掃一掃審核系統(tǒng)。
CreateTime消息創(chuàng)建時間(整型)。
MsgType消息類型,event。
Event事件類型,user_scan_product_verify_action為審核結(jié)果事件。
KeyStandard商品編碼標(biāo)準(zhǔn)。
KeyStr商品編碼內(nèi)容。
Result審核結(jié)果。verify_ok表示審核通過,verify_not_pass表示審核未通過。
ReasonMsg審核未通過的原因。


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號