Teilen über

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 Werbung, die auf Transaktionen für neue Commerce-Abonnements angewendet werden.

Höherstufung

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

Eigenschaft Typ Beschreibung
id Zeichenfolge Der Heraufsufungsbezeichner.
name Zeichenfolge Der Anzeigename der Werbung.
Beschreibung string Eine Beschreibung der Werbung.
startDate Zeichenfolge Das Startdatum für den Zeitpunkt, an dem die Werbeaktion anwendbar ist.
endDate Zeichenfolge Das Enddatum, an dem die Aktion gültig ist.
requiredProducts Liste der erforderlichen Produkte Produkt-, SKU-Details und Preisrichtlinien, für die die Werbeaktion gilt.
properties Liste der Eigenschaften Eigenschaften für die Heraufstufung, einschließlich der automatischen Anwendbarkeit der Werbung.

RequiredProducts

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

Eigenschaft Typ Beschreibung
productId Zeichenfolge Ein Bezeichner des Produkts, für das die Werbeaktion verfügbar ist.
skuId Zeichenfolge Ein Bezeichner der SKU, für die die Heraufufung verfügbar ist.
term Begriff Ein Ausdruck einschließlich Laufzeit und Abrechnungszeitraum die Aktion verfügbar ist.
pricingPolicies Liste der preisePolicies Eine Liste der Richtlinien, die die Rabatttypen und -werte für Werbeaktionen definieren.

Begriff

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

Eigenschaft Typ Beschreibung
duration 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 Werbeaktion auf die Abrechnung angewendet wird. Werte können monatlich, jährlich, OneTime oder Unbekannt enthalten.

PricingPolicies

Beschreiben Sie die Rabatttypen und -werte der Werbeaktion.

Eigenschaft Typ Beschreibung
type Zeichenfolge Beschreiben Sie, ob der Rabatt auf Prozentsätze oder Pauschalrabatte basiert.
value Zeichenfolge Definiert den Betrag des angewendeten Rabatts.

Eigenschaften

Eigenschaften für die Heraufufung.

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

PromotionEligibilitiesRequestItem

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

Eigenschaft Typ Beschreibung
id int Die Berechtigungselement-ID für Werbeaktionen.
catalogItemId Zeichenfolge Der Katalogelementbezeichner, auf den die Heraufstufung angewendet wird. Umfasst Produkt-ID, SKU-ID und Verfügbarkeits-ID.
Menge 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 Werbeaktion auf die Abrechnung angewendet wird. Werte können monatlich, jährlich, OneTime oder Unbekannt enthalten.
promotionID Zeichenfolge Der Heraufsufungsbezeichner.

PromotionEligibilities

Eine Liste der Produkte, SKUs und deren Förderberechtigungen.

Eigenschaft Typ Beschreibung
id int Die Berechtigungselement-ID für Werbeaktionen.
catalogItemId Zeichenfolge Der Katalogelementbezeichner, auf den die Heraufstufung angewendet wird. Umfasst Produkt-ID, SKU-ID und Verfügbarkeits-ID.
Menge 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 Werbeaktion auf die Abrechnung angewendet wird. Werte können monatlich, jährlich, OneTime oder Unbekannt enthalten.
Berechtigungsberechtigungen Liste der PromotionEligibilities Stellt eine Liste der Promotionsberechtigungsergebnisse dar.

PromotionEligibility

Eine Liste der Produkte, SKUs und deren Förderberechtigungen.

Eigenschaft Typ Beschreibung
promotionId Zeichenfolge Der Heraufsufungsbezeichner.
isEligible bool Beschreibt, ob die Werbeaktion für das angegebene Berechtigungsanforderungselement berechtigt ist.
errors Liste der PromotionEligibilityErrors Fehler, die beschreiben, warum ein Anforderungselement für Werbeaktionen nicht berechtigt war.

PromotionEligibilityError

Erläutert, warum ein Berechtigungsanforderungselement für Werbeaktionen nicht berechtigt war.

Eigenschaft Typ Beschreibung
type Zeichenfolge Die Berechtigungstypen für die Heraufstufung können InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously oder Term enthalten.
Beschreibung string Beschreibt, ob die Werbeaktion für das angegebene Berechtigungsanforderungselement berechtigt ist.

RedemptionLimitPromotionEligibilityError

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

Eigenschaft Typ Beschreibung
maxPromotionRedemptionCount int Die maximale Anzahl von Aktionen, die eine Aktion erworben werden kann.
remainingPromotionRedemptionCount int Die verbleibende Anzahl von Aktionen, die eine Aktion erworben werden kann.

SeatCountPromotionEligibilityError

Enthält Details dazu, warum der Grenzwert für die Anzahl von Arbeitsplätzen überschritten wurde. Alle Werte können nullwerte sein.

Eigenschaft Typ Beschreibung
minimumRequiredSeats int Die Mindestlizenzen, die eine Werbeaktion unterstützt.
maximumRequiredSeats int Die maximalen Lizenzen, die eine Werbeaktion unterstützt.
availableSeats int Die verbleibende Anzahl von Lizenzen, die ein Partner für eine bestimmte Aktion erwerben kann.

TermPromotionEligibilityError

Enthält Details dazu, warum der Werbeaktionsausdruck nicht akzeptiert wurde.

Eigenschaft Typ Beschreibung
eligibleTerms PromotionTerm Die berechtigten Bedingungen einer Werbeaktion werden unterstützt.

PromotionTerm

Enthält Details dazu, warum der Grenzwert für die Anzahl von Arbeitsplätzen überschritten wurde.

Eigenschaft Typ Beschreibung
billingCycle Zeichenfolge Beschreibt, wie oft die Werbeaktion auf die Abrechnung angewendet wird. Werte können monatlich, jährlich, OneTime oder Unbekannt enthalten.
duration Zeichenfolge Dauer des Kaufs.