Promotionressourcen

  • Artikel

Gilt für

  • Partner Center

Geeignete Rollen

  • Globaler Administrator
  • Administrator-Agent

Hinweis

Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.

Beschreibt die Ressourcen für Werbeaktionen, die auf Transaktionen für neue E-Commerce-Abonnements angewendet werden.

Promotion

Rabatt, der beim Kauf einer Produkt-SKU angewendet wird, wenn die Berechtigungskriterien erfüllt sind.

Eigenschaft Typ BESCHREIBUNG
id Zeichenfolge Der Heraufstufungsbezeichner.
name Zeichenfolge Der Anzeigename der Promotion.
description Zeichenfolge Eine Beschreibung der Heraufstufung.
startDate Zeichenfolge Das Startdatum für den Zeitpunkt, an dem die Heraufstufung anwendbar ist.
endDate Zeichenfolge Das Enddatum für den Zeitpunkt, an dem die Heraufstufung anwendbar ist.
requiredProducts Liste der erforderlichenProdukte Produkt-, SKU-Details und Preisrichtlinien, für die die Promotion gilt.
properties Liste der Eigenschaften Eigenschaften für die Heraufstufung, einschließlich ob die Heraufstufung automatisch anwendbar ist.

Erforderliche Produkte

Produkt-, SKU-Details und Preisrichtlinien, für die die Promotion gilt.

Eigenschaft Typ BESCHREIBUNG
productId Zeichenfolge Ein Bezeichner des Produkts, für das die Promotion verfügbar ist.
skuId Zeichenfolge Ein Bezeichner der SKU, für die die Heraufstufung verfügbar ist.
Begriff Begriff Ein Begriff, der die Laufzeit und Abrechnungszeitraum die Promotion zur Verfügung steht.
pricingPolicies PreisübersichtRichtlinien Eine Liste von Richtlinien, die die Rabatttypen und -werte für die Heraufstufung definieren.

Begriff

Stellt einen Begriff dar, für den die Promotion erworben werden kann.

Eigenschaft Typ BESCHREIBUNG
duration Zeichenfolge Eine ISO 8601-Darstellung der Dauer des Begriffs. Die derzeit unterstützten Werte sind P1M (ein Monat), P1Y (ein Jahr) und P3Y (drei Jahre).
billingCycle Zeichenfolge Beschreibt, wie oft die Promotion auf die Abrechnung angewendet wird. Die Werte können Monatlich, Jährlich, OneTime oder Unbekannt sein.

PreiseRichtlinien

Beschreiben sie die Rabatttypen und -werte für Die Höherstufung.

Eigenschaft Typ BESCHREIBUNG
type Zeichenfolge Beschreiben, ob der Rabatt auf Prozentsätzen oder Pauschalrabatten basiert.
value Zeichenfolge Definiert die Höhe des angewendeten Rabatts.

Eigenschaften

Eigenschaften für die Heraufstufung.

Eigenschaft Typ BESCHREIBUNG
isAutoApplicable bool Gibt an, ob die Heraufstufung automatisch angewendet wird oder vom Partner übergeben werden muss.

PromotionEligibilitiesRequestItem

Eigenschaften, die eine Transaktion und die Berechtigung einer Heraufstufung darstellen.

Eigenschaft Typ BESCHREIBUNG
id INT Der Aktionsberechtigungselementbezeichner.
catalogItemId Zeichenfolge Der Katalogelementbezeichner, auf den die Heraufstufung angewendet wird. Enthält Produkt-ID, SKU-ID und Verfügbarkeits-ID.
quantity INT Die Anzahl der Lizenzen oder Instanzen.
termDuration Zeichenfolge Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuellen unterstützten Werte sind P1M (ein Monat), P1Y (ein Jahr) und P3Y (drei Jahre).
billingCycle Zeichenfolge Beschreibt, wie oft die Promotion auf die Abrechnung angewendet wird. Die Werte können monatlich, annual, OneTime oder Unknown sein.
promotionID Zeichenfolge Der Heraufstufungsbezeichner.

PromotionEligibilitäten

Eine Liste der Produkte, SKUs und deren Promotionberechtigungen.

Eigenschaft Typ BESCHREIBUNG
id INT Der Aktionsberechtigungselementbezeichner.
catalogItemId Zeichenfolge Der Katalogelementbezeichner, auf den die Heraufstufung angewendet wird. Enthält Produkt-ID, SKU-ID und Verfügbarkeits-ID.
quantity INT Die Anzahl der Lizenzen oder Instanzen.
termDuration Zeichenfolge Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuellen unterstützten Werte sind P1M (ein Monat), P1Y (ein Jahr) und P3Y (drei Jahre).
billingCycle Zeichenfolge Beschreibt, wie oft die Promotion auf die Abrechnung angewendet wird. Die Werte können Monatlich, Jährlich, OneTime oder Unbekannt sein.
Teilnahmeberechtigungen Liste der PromotionEligibilitäten Stellt eine Liste der Ergebnisse der Promotionberechtigung dar.

PromotionEligibility

Eine Liste der Produkte, SKUs und deren Promotionberechtigungen.

Eigenschaft Typ BESCHREIBUNG
promotionId Zeichenfolge Der Heraufstufungsbezeichner.
isEligible bool Beschreibt, ob die Promotion für das angegebene Berechtigungsanforderungselement in Frage kommt.
errors Liste der PromotionEligibilityErrors Fehler, die beschreiben, warum ein Anforderungselement für eine Promotion nicht berechtigt war.

PromotionEligibilityError

Erläutert, warum ein Anforderungselement für eine Promotion nicht berechtigt war.

Eigenschaft Typ BESCHREIBUNG
type Zeichenfolge Die Berechtigungsfehlertypen der Promotion können InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously oder Term enthalten.
description Zeichenfolge Beschreibt, ob die Promotion für das angegebene Berechtigungsanforderungselement in Frage kommt.

RedemptionLimitPromotionEligibilityError

Enthält Details dazu, warum das Einlösungslimit überschritten wurde.

Eigenschaft Typ BESCHREIBUNG
maxPromotionRedemptionCount INT Die maximale Anzahl, mit der eine Promotion erworben werden kann.
restPromotionRedemptionCount INT Die verbleibende Häufigkeit, mit der eine Promotion erworben werden kann.

SeatCountPromotionEligibilityError

Enthält Details dazu, warum das Limit für die Anzahl von Sitzplätzen überschritten wurde. Alle Werte sind NULLable.

Eigenschaft Typ BESCHREIBUNG
minimumRequiredSeats INT Die Mindestlizenzen, die von einer Promotion unterstützt werden.
maximumRequiredSeats INT Die maximalen Lizenzen, die von einer Heraufstufung unterstützt werden.
availableSeats INT Die verbleibende Anzahl von Lizenzen, die ein Partner für eine bestimmte Promotion erwerben kann.

TermPromotionEligibilityError

Enthält Details dazu, warum der Promotion-Begriff nicht akzeptiert wurde.

Eigenschaft Typ BESCHREIBUNG
eligibleTerms PromotionTerm Die berechtigten Bedingungen, die eine Promotion unterstützt.

PromotionTerm

Enthält Details dazu, warum das Limit für die Anzahl von Sitzplätzen überschritten wurde.

Eigenschaft Typ BESCHREIBUNG
billingCycle Zeichenfolge Beschreibt, wie oft die Promotion auf die Abrechnung angewendet wird. Die Werte können Monatlich, Jährlich, OneTime oder Unbekannt sein.
duration Zeichenfolge Dauer der Erworbenen Laufzeit.