如何按国家限制聊天机器人访问

有时你会希望 Shoply AI 聊天机器人仅在某些国家可用,或者你想阻止它在特定国家显示。本页面说明了如何使用高级设置来配置国家级访问控制。

在哪里找到高级设置?

前往应用管理控制台中的“Settings”部分,然后向下滚动到“Advanced Settings”部分。在此部分中,你可以提供一个 JSON 对象 来配置各种设置。

Settings → Advanced Settings is the editor used for the configuration below. The screenshot shows the demo store’s existing configuration; use the keys explained in this guide.
Settings → Advanced Settings is the editor used for the configuration below. The screenshot shows the demo store’s existing configuration; use the keys explained in this guide. Click the screenshot to view it at full size.

工作原理

Shoply 会根据访客的 IP 地址检测其所在国家。根据你的配置,来自被屏蔽国家的访客仍然可能会看到聊天机器人,但他们将无法与其交互。

有两种模式:

  • 白名单模式 — 仅允许来自你明确允许的国家/地区的访客进行交互。其他所有人都能看到聊天机器人,但无法使用它。
  • 黑名单模式 — 允许所有访客进行交互,但来自你明确屏蔽的国家/地区的访客除外。

如果这两项设置都未配置,则聊天机器人将对全球所有访客完全可用(默认行为)。

设置

这两项设置都在高级设置 JSON 中配置。

whitelisted_geos(白名单模式)

这是一个允许与聊天机器人交互的国家/地区列表。来自任何不在此列表中的国家/地区的访客都将看到聊天机器人,但无法使用它。

当你的商店服务于特定市场集合,并且你希望在其他所有地区限制交互时,请使用此设置。

格式: 每个条目都是一个对象,其中包含一个使用 ISO 3166-1 alpha-2  两位国家代码的 countryCode 字段。

示例 — 仅允许在美国和加拿大使用聊天机器人:

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

blocked_geos(黑名单模式)

这是一个其访客被禁止与聊天机器人交互的国家/地区列表。他们仍然可能会看到聊天机器人,但将无法使用它。来自任何不在此列表中的国家/地区的访客都可以正常交互。

当你希望广泛开放可用性,但需要限制特定国家/地区时,请使用此设置。

示例 — 屏蔽来自美国和加拿大的访客:

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

重要说明

国家限制用于控制访问;语言检测决定了可使用该功能的访客所体验到的语言。

  • 白名单优先。 如果设置了 whitelisted_geos,则 blocked_geos 会被完全忽略。
  • 一次只使用一种模式。 要么将你想要的国家/地区加入白名单,要么将你不想要的国家/地区加入黑名单——不要同时使用两者。
  • 国家代码不区分大小写("us" 和 "US" 都可用)。
  • 如果无法确定访客所在国家/地区,他们不会被屏蔽,并且可以正常交互。

常见国家代码

国家/地区代码
美国US
加拿大CA
英国GB
澳大利亚AU
德国DE
法国FR
日本JP
巴西BR
印度IN
墨西哥MX

如需查看完整的国家代码列表,请参阅 ISO 3166-1 alpha-2 参考 。