掃一掃事件推播


掃一掃事件推送

微信扫一扫


事件推送

用戶開啟商品首頁,用戶從商品首頁追蹤或進入公眾號等情況都會觸發事件推送。此事件將推送至商家填寫的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審核未通過的原因。