{"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":"追加销售是一种销售方式，用于在合适的购买节点向用户推荐可加购的优选商品。例如，推荐其他用户需求最高的商品。您还可以为追加销售商品配置区域限制。有关详细信息，请参阅[追加销售](/zh/liveops/promotion-tools/upsell/)部分。\n\n[获取项目中追加销售的信息](/zh/api/liveops/upsell-admin/get-upsell-configurations-for-project-admin)API方法会返回已配置为追加销售的商品列表，以及追加销售状态（已启用或已禁用）。在客户端侧，[获取项目中追加销售商品的列表](/zh/api/liveops/upsell-client/get-upsell-for-project-client)API方法会返回商品列表，您可以在购买流程中的合适节点向用户展示这些商品。\n\n追加销售配置场景：\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. 使用[创建追加销售](/zh/api/liveops/upsell-admin/post-upsell)API调用设置追加销售。在`items`数组中传入所需商品的SKU。\n3. 使用[激活/停用项目的追加销售](/zh/api/liveops/upsell-admin/put-upsell-toggle-active-inactive)API调用，为项目激活追加销售。\n4. 使用[获取项目中追加销售商品的列表](/zh/api/liveops/upsell-client/get-upsell-for-project-client)API调用，在购买流程中的合适节点向用户展示追加销售优惠。\n5. 实现支付UI的打开逻辑，以便用户支付订单。例如，可以使用[使用特定购物车中的所有商品创建订单](/zh/api/catalog/payment-client-side/create-order-by-cart-id)API调用。响应会返回用于打开支付UI的令牌。\n6. 配置订单状态跟踪，例如使用[Webhook](/zh/webhooks/overview)，以便及时接收支付成功商品的数据并向用户发放商品。\n\n![追加销售场景](https://cdn.xsolla.net/developers/current/images/api_docs/Upsell.svg)"},"itemId":"upsell-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"185.30.21.18"},"lang":"zh","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh/api/liveops/upsell-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}