{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/zh/api/liveops/index.yaml","sidebar":"sidebar-@l10n/zh/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/zh/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/zh/api/liveops","seo":{"title":"个性化商品目录","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"个性化功能允许您指定商品目录显示和促销活动应用的条件，使其仅面向特定授权用户生效。条件基于用户属性定义，可帮助您向特定用户提供最相关的商品和促销活动。\n\n支持以下个性化类型：\n\n* [艾克索拉侧个性化](/zh/liveops/promotion-tools/personalization/#guides_personalization_on_xsolla_side)。个性化规则和逻辑在艾克索拉侧配置并存储。您传入用户属性后，艾克索拉会使用这些属性生成个性化商品目录。\n* [合作伙伴侧个性化](/zh/liveops/promotion-tools/personalization/#guides_personalization_on_partner_side)。您在己侧配置个性化规则和逻辑，并将特定用户的最终商品目录数据载荷发送给艾克索拉。\n\n<div class=\"note\">\n  <b>注：</b><br><br>\n  您只能使用一种个性化类型。如需更改，请按照\n  <a href=\"/zh/liveops/promotion-tools/personalization/#guides_personalization_change\">说明</a>进行操作。\n</div>\n\n如需使用艾克索拉API在艾克索拉侧配置个性化：\n\n1. 使用[虚拟物品和货币](/zh/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/)、[捆绑包](/zh/api/catalog/bundles-admin/admin-create-bundle)或[游戏Key](/zh/api/catalog/game-keys-admin)组的**管理**子部分中的API调用创建商品。\n2. 使用[使用艾克索拉登录管理器API设置用户属性](/zh/liveops/promotion-tools/personalization/#web_shop_guide_personalization_setting_attributes)，并在您的游戏中发生变更时更新艾克索拉中的数据，确保数据保持同步。\n3. 为商品或促销活动配置个性化：\n    * 如需对商品目录进行个性化，请使用[创建商品目录筛选规则](/zh/api/liveops/personalized-catalog/create-filter-rule) API 调用定义商品目录显示规则：\n        * 在[attribute_conditions](/zh/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=attribute_conditions)数组中，指定根据用户属性确定商品可用性的条件。\n        * 在[items](/zh/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=items)数组中，提供在用户属性符合指定条件时应向用户显示的商品列表。\n    * 如需配置个性化促销活动，请使用[所需促销活动类型的创建和更新API调用]](/zh/api/liveops/promotions-discounts/create-item-promotion)。在[attribute_conditions](/zh/api/liveops/promotions-discounts/create-item-promotion)数组中，指定基于用户属性确定促销活动可用性的条件。\n\n4. 在[商品目录获取API调用](https://developers.xsolla.com/zh/api/catalog/virtual-items-currency-catalog/get-virtual-items)中传入包含用户属性的[用户JWT](/zh/api/login/getting-user-token?#getting-user-token)，以接收个性化商品目录。\n\n**为商品目录配置并应用艾克索拉侧个性化的流程：**\n\n![商品目录个性化](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-catalog.png)\n\n**为促销活动配置并应用艾克索拉侧个性化的流程：**\n\n![促销活动个性化](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-liveops.png)\n\n<div class=\"note\">\n<b>注：</b><br><br>\n详细信息请参阅：\n<ul>\n  <li><a href=\"/zh/liveops/promotion-tools/personalization/\">艾克索拉侧和合作伙伴侧个性化配置指南</a></li>\n  <li><a href=\"/zh/doc/shop-builder/tutorials/personalization-tutorial/\">艾克索拉侧商品目录个性化</a></li>\n</ul>\n</div>"},"itemId":"personalized-catalog","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.216.14"},"lang":"zh","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh/api/liveops/personalized-catalog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}