Promotionressourcen
Gilt für
- Partner Center
Geeignete Rollen
- 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. |