1、用戶分組(開發(fā)者的業(yè)務(wù)需求可以借助用戶分組來完成)
2、性別
3、手機(jī)操作系統(tǒng)
4、地區(qū)
個(gè)性化菜單接口說明:
1、個(gè)性化菜單要求用戶的微信客戶端版本在iPhone6.2.2,Android 6.2.4以上。
2、菜單的刷新策略是,在用戶進(jìn)入公眾號會(huì)話頁或公眾號profile頁時(shí),如果發(fā)現(xiàn)上一次拉取菜單的請求在5分鐘以前,就會(huì)拉取一下菜單,如果菜單有更新,就會(huì)刷新客戶端的菜單。測試時(shí)可以嘗試取消關(guān)注公眾賬號后再次關(guān)注,則可以看到創(chuàng)建后的效果。
3、普通公眾號的個(gè)性化菜單的新增接口每日限制次數(shù)為2000次,刪除接口也是2000次,測試個(gè)性化菜單匹配結(jié)果接口為20000次
4、出于安全考慮,一個(gè)公眾號的所有個(gè)性化菜單,最多只能設(shè)置為跳轉(zhuǎn)到3個(gè)域名下的鏈接
5、創(chuàng)建個(gè)性化菜單之前必須先創(chuàng)建默認(rèn)菜單(默認(rèn)菜單是指使用普通自定義菜單創(chuàng)建接口創(chuàng)建的菜單)。如果刪除默認(rèn)菜單,個(gè)性化菜單也會(huì)全部刪除
個(gè)性化菜單匹配規(guī)則說明:
當(dāng)公眾號創(chuàng)建多個(gè)個(gè)性化菜單時(shí),將按照發(fā)布順序,由新到舊逐一匹配,直到用戶信息與matchrule相符合。如果全部個(gè)性化菜單都沒有匹配成功,則返回默認(rèn)菜單。
例如公眾號先后發(fā)布了默認(rèn)菜單,個(gè)性化菜單1,個(gè)性化菜單2,個(gè)性化菜單3。那么當(dāng)用戶進(jìn)入公眾號頁面時(shí),將從個(gè)性化菜單3開始匹配,如果個(gè)性化菜單3匹配成功,則直接返回個(gè)性化菜單3,否則繼續(xù)嘗試匹配個(gè)性化菜單2,直到成功匹配到一個(gè)菜單。
目錄
1 創(chuàng)建個(gè)性化菜單
2 刪除個(gè)性化菜單
3 測試個(gè)性化菜單匹配結(jié)果
4 查詢個(gè)性化菜單
5 刪除個(gè)性化菜單
創(chuàng)建個(gè)性化菜單
http請求方式:POST(請使用https協(xié)議)
https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token=ACCESS_TOKEN
請求示例
{
"button":[
{
"type":"click",
"name":"今日歌曲",
"key":"V1001_TODAY_MUSIC"
},
{
"name":"菜單",
"sub_button":[
{
"type":"view",
"name":"搜索",
"url":"http://www.soso.com/"
},
{
"type":"view",
"name":"視頻",
"url":"http://v.qq.com/"
},
{
"type":"click",
"name":"贊一下我們",
"key":"V1001_GOOD"
}]
}],
"matchrule":{
"group_id":"2",
"sex":"1",
"country":"中國",
"province":"廣東",
"city":"廣州",
"client_platform_type":"2"
}
}
參數(shù)說明
參數(shù) 是否必須 說明
button 是 一級菜單數(shù)組,個(gè)數(shù)應(yīng)為1~3個(gè)
sub_button 否 二級菜單數(shù)組,個(gè)數(shù)應(yīng)為1~5個(gè)
type 是 菜單的響應(yīng)動(dòng)作類型
name 是 菜單標(biāo)題,不超過16個(gè)字節(jié),子菜單不超過40個(gè)字節(jié)
key click等點(diǎn)擊類型必須 菜單KEY值,用于消息接口推送,不超過128字節(jié)
url view類型必須 網(wǎng)頁鏈接,用戶點(diǎn)擊菜單可打開鏈接,不超過256字節(jié)
media_id media_id類型和view_limited類型必須 調(diào)用新增永久素材接口返回的合法media_id
matchrule 是 菜單匹配規(guī)則
group_id 否 用戶分組id,可通過用戶分組管理接口獲取
sex 否 性別:男(1)女(2),不填則不做匹配
client_platform_type 否 客戶端版本,當(dāng)前只具體到系統(tǒng)型號:IOS(1), Android(2),Others(3),不填則不做匹配
country 否 國家信息,是用戶在微信中設(shè)置的地區(qū),具體請參考地區(qū)信息表
province 否 省份信息,是用戶在微信中設(shè)置的地區(qū),具體請參考地區(qū)信息表
city 否 城市信息,是用戶在微信中設(shè)置的地區(qū),具體請參考地區(qū)信息表
matchrule共六個(gè)字段,均可為空,但不能全部為空,至少要有一個(gè)匹配信息是不為空的。 country、province、city組成地區(qū)信息,將按照country、province、city的順序進(jìn)行驗(yàn)證,要符合地區(qū)信息表的內(nèi)容。地區(qū)信息從大到小驗(yàn)證,小的可以不填,即若填寫了省份信息,則國家信息也必填并且匹配,城市信息可以不填。 例如 “中國 廣東省 廣州市”、“中國 廣東省”都是合法的地域信息,而“中國 廣州市”則不合法,因?yàn)樘顚懥顺鞘行畔⒌珱]有填寫省份信息。 地區(qū)信息表請點(diǎn)擊下載。
返回結(jié)果
正確時(shí)的返回JSON數(shù)據(jù)包如下,錯(cuò)誤時(shí)的返回碼請見接口返回碼說明。
{"errcode":0,"errmsg":"ok"}
刪除個(gè)性化菜單
http請求方式:POST(請使用https協(xié)議)
https://api.weixin.qq.com/cgi-bin/menu/delconditional?access_token=ACCESS_TOKEN
請求示例
{
"menuid":"208379533"
}
menuid為菜單id,可以通過自定義菜單查詢接口獲取。
正確時(shí)的返回JSON數(shù)據(jù)包如下,錯(cuò)誤時(shí)的返回碼請見接口返回碼說明。:
{"errcode":0,"errmsg":"ok"}
測試個(gè)性化菜單匹配結(jié)果
http請求方式:POST(請使用https協(xié)議)
https://api.weixin.qq.com/cgi-bin/menu/trymatch?access_token=ACCESS_TOKEN
請求示例
{
"user_id":"weixin"
}
user_id可以是粉絲的OpenID,也可以是粉絲的微信號。
返回結(jié)果 該接口將返回菜單配置,示例如下:
{
"button": [
{
"type": "view",
"name": "tx",
"url": "http://www.qq.com/",
"sub_button": [ ]
},
{
"type": "view",
"name": "tx",
"url": "http://www.qq.com/",
"sub_button": [ ]
},
{
"type": "view",
"name": "tx",
"url": "http://www.qq.com/",
"sub_button": [ ]
}
]
}
錯(cuò)誤時(shí)的返回碼請見接口返回碼說明。
查詢個(gè)性化菜單
使用普通自定義菜單查詢接口可以獲取默認(rèn)菜單和全部個(gè)性化菜單信息,請見自定義菜單查詢接口的說明。
刪除個(gè)性化菜單
使用普通自定義菜單刪除接口可以刪除所有自定義菜單(包括默認(rèn)菜單和全部個(gè)性化菜單),請見自定義菜單刪除接口的說明。
本文地址:http://quema.com.cn/artinfo/2416.html