{"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":"Mit Werbeaktionslimits können Sie begrenzen, wie oft ein bestimmter Nutzer eine Werbeaktion in Anspruch nehmen darf. Zudem können Sie festlegen, wann das Limit zurückgesetzt wird.\n\nLimits werden aufseiten von Xsolla gespeichert und in den Werbeaktionseinstellungen im [Kundenportal](https://publisher.xsolla.com/0/projects/0/storefront/promotions) oder über das `limits`-Objekt in den folgenden API-Aufrufen konfiguriert:\n* [Rabattaktion für Artikel erstellen](/de/api/liveops/promotions-discounts/create-item-promotion/) oder [Rabattaktion aktualisieren](/de/api/liveops/promotions-discounts/update-item-promotion)\n* [Bonusaktion erstellen](/de/api/liveops/promotions-bonuses/create-bonus-promotion/) oder [Bonusaktion aktualisieren](/de/api/liveops/promotions-bonuses/update-bonus-promotion)\n\nInformationen zu den Limits werden in den folgenden API-Aufrufen zum Abrufen des Artikelkatalogs im Objekt `items.promotions.limits` zurückgegeben:\n* [Liste virtueller Gegenstände abrufen](/de/api/catalog/virtual-items-currency-catalog/get-virtual-items/)\n* [Liste virtueller Währungen abrufen](/de/api/catalog/virtual-items-currency-catalog/get-virtual-currency/)\n* [Liste virtueller Währungspakete abrufen](/de/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package/)\n* [Liste der Bundles abrufen](/de/api/catalog/bundles-catalog/get-bundle-list/)\n* [Spieleliste abrufen](/de/api/catalog/game-keys-catalog/get-games-list/)\n\nMit den API-Aufrufen im Unterabschnitt **Verwaltung** der Gruppe **Limits** können Sie den aktuellen Status der Limits abrufen und diese für einen bestimmten Nutzer aktualisieren – beispielsweise den Zähler nach Abschluss einer Quest zurücksetzen oder die verbleibende Menge manuell anpassen.\n\n
\n Hinweis

\n Ausführliche Informationen zur Konfiguration von Limits im Katalog finden Sie im Abschnitt Werbeaktionslimits.\n
\n\nSie können [limits.per_user](/de/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits) konfigurieren, d. h., wie häufig ein Nutzer eine Werbeaktion in Anspruch nehmen darf.\n\nNicht authentifizierten Nutzern wird stets die Höchstzahl angezeigt, also wie oft man die Werbeaktion maximal in Anspruch nehmen darf.\n\nUm anzuzeigen, wie oft der Nutzer die Werbeaktion unter Berücksichtigung des geltenden Limits noch in Anspruch nehmen darf, müssen Sie bei der Abfrage des Artikelkatalogs die Autorisierungsdaten des Nutzers übermitteln.\n\nUm zu konfigurieren, wie häufig das Limit zurückgesetzt werden soll (täglich, wöchentlich oder monatlich), müssen Sie das `limits.recurrent_schedule`-Objekt beim [Erstellen](/de/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits/recurrent_schedule) oder [Aktualisieren](/de/api/liveops/promotions-discounts/update-item-promotion#promotions-discounts/update-item-promotion/t=request&path=limits/recurrent_schedule) der Werbeaktion übermitteln.\n\n**Konfiguration und Durchsetzung von Limits (Anwendungsszenario)**\n\n1. Sie erstellen eine Werbeaktion mit dem API-Aufruf [Rabattaktion für Artikel erstellen](/de/api/liveops/promotions-discounts/create-item-promotion/) oder [Bonusaktion erstellen](/de/api/liveops/promotions-bonuses/create-bonus-promotion/) und übermitteln das `limits`-Objekt.\n2. Sie rufen den Katalog für einen nicht authentifizierten Nutzer ab – in der Antwort ist das `items.promotions.limits`-Objekt enthalten, darin ist angegeben, wie oft die Werbeaktion maximal in Anspruch genommen werden darf.\n3. Der Nutzer meldet sich an.\n4. Sie rufen den Katalog mit dem Autorisierungstoken des Nutzers ab – in der Antwort ist angegeben, wie oft der Nutzer die Werbeaktion unter Berücksichtigung des aktiven Limits noch in Anspruch nehmen darf.\n5. Der Nutzer wählt einen Aktionsartikel aus und kauft ihn.\n6. Nach erfolgreicher Bezahlung aktualisiert Xsolla den Wert des Parameters `items.promotions.limits.per_user`. Wenn der Parameter den Wert `0` erreicht, wird der Artikel in den Katalog-API-Aufrufen ohne Rabatt oder Bonus zurückgegeben.\n7. Sie können das Limit mit den API-Aufrufen aus dem Unterabschnitt **Verwaltung** aktualisieren:\n * [Alle Werbeaktionslimits für den angegebenen Benutzer aktualisieren](/de/api/liveops/user-limits-admin/reset-all-user-promotions-limit/) oder [Limits für eine bestimmte Werbeaktion aktualisieren](/de/api/liveops/user-limits-admin/reset-user-promotion-limit/)\n * [Spezifischen Limitwert festlegen](/de/api/liveops/user-limits-admin/set-user-promotion-limit/)\n * [Werbeaktionslimit für angegebenen Benutzer erhöhen](/de/api/liveops/user-limits-admin/add-user-promotion-limit/) oder [herabsetzen](/de/api/liveops/user-limits-admin/remove-user-promotion-limit/)\n8. Sie rufen den aktualisierten Limitwert (`items.promotions.limits`) bei der nächsten Katalogabfrage mit dem Autorisierungstoken des Nutzers ab und zeigen ihn dem Nutzer an.\n\n![Werbeaktionslimits](https://cdn.xsolla.net/developers/current/images/api_docs/promotion-limit.svg)"},"itemId":"promotion-limits-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/promotion-limits-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}