公式アカウントが柔軟なビジネス運営を実現できるようにするために、WeChat 公式アカウント プラットフォームにはパーソナライズされたメニュー インターフェイスが追加されており、開発者はこれを通じて、公式アカウントのさまざまなユーザー グループがさまざまなカスタマイズされたメニューを表示できるようになります。このインターフェイスは、認証されたサブスクリプション アカウントと認証されたサービス アカウントに対して開かれています。
開発者は、次の条件に従ってユーザーに表示されるメニューを設定できます。
- ユーザー タグ (ユーザー タグを利用して開発者のビジネス ニーズを満たすことができます)
性別- モバイルオペレーティングシステム
地域 (WeChat クライアントでユーザーが設定した地域)言語 (WeChat クライアントでユーザーが設定した言語)
※個人のプライバシー保護のため、公式アカウントのパーソナライズメニューでは性別、地域、言語など個人のプライバシーデータに関わる情報のフィルタリング機能のサポートを終了させていただきます。具体的な調整内容は以下の通りです。
- 作成時に、一致条件に個人情報が含まれている限り、拒否され、エラー コード 65320 が返されます。
- 作成済みの場合、個人情報が含まれている場合は自動的に無効となり、含まれていない場合は正常に照合されます。
- 開発者は、通常どおりファンがテスト インターフェイスを通じて表示するメニューを取得できます。
- パーソナライズされたメニューをクエリすると、すべてのルールが通常どおり表示されます。
パーソナライズされたメニュー インターフェイスの説明:
- パーソナライズされたメニューを使用するには、ユーザーの WeChat クライアントのバージョンが iPhone6.2.2、Android 6.2.4 以降である必要があります。現時点では、他のバージョンの WeChat はサポートされていません。
- メニュー更新戦略は、ユーザーが公式アカウント セッション ページまたは公式アカウント プロフィール ページに入ったときに、メニューを取得するための最後のリクエストが 5 分前であることが判明した場合に、メニューが更新されると、メニューが取得されます。クライアントのサイド メニューが更新されます。テスト中に、公開アカウントのフォローを解除して再度フォローしてみると、作成後の効果を確認できます
- 一般公式アカウントのパーソナライズメニューの新規インターフェース回数は1日あたり2000回、削除インターフェースも2000回、パーソナライズメニューのマッチング結果テストインターフェースは20000回に制限されています
- セキュリティ上の理由から、公式アカウントのすべてのパーソナライズされたメニューは、最大 3 つのドメイン名のリンクにのみジャンプするように設定できます。
- パーソナライズされたメニューを作成する前に、まずデフォルト メニューを作成する必要があります (デフォルト メニューとは、共通のカスタム メニュー作成インターフェイスを使用して作成されたメニューを指します)。デフォルトメニューを削除すると、個人用メニューもすべて削除されます
- パーソナライズされたメニュー インターフェイスはユーザー タグをサポートしています。開発者は、ユーザーが複数のタグを持っている場合、最後のタグが一致として使用されることに注意してください。
パーソナライズされたメニューの一致ルールの説明:
パーソナライズされたメニューへの更新は上書きされます。例えば、公式アカウントではデフォルトメニュー、パーソナライズメニュー1、パーソナライズメニュー2、パーソナライズメニュー3が公開されています。その後、ユーザーが公式アカウントページに入ると、パーソナライズメニュー 3 からマッチングが開始されます。パーソナライズメニュー 3 のマッチングが成功した場合は、直接パーソナライズメニュー 3 に戻り、そうでない場合は、パーソナライズメニュー 2 のマッチングを試行し続けます。メニューは正常に一致しました。上記のマッチングルールに従い、メニューの有効時間に関する混乱を避けるため、パーソナライズされたメニュー編集 API を提供しないことが決定され、開発者がメニューを更新する必要がある場合、ラウンドの完全な構成を再公開する必要があります。 。
目次
3 パーソナライズされたメニューのマッチング結果をテストする
パーソナライズされたメニューを作成する
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": "miniprogram",
"name": "wxa",
"url": "http://mp.weixin.qq.com",
"appid": "wx286b93c14bbf93aa",
"pagepath": "pages/lunar/index"
},
{
"type": "click",
"name": "赞一下我们",
"key": "V1001_GOOD"
}
]
}
],
"matchrule": {
"tag_id": "2",
"sex": "1",
"country": "中国",
"province": "广东",
"city": "广州",
"client_platform_type": "2",
"language": "zh_CN"
}
}
パラメータの説明
パラメータ | それは必要ですか | 説明する |
---|---|---|
ボタン | はい | 第 1 レベルのメニュー配列。数値は 1 ~ 3 である必要があります。 |
サブボタン | いいえ | 二次メニュー配列。数値は 1 ~ 5 である必要があります。 |
タイプ | はい | メニューの応答アクション タイプ。ビューは Web ページ タイプを示し、クリックはクリック タイプを示し、ミニプログラムはアプレット タイプを示します。 |
名前 | はい | メニュータイトル、16バイト以内、サブメニュー40バイト以内 |
鍵 | クリックおよびその他のクリック タイプは次のとおりです。 | メニュー KEY 値、メッセージ インターフェイスのプッシュに使用、128 バイト以内 |
URL | ビューとミニプログラムのタイプは次のとおりです。 | Web ページのリンク。ユーザーがメニューをクリックしてリンクを開きます。1024 バイト以内です。タイプがミニプログラムの場合、ミニプログラムをサポートしていない古いバージョンのクライアントはこの URL を開きます |
メディアID | media_id タイプ |
新しい永続的なマテリアル インターフェイスによって返される正当な media_id を呼び出します。 |
記事ID | Article_id タイプとarticle_view_limitedタイプは必須です | 公開後に取得された法的記事 ID |
アプリケーション | ミニプログラムのタイプは次のとおりです。 | アプレットのアプリケーション |
ページパス | ミニプログラムのタイプは次のとおりです。 | アプレットのページパス |
マッチルール | はい | メニュー一致ルール |
タグID | いいえ | ユーザータグのID。ユーザータグ管理インターフェイスを通じて取得できます。 |
セックス | 廃止された | 性別: 男性 (1) 女性 (2)、空白のままだと一致しません |
client_platform_type | いいえ | クライアントのバージョン。現時点ではシステム モデルにのみ固有です: IOS(1)、Android(2)、Others(3)。入力されていない場合、一致は行われません。 |
国 | 廃止された | 国情報はWeChatでユーザーが設定した地域です。詳しくは地域情報表をご参照ください。 |
州 | 廃止された | 省情報はWeChatでユーザーが設定した地域です。詳細は地域情報表を参照してください。 |
街 | 廃止された | 都市情報はWeChat内でユーザーが設定した地域です。詳しくは地域情報表をご参照ください。 |
言語 | 廃止された | 言語情報は、WeChat でユーザーが設定した言語です。詳細については、言語テーブルを参照してください: 1. 簡体字中国語 "zh_CN" 2. 繁体字中国語 TW "zh_TW" 3. 繁体字中国語 HK "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 の代わりにmedia_id
使用してくださいarticle_id
。フィールドは合計 7 つあり、すべてを空にすることはできますが、すべてを空にすることはできません。少なくとも 1 つの一致情報は空であってはなりません。国、州、市はエリア情報を形成し、国、州、市の順に確認され、エリア情報テーブルの内容と一致する必要があります。地域情報は大きいものから小さいものまで検証され、小さいものは空白のままにすることができます。つまり、州の情報が入力されている場合は、国の情報も入力して照合する必要があり、都市の情報は空白のままにすることができます。たとえば、「中国広東省広州市」と「中国広東省」は合法な地理情報ですが、「中国広州市」は都市情報が入力されているものの、省情報が入力されていないため、合法ではありません。クリックして地域情報シートをダウンロードしてください。
結果を返す
正しい場合に返されるJSONデータパケットは以下の通りですが、間違っている場合のリターンコードはインターフェースのリターンコードの説明を参照してください。
{"menuid":"208379533"}
知らせ
パラメータ説明テーブルの廃止されたフィールドに注意してください。これらのフィールドは国民の個人的なプライバシーに関係します。これらのフィールドが入力されると、インターフェイスは次の結果を返します:
{"errcode":65320,"errmsg":"match rule violates privacy"}
他のリターン コードについては、インターフェイスのリターン コードの説明を参照してください。
パーソナライズされたメニューを削除する
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 アカウントを指定できます。
戻り結果このインターフェイスはメニュー構成を返します。例は次のとおりです。
{
"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": [ ]
}
]
}
非推奨のフィールドを含むメニューも自動的に無効になり、照合されなくなることに注意してください。この点は、このテストインターフェイスにも反映されます。
また、エラー発生時のリターンコードについては、インターフェースのリターンコードの説明を参照してください。
パーソナライズされたメニューのクエリ
デフォルト メニューとすべてのパーソナライズされたメニュー情報は、共通のカスタム メニュー クエリ インターフェイスを使用して取得できます。カスタム メニュー クエリ インターフェイスの説明を参照してください。
非推奨のフィールドを含むメニューは、クエリ時に通常どおり返されますが、有効ではなくなることに注意してください。
すべてのメニューを削除する
すべてのカスタム メニュー (デフォルト メニューとすべての個人設定メニューを含む) は、共通のカスタム メニュー削除インターフェイスを使用して削除できます。カスタム メニューの削除インターフェイスの説明を参照してください。