{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/de/api/liveops/index.yaml","sidebar":"sidebar-@l10n/de/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/de/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/de/api/liveops","seo":{"title":"Overview","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Promotions are marketing tools designed to attract new users and increase sales. Using Xsolla API, you can configure the following promotions:\n\n* Discounts — reduced prices on selected items.\n* Bonuses — items granted to users along with their purchase.\n* Coupons — codes that allow users to receive one or more bonus items when redeeming.\n* Promo codes — codes that allow users to receive bonus items, a discount on a specific item, or a discount on the entire cart. Unlike coupons that are redeemed after the user enters them, promo codes are redeemed during a purchase (at checkout).\n* Unique offers — hidden items displayed in the catalog to users who have entered a unique offer code. If the code is not entered, the items are not displayed.\n\nExample flow for configuring a discount promotion:\n1. Create items using the calls from the **Admin** subsection of the [Virtual items and currency](/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [Bundles](/de/api/catalog/bundles-admin/admin-create-bundle), or [Game keys](/de/api/catalog/game-keys-admin) groups.\n2. Create a promotion using the [Create discount promotion for item](/de/api/liveops/promotions-discounts/create-item-promotion/) call. In the `items` array, pass the necessary item SKUs.\n3. Set up promotion validity periods. To do this, call the [Create discount promotion for item](/de/api/liveops/promotions-discounts/create-item-promotion/) or [Update item promotion](/de/api/liveops/promotions-discounts/update-item-promotion/) methods, and pass the `promotion_periods` field as an array of objects where `date_from` defines the start, and `date_until` defines the end date of the validity period.\n4. Activate a promotion using the [Update item promotion](/de/api/liveops/promotions-discounts/update-item-promotion/) call. Pass the `\"is_enabled\": true` parameter.\n5. To get information about item prices, including discounted prices, call the client API methods for getting an item catalog from the [Common > Catalog](/de/api/catalog/tag/common-catalog/), [Virtual Items and Currency > Catalog](/de/api/catalog/virtual-items-currency-catalog/get-virtual-items/), and [Bundles > Catalog](/de/api/catalog/bundles-catalog/get-bundle-list/) subsections.\n\n![Promotion configuration example](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)\n\nRefer to our documentation for detailed information about configuring promotions:\n* [Discounts](https://developers.xsolla.com/de/liveops/promotion-tools/discounts/)\n* [Bonuses](https://developers.xsolla.com/de/liveops/promotion-tools/bonuses/)\n* [Coupons](https://developers.xsolla.com/de/liveops/promotion-tools/coupons/)\n* [Promo codes](https://developers.xsolla.com/de/liveops/promotion-tools/promo-codes/)\n* [Unique catalog offers](https://developers.xsolla.com/de/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":"185.30.21.18"},"lang":"de","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/de/api/liveops/promotions-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}