壹、場景二維碼
為了滿足用戶渠道推廣分析的需要,公眾平臺提供了生成帶參數二維碼的接口。使用該接口可以獲得多個帶不同場景值的二維碼,用戶掃描後,公眾號可以接收到事件推送。
目前有2種類型的二維碼,分別是臨時二維碼和永久二維碼,前者有過期時間,最大為1800秒,但能夠生成較多數量,後者無過期時間,數量較少(目前參數只支持1--100000)。兩種二維碼分別適用於帳號綁定、用戶來源統計等場景。
用戶掃描帶場景值二維碼時,可能推送以下兩種事件:
如果用戶還未關註公眾號,則用戶可以關註公眾號,關註後微信會將帶場景值關註事件推送給開發者。
如果用戶已經關註公眾號,在用戶掃描後會自動進入會話,微信也會將帶場景值掃描事件推送給開發者。
獲取帶參數的二維碼的過程包括兩步,首先創建二維碼ticket,然後憑借ticket到指定URL換取二維碼。
二、創建二維碼ticket
每次創建二維碼ticket需要提供壹個開發者自行設定的參數(scene_id),分別介紹臨時二維碼和永久二維碼的創建二維碼ticket過程。
臨時二維碼請求說明
/cgi-bin/qrcode/create?access_token=TOKEN
POST數據格式
1 {
2 "expire_seconds": 1800,
3 "action_name": "QR_SCENE",
4 "action_info": {
5 "scene": {
6 "scene_id": 100000
7 }
8 }
9 }
返回格式:
{
"ticket": "gQFK8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL3kweXE0T3JscWY3UTltc3ZPMklvAAIEG9jUUgMECAcAAA==",
"expire_seconds": 1800
}
永久二維碼請求說明
/cgi-bin/qrcode/create?access_token=TOKEN
POST數據格式
{
"action_name": "QR_LIMIT_SCENE",
"action_info": {
"scene": {
"scene_id": 1000
}
}
}
返回格式
{
"ticket": "gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA=="
}
提交數據參數說明:
返回結果參數說明
程序實現
三、通過ticket換取二維碼
獲取二維碼ticket後,開發者可用ticket換取二維碼圖片。無須登錄態即可調用。
HTTPS GET請求說明(TICKET必需UrlEncode)
/cgi-bin/showqrcode?ticket=TICKET
ticket正確情況下,/cgi-bin/showqrcode?ticket=gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA%3D%3D",
3 "content_type": "image/jpg",
4 "http_code": 200,
5 "header_size": 162,
6 "request_size": 181,
7 "filetime": -1,
8 "ssl_verify_result": 20,
9 "redirect_count": 0,
10 "total_time": 0.509,
11 "namelookup_time": 0,
12 "connect_time": 0.058,
13 "pretransfer_time": 0.343,
14 "size_upload": 0,
15 "size_download": 28497,
16 "speed_download": 55986,
17 "speed_upload": 0,
18 "download_content_length": 28497,
19 "upload_content_length": 0,
20 "starttransfer_time": 0.481,
21 "redirect_time": 0
22 }
四、掃描帶參數二維碼事件
用戶掃描帶場景值二維碼時,可能推送以下兩種事件:
如果用戶還未關註公眾號,則用戶可以關註公眾號,關註後微信會將帶場景值關註事件推送給開發者。
如果用戶已經關註公眾號,則微信會將帶場景值掃描事件推送給開發者。
1. 用戶未關註時,進行關註後的事件推送
<xml>
<ToUserName><![CDATA[gh_45072270791c]]></ToUserName>
<FromUserName><![CDATA[o7Lp5t6n59DeX3U0C7Kric9qEx-Q]]></FromUserName>
<CreateTime>1389684286</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[subscribe]]></Event>
<EventKey><![CDATA[qrscene_1000]]></EventKey>
<Ticket><![CDATA[gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA==]]></Ticket>
</xml>
參數說明
2. 用戶已關註時的事件推送
<xml>
<ToUserName><![CDATA[gh_45072270791c]]></ToUserName>
<FromUserName><![CDATA[o7Lp5t6n59DeX3U0C7Kric9qEx-Q]]></FromUserName>
<CreateTime>1389684184</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[SCAN]]></Event>
<EventKey><![CDATA[1000]]></EventKey>
<Ticket><![CDATA[gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA==]]></Ticket>
</xml>
參數說明
事件代碼:
以下代碼判定了掃描帶參數二維碼的兩種情形
private function receiveEvent($object)
{
$contentStr = "";
switch ($object->Event)
{
case "subscribe":
$contentStr = "歡迎關註方倍工作室 ";
if (isset($object->EventKey)){
$contentStr = "關註二維碼場景 ".$object->EventKey;
}
break;
case "SCAN":
$contentStr = "掃描 ".$object->EventKey;
//要實現統計分析,則需要掃描事件寫入數據庫,這裏可以記錄 EventKey及用戶OpenID,掃描時間
break;
default:
break;
}
$resultStr = $this->transmitText($object, $contentStr);
return $resultStr;
}
如果您不懂微信第三方開發,還是找人做吧