개인화된 메뉴 인터페이스
개인화된 메뉴 인터페이스
공개 계정의 유연한 비즈니스 운영을 돕기 위해 WeChat 공개 플랫폼에는 개인화된 메뉴 인터페이스가 추가되었습니다. 개발자는 이 인터페이스를 사용하여 공개 계정의 다양한 사용자 그룹이 다양한 보기를 볼 수 있도록 할 수 있습니다. . 이 인터페이스는 인증된 구독 계정 및 인증된 서비스 계정에 열려 있습니다.
개발자는 다음 조건을 통해 사용자에게 보이는 메뉴를 설정할 수 있습니다.
1、用户标签(开发者的业务需求可以借助用户标签来完成) 2、性别 3、手机操作系统 4、地区(用户在微信客户端设置的地区) 5、语言(用户在微信客户端设置的语言)
개인 메뉴 인터페이스 설명:
1、个性化菜单要求用户的微信客户端版本在iPhone6.2.2,Android 6.2.4以上,暂时不支持其他版本微信 2、菜单的刷新策略是,在用户进入公众号会话页或公众号profile页时,如果发现上一次拉取菜单的请求在5分钟以前,就会拉取一下菜单,如果菜单有更新,就会刷新客户端的菜单。测试时可以尝试取消关注公众账号后再次关注,则可以看到创建后的效果 3、普通公众号的个性化菜单的新增接口每日限制次数为2000次,删除接口也是2000次,测试个性化菜单匹配结果接口为20000次 4、出于安全考虑,一个公众号的所有个性化菜单,最多只能设置为跳转到3个域名下的链接 5、创建个性化菜单之前必须先创建默认菜单(默认菜单是指使用普通自定义菜单创建接口创建的菜单)。如果删除默认菜单,个性化菜单也会全部删除 6、个性化菜单接口支持用户标签,请开发者注意,当用户身上的标签超过1个时,以最后打上的标签为匹配
개인 메뉴 일치 규칙 설명:
个性化菜单的更新是会被覆盖的。 例如公众号先后发布了默认菜单,个性化菜单1,个性化菜单2,个性化菜单3。那么当用户进入公众号页面时,将从个性化菜单3开始匹配,如果个性化菜单3匹配成功,则直接返回个性化菜单3,否则继续尝试匹配个性化菜单2,直到成功匹配到一个菜单。 根据上述匹配规则,为了避免菜单生效时间的混淆,决定不予提供个性化菜单编辑API,开发者需要更新菜单时,需将完整配置重新发布一轮。
개인 메뉴 만들기
http 요청 방법: POST (https 프로토콜을 사용해주세요)
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":{ "tag_id":"2", "sex":"1", "country":"中国", "province":"广东", "city":"广州", "client_platform_type":"2", "language":"zh_CN" } }
매개변수 설명
매개변수 | 가 필수인가요? | 설명 |
---|---|---|
button | 은 | 1단계 메뉴 배열이며 숫자는 1~3이어야 합니다. |
sub_button | 아니요 | 보조 메뉴 배열, 숫자는 1~5여야 합니다. |
type | 은 | 메뉴의 응답 작업 유형입니다. |
name | 은 메뉴의 | 제목이며, 16바이트를 초과할 수 없습니다. 하위 메뉴 섹션의 경우 40자 이상 |
key | 클릭 및 기타 클릭 유형은 | menu 메시지 인터페이스 푸시에 사용되는 KEY 값, 128바이트 이하여야 합니다. |
url | 보기 유형은 | 웹 링크인 경우 사용자는 메뉴를 클릭하여 링크를 열 수 있습니다. 최대 1024바이트입니다. |
media_id | media_id 유형 및 view_limited 유형은 | 법적 media_id |
matchrule | 을 반환하기 위해 새로운 영구 머티리얼 인터페이스를 호출해야 합니다.는 | 메뉴 일치 규칙 |
tag _id | No | 사용자 태그의 ID는 사용자 태그 관리 인터페이스를 통해 얻을 수 있습니다 |
sex | No | 성별: 남 (1) 여 (2), 작성하지 않으면 매칭이 이루어지지 않습니다 |
client_platform_type | No | 클라이언트 버전, 현재 특정 시스템 모델만 해당: IOS(1), Android(2),Others(3), 그렇지 않은 경우 입력하면 매칭이 되지 않습니다 |
country | No | 국가 정보는 그렇습니다. 자세한 내용은 지역 정보 표를 참조하세요. |
언어 | No | 언어 정보는 사용자가 WeChat에서 설정한 언어입니다. 자세한 내용은 언어 표를 참조하세요. 1. 중국어 간체 "zh_CN" 2. 중국어 번체 TW "zh_TW" 3. 중국어 번체 홍콩 "zh_HK" 4. 영어 "en" 5. 인도네시아어 "id" 6. 말레이어 "ms" 7. 스페인어 "es" 8. 한국어 "ko" 9. 이탈리아어 "it" 10. 일본어 "ja" 11. 폴란드어 " pl" 12 , 포르투갈어 "pt" 13, 러시아어 "ru" 14, 태국어 "th" 15, 베트남어 "vi" 16, 아랍어 "ar" 17, 북인도 "hi" 18, 히브리어 "he" 19, 터키어 "tr " 20. 독일어 "de" 21. 프랑스어 "fr" |
Matchrule에는 총 6개의 필드가 있으며 모두 비어 있을 수 있지만, 일치하는 정보 중 하나 이상이 비어 있지 않아야 합니다. 국가, 도, 시로 구성된 지역정보는 국가, 도, 시 순으로 확인되며, 지역정보표의 내용을 준수하여야 한다. 지역정보는 큰 것부터 작은 것까지 확인하며, 작은 것은 기재할 필요가 없다. 즉, 지방정보를 기재하면 국가정보도 기재하여야 하며, 도시정보는 일치하지 않아도 된다. 채워지다. 예를 들어 "Guangzhou City, Guangdong Province, China", "Guangdong Province, China"는 모두 합법적인 지리정보이지만, "Guangzhou City, China"는 도시 정보는 입력했지만 성 정보는 입력하지 않았기 때문에 불법입니다. 지역 정보 표를 보려면 클릭하여 다운로드하세요.
반환 결과
올바른 경우 반환되는 JSON 데이터 패킷은 다음과 같습니다. 잘못된 경우의 반환 코드는 인터페이스 반환 코드 설명을 참조하세요.
{ "menuid":"208379533" }
맞춤 메뉴 삭제
http 요청 방법: POST(https 프로토콜을 사용하세요.)
https://api.weixin.qq.com/cgi-bin/menu/delconditional?access_token=ACCESS_TOKEN
요청 예
{ "menuid":"208379533" }
menuid는 메뉴 ID이며 맞춤 메뉴 쿼리 인터페이스를 통해 얻을 수 있습니다.
올바른 경우 반환되는 JSON 데이터 패킷은 다음과 같습니다. 잘못된 경우의 반환 코드는 인터페이스 반환 코드 설명을 참조하세요. :
{"errcode":0,"errmsg":"ok"}
맞춤 메뉴 매칭 결과 테스트
http 요청 방법: POST(https 프로토콜을 사용해 주세요)
https://api.weixin.qq.com/cgi-bin/menu/trymatch?access_token=ACCESS_TOKEN
요청 예시
{ "user_id":"weixin" }
user_id는 팬의 OpenID 또는 팬의 WeChat ID일 수 있습니다.
반환 결과 이 인터페이스는 메뉴 구성을 반환합니다. 예는 다음과 같습니다.
{ "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": [ ] } ] }
오류 발생 시 반환 코드는 인터페이스 반환 코드 설명을 참조하세요.
맞춤 메뉴 쿼리
기본 메뉴 및 모든 맞춤 메뉴 정보를 얻으려면 일반 맞춤 메뉴 쿼리 인터페이스를 사용하세요. 맞춤 메뉴 쿼리 인터페이스에 대한 설명을 참조하세요.
모든 메뉴 삭제
모든 맞춤 메뉴(기본 메뉴 및 모든 개인 메뉴 포함)를 삭제하려면 일반 맞춤 메뉴 삭제 인터페이스를 사용하세요. 맞춤 메뉴 삭제 인터페이스 설명을 참조하세요.