{"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":"Übersicht","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Werbeaktionen sind Marketinginstrumente, die darauf abzielen, neue Nutzer zu gewinnen und den Umsatz zu steigern. Mithilfe der Xsolla-API können Sie folgende Werbeaktionen einrichten:\n\n* Rabatte – reduzierte Preise auf ausgewählte Artikel.\n* Boni – Artikel, die Nutzer bei einem Kauf als Dreingabe erhalten.\n* Gutscheine – Codes, mit denen Nutzer einen oder mehrere Bonusartikel beim Einlösen erhalten.\n* Promocodes – Codes, mit denen Nutzer Bonusartikel, einen Rabatt auf einen bestimmten Artikel oder einen Rabatt auf den gesamten Warenkorb erhalten können. Im Gegensatz zu Gutscheinen, die erst nach Eingabe durch den Nutzer eingelöst werden, werden Promocodes während des Kaufvorgangs (an der Kasse) eingelöst.\n* Sonderangebote – versteckte Artikel, die den Nutzern erst nach Eingabe eines exklusiven Angebotscode im Katalog angezeigt werden. Wird der Code nicht eingegeben, bleiben die Artikel ausgeblendet.\n\nKonfiguration einer Rabattaktion (Beispielhafter Ablauf):\n1. Erstellen Sie Artikel mit den Aufrufen aus dem Unterabschnitt **Verwaltung** der Gruppen [Virtuelle Gegenstände und Währung](/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [Bundles](/de/api/catalog/bundles-admin/admin-create-bundle) oder [Spielschlüssel](/de/api/catalog/game-keys-admin).\n2. Erstellen Sie eine Werbeaktion mit dem Aufruf [Rabattaktion für Artikel erstellen](/de/api/liveops/promotions-discounts/create-item-promotion/). Übermitteln Sie im `items`-Array die erforderlichen Artikel-SKUs.\n3. Legen Sie die Gültigkeitszeiträume der Werbeaktion fest. Rufen Sie dazu die Methoden [Rabattaktion für Artikel erstellen](/de/api/liveops/promotions-discounts/create-item-promotion/) oder [Artikelaktion aktualisieren](/de/api/liveops/promotions-discounts/update-item-promotion/) auf, und übermitteln Sie das `promotion_periods`-Feld als Objekt-Array, wobei `date_from` das Startdatum und `date_until` das Enddatum des Gültigkeitszeitraums definiert.\n4. Aktivieren Sie eine Werbeaktion mit dem Aufruf [Artikelaktion aktualisieren](/de/api/liveops/promotions-discounts/update-item-promotion/). Übermitteln Sie den Parameter `\"is_enabled\": true`.\n5. Um Informationen über Artikelpreise (einschließlich ermäßigter Preise) zu erhalten, müssen Sie die clientseitigen API-Methoden für den Abruf eines Artikelkatalogs aus den Unterabschnitten [Allgemeines > Katalog](/de/api/catalog/tag/common-catalog/), [Virtuelle Gegenstände und Währung > Katalog](/de/api/catalog/virtual-items-currency-catalog/get-virtual-items/) und [Bundles > Katalog](/de/api/catalog/bundles-catalog/get-bundle-list/) aufrufen.\n\n![Konfiguration einer Werbeaktion (Beispiel)](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)\n\nWeitere Informationen zur Konfiguration von Werbeaktionen finden Sie in unserer Dokumentation:\n* [Rabatte](https://developers.xsolla.com/de/liveops/promotion-tools/discounts/)\n* [Boni](https://developers.xsolla.com/de/liveops/promotion-tools/bonuses/)\n* [Gutscheine](https://developers.xsolla.com/de/liveops/promotion-tools/coupons/)\n* [Promocodes](https://developers.xsolla.com/de/liveops/promotion-tools/promo-codes/)\n* [Katalogsonderangebot](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":"216.73.216.177"},"lang":"de","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/de/api/liveops/promotions-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}