个性化
运行机制
通过个性化您可以指定商品目录的显示条件并仅对某些授权用户应用促销活动。
它可以让您：
- 向特定用户提供最相关的商品展示和促销活动
- 激励用户完成首次游戏内购买
有以下几种个性化类型：
- 艾克索拉侧的个性化。个性化规则和逻辑在艾克索拉侧配置和存储。合作伙伴向艾克索拉发送用户属性，然后艾克索拉根据所配置的逻辑创建目录。
- 合作伙伴侧的个性化。个性化规则和逻辑由合作伙伴配置和存储并将给指定用户的目录发送给艾克索拉。
设置个性化可用于任意身份认证类型：通过用户ID或艾克索拉登录管理器。
艾克索拉侧的个性化
用户流程
- 未授权用户访问商品目录。根据向未授权用户显示商品开关的设置，用户可以看到：
- 未应用个性化规则的商品
- 所有商品，包括已应用个性化规则的商品
- 用户单击登录并通过艾克索拉登录管理器或用户ID完成授权。
- 艾克索拉通过艾克索拉登录管理器或Webhook请求用户属性。
- 艾克索拉根据在艾克索拉侧设置的商品可用性和促销活动规则以及步骤3中获取的用户属性来显示个性化目录。
- 用户查看个性化目录，然后点击立即购买。
- 购买时，艾克索拉再次请求用户的属性并对照个性化规则进行检查：
- 如果商品不再可购买，则用户收到一条无法购买该商品的通知。
- 如果商品可以购买，则用户前往支付步骤。
设置个性化商品目录
- 设置用户属性。
- 启用个性化功能。
- 设置目录显示规则。您可以在启用个性化功能时进行设置，也可以在发布商帐户项目的商店 > 目录管理 > 目录显示规则部分进行设置。
- 在发布商帐户中打开您的项目，前往商店 > 个性化部分。
- 如果尚未配置个性化功能，请单击设置个性化。
- 选择艾克索拉侧个性化类型。
- 单击下一步。
- 创建目录显示规则：
- 如果尚未创建目录显示规则，将自动打开创建规则窗口。
- 如果已创建目录显示规则，在目录显示规则部分，单击创建规则。
- 指定规则名称并定义在目录中显示商品的条件。
关于目录显示规则的更多信息
通过目录显示规则可根据用户属性自定义目录的显示。
一条规则可包含以下类型的商品，数量不限：
- 物品
- 捆绑包
- 货币套餐
- 游戏密钥
您可以在一条规则中使用同一个用户属性创建不同的条件。
可对同一商品应用多条规则。如一个商品没有应用任何规则，则对所有用户可用。
- 要让未授权用户也能看到应用了规则的商品，请将向未登录用户显示相关商品开关设置为开。
- 单击下一步。
- 选择要应用规则的商品。
- 单击下一步。
- 检查设置。如有需要，单击编辑按钮进行更改。
- 单击保存并退出。
要编辑或删除规则，请前往目录显示规则页面，在规则行中单击•••图标，然后选择所需的菜单选项。要启用或禁用规则，请更改其状态。
设置属性
在登录管理器项目中设置用户属性并确保属性值为最新：用户在游戏中的属性发生变化时更新艾克索拉中的属性值。
属性更新的顺序取决于网页商城中使用的用户授权方案。
用户登录网页商城时，艾克索拉发送一个网页商城中的用户验证Webhook。
响应Webhook时，需提供用户属性的当前值。每次用户登录时，这些属性都会更新。
如需额外更新属性，请使用以下Login API调用实现服务器令牌检索和属性更新：
设置个性化促销活动
您可以设置个性化促销活动，例如给在游戏中达到某个等级的玩家购买虚拟物品的折扣。
您可以设置一个或更多条件。请注意，促销活动一旦激活，将无法更改。关于促销活动类型和设置的更多信息，请参阅设置促销活动。
要设置个性化促销活动：
- 在登录管理器产品中设置用户属性。
- 设置奖励促销活动或折扣促销活动。将仅对特定用户触发促销活动开关切换为开并指定条件。
合作伙伴侧的个性化
如果您在己侧实现了高级个性化逻辑，且不想在艾克索拉侧设置规则或指定属性，请选择此类型。
- 在艾克索拉侧创建商品目录并与您的目录同步。您系统中的每个商品都必须在艾克索拉中有对应的item_id或sku。
- 在发布商帐户中启用个性化功能。
- 设置合作伙伴侧目录个性化Webhook的处理。
用户流程
- 未授权用户访问商品目录。根据向未授权用户显示相关商品开关的设置，用户可以看到：
- 目录中的所有商品
- 您在对合作伙伴侧目录个性化Webhook的响应中返回的商品
- 向用户显示商品的顺序取决于通过Webhook响应获取sku顺序开关的设置。
- 用户单击登录并完成授权。
- 艾克索拉发送Webhook请求用户ID对应的商品。
- 合作伙伴侧响应返回对该用户可售的商品SKU列表。
- 用户从个性化目录中选择商品并单击立即购买。
- 在艾克索拉侧，购买时执行此流程中的步骤3和4以检查商品的可用性：
- 如果商品不再可购买，则用户收到一条无法购买该商品的消息。
- 如果商品可以购买，则用户前往支付步骤。
设置自定义商品目录
要启用个性化功能：- 在发布商帐户中打开您的项目，前往商店 > 个性化部分。
- 如果尚未配置个性化功能，请单击设置个性化。
- 选择合作伙伴侧个性化类型。
- 单击下一步。
- 设置商品显示。为此，请启用相应的开关：
- 向未登录用户显示相关商品 — 向未授权用户显示在合作伙伴侧目录个性化Webhook的响应中返回的商品。如果开关未启用，未授权用户将看到目录中的所有商品。
- 通过Webhook响应获取SKU顺序 — 设置为启用可按照您在对合作伙伴侧目录个性化Webhook的响应中传递的顺序向用户显示商品。如果开关未启用，则按照艾克索拉侧设置的顺序向用户显示商品。要在艾克索拉侧设置或获取商品显示顺序，请使用虚拟物品和货币组中管理子部分的order参数。
- 单击保存更改。
设置Webhook处理
当用户与商品目录交互时，艾克索拉会向Webhook URL发送一个合作伙伴侧的目录个性化Webhook，其中包含用户和项目参数。 设置Webhook处理：- 在发布商帐户的项目中，前往项目设置 > Webhooks，输入接收Webhook的URL。如果已经设置Webhook，可以跳过此步骤。
- 您需要在响应中返回对用户可售的商品SKU列表。在此过程中，您还可以包含用户购买特定商品的限制信息，如购买次数限制或有效期限制。通过此功能，您可以控制用户可见的商品数量和类型。
如果商品设置中包含商店显示期限或可购买数量的限制，请注意这些设置与Webhook参数之间的优先级关系。
- 商品设置中的购买限制优先于Webhook响应中的quantity参数。
- 例外情况：
- 如果根据设置商品对用户可售，但Webhook响应中包含
"quantity": 0，则用户无法购买该商品。- Webhook响应中通过date_from和date_untill参数定义的显示期限优先于商品设置中配置的显示期限。
每个向艾克索拉索取目录的请求将生成一个从艾克索拉向游戏服务器发送的新请求。艾克索拉使用数据缓存来减少向游戏服务器发送的请求数并缓存有效期过期后发送partner_side_catalog Webhook。
如果缓存尚未完成，partner_side_catalog Webhook将随每个发送给艾克索拉的请求发送，例如，艾克索拉同时收到多个目录请求而服务器响应有延迟的情况下。
更改个性化类型
在网页商城中设置
要在网页商城中显示配置了个性化的商品：
- 在发布商帐户中打开您的项目，前往建站器部分。
- 在您的网页商城网站的窗格中，单击打开建站器。
- 在商店区块中，前往商店部分。
- 在商品类型和商品组字段中，选择配置了个性化的商品。
- 要应用更改，请发布您的网站。
发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
