{"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":"促销活动是用于吸引新用户并提升销售额的营销工具。您可以使用艾克索拉API配置以下促销活动：\n\n* 折扣 — 为所选商品提供降价优惠。\n* 赠品 — 用户购买时随订单获得的商品。\n* 优惠券 — 用户兑换后可获得一个或多个赠品的代码。\n* 兑换码 — 用户可通过此类代码获得赠品、特定商品折扣或整个购物车折扣。优惠券会在用户输入后兑换；与之不同，兑换码会在购买过程中（结算时）兑换。\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)组的**管理**子部分中的调用创建商品。\n2. 使用[为商品创建折扣促销活动](/zh/api/liveops/promotions-discounts/create-item-promotion/)调用创建促销活动。在`items`数组中传入所需的商品SKU。\n3. 设置促销活动有效期。为此，请调用[为商品创建折扣促销活动](/zh/api/liveops/promotions-discounts/create-item-promotion/)或[更新商品促销活动](/zh/api/liveops/promotions-discounts/update-item-promotion/)方法，并将`promotion_periods`字段作为对象数组传入，其中`date_from`定义有效期开始日期，`date_until`定义有效期结束日期。\n4. 使用[更新商品促销活动](/zh/api/liveops/promotions-discounts/update-item-promotion/)调用激活促销活动。传入`\"is_enabled\": true`参数。\n5. 如需获取商品价格信息（包括折后价格），请调用[通用 > 商品目录](/zh/api/catalog/tag/common-catalog/)、[虚拟物品和货币 > 商品目录](/zh/api/catalog/virtual-items-currency-catalog/get-virtual-items/)和[捆绑包 > 商品目录](/zh/api/catalog/bundles-catalog/get-bundle-list/)子部分中用于获取商品目录的客户端API方法。\n\n![促销活动配置示例](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)\n\n关于配置促销活动的详细信息，请参阅我们的文档：\n* [折扣](https://developers.xsolla.com/zh/liveops/promotion-tools/discounts/)\n* [买赠](https://developers.xsolla.com/zh/liveops/promotion-tools/bonuses/)\n* [优惠券](https://developers.xsolla.com/zh/liveops/promotion-tools/coupons/)\n* [兑换码](https://developers.xsolla.com/zh/liveops/promotion-tools/promo-codes/)\n* [专属商品目录优惠](https://developers.xsolla.com/zh/liveops/promotion-tools/unique-offer/)"},"itemId":"promotions-overview","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/promotions-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}