国別にチャットボットを制限する（ジオブロッキング）

Shoply AI チャットボットを特定の国でのみ利用可能にしたい場合や、特定の国では表示されないようにしたい場合があります。このページでは、Advanced Settings を使って国レベルのアクセス制御を設定する方法を説明します。

Advanced Settings はどこにありますか？

アプリの管理コンソールの「Settings」セクションに移動し、下にスクロールして「Advanced Settings」セクションを見つけてください。このセクションでは、さまざまな設定を構成するために JSON オブジェクト  を指定できます。

仕組み

Shoply は訪問者の IP アドレスから国を判定します。設定内容に応じて、ブロック対象の国の訪問者にもチャットボット自体は表示される場合がありますが、操作することはできません。

モードは 2 つあります。

• ホワイトリストモード — 明示的に許可した国の訪問者にのみ操作を許可します。それ以外の訪問者にはチャットボットは表示されますが、使用できません。
• ブラックリストモード — 明示的にブロックした国を除く、すべての訪問者に操作を許可します。

どちらの設定も構成されていない場合、チャットボットは世界中のすべての訪問者に対して完全に利用可能です（デフォルト）。

設定

どちらの設定も Advanced Settings の JSON で構成します。

whitelisted_geos（ホワイトリストモード）

チャットボットとの対話を 許可 する国の一覧です。この一覧に 含まれない 国の訪問者にはチャットボットは表示されますが、使用することはできません。

これは、ストアが特定の市場のみを対象としており、それ以外の地域での利用を制限したい場合に使います。

形式: 各エントリは、ISO 3166-1 alpha-2  の 2 文字の国コードを使う countryCode フィールドを持つオブジェクトです。

例 — 米国とカナダでのみチャットボットを許可する場合:

{
  "whitelisted_geos": [
    { "countryCode": "US" },
    { "countryCode": "CA" }
  ]
}

blocked_geos（ブラックリストモード）

チャットボットとの対話が ブロック される国の一覧です。これらの訪問者にもチャットボット自体は表示される場合がありますが、使用することはできません。この一覧に 含まれない 国の訪問者は通常どおり対話できます。

これは、広く利用可能にしたい一方で、特定の国だけを制限する必要がある場合に使います。

例 — 米国とカナダからの訪問者をブロックする場合:

{
  "blocked_geos": [
    { "countryCode": "US" },
    { "countryCode": "CA" }
  ]
}

重要な注意事項

国による制限はアクセスを制御し、language detection は利用可能な訪問者に対して体験の言語を決定します。

• ホワイトリストが優先されます。 whitelisted_geos が設定されている場合、blocked_geos は完全に無視されます。
• 一度に使うモードは 1 つだけにしてください。 許可したい国をホワイトリストに入れるか、拒否したい国をブラックリストに入れるかのどちらかであり、両方を同時には使いません。
• 国コードは 大文字・小文字を区別しません（"us" と "US" はどちらも有効です）。
• 訪問者の国を判定できない場合、その訪問者は ブロックされず、通常どおり対話できます。

よく使われる国コード

国コードの完全な一覧については、ISO 3166-1 alpha-2 reference  を参照してください。