Sie befinden sich hier:
API für Sonderangebotsbelohnungsanträge
Stellen Sie Belohnungen ohne Preis aus und aktualisieren Sie Sonderangebote und Kundenobergrenzen, nachdem Kunden ihre Aufträge aufgegeben haben.
Erforderliche Editionen
| Verfügbarkeit: Lightning Experience |
| Verfügbarkeit: Enterprise, Unlimited und Developer Edition mit Echtzeit-Angebotsverwaltung |
Nachdem eine Bestellung aufgegeben wurde, verwendet die API die angewendeten Sonderangebots- und Belohnungsdetails des Einkaufswagens als Eingabe. Sie können die API für Kontakte und Accounts ausführen. Wenn Ihr Unternehmen Personenaccounts zum Verwalten von Kunden verwendet, geben Sie die Kontakt-ID an, die dem Personenaccount des Kunden zugeordnet ist.
Die API-Antwort enthält die Details zu den Preisen und zu den Belohnungen, die dem Kunden für seine Bestellung bereitgestellt werden. Die API für Sonderangebotsbelohnungsanträge kann ausgeführt werden, um die folgenden Belohnungen bereitzustellen:
- Rabatte
- Gutscheine
- Spiele
Die API für Sonderangebotsbelohnungsanwendungen erstellt oder aktualisiert auch den zugehörigen Nutzungsdatensatz des Sonderangebots anhand der in der API-Anforderung vorhandenen Parameter.
| Parameter | Erstellte oder aktualisierte Nutzungsdatensätze |
|---|---|
| Belohnungen | Datensätze zur Nutzung der Obergrenze für Sonderangebote und zur Nutzung der Sonderangebotspartei für Punkte und Gutscheine. |
| appliedPromotions | Datensätze zur Nutzung der Sonderangebotspartei für die Häufigkeit, mit der Kunden das Sonderangebot verwendet haben. |
Mithilfe von Datensätzen zur Nutzung der Sonderangebotsobergrenze kann die Nutzung der einzelnen Sonderangebotsbelohnungen im Vergleich zu den Obergrenzen des Sonderangebots verfolgt werden. Mithilfe von Datensätzen zur Nutzung der Sonderangebotspartei kann die Nutzung der einzelnen Sonderangebotsbelohnungen durch Kunden im Vergleich zu den Obergrenzen auf Kundenebene des Sonderangebots verfolgt werden.
Die API für die Anwendung von Sonderangeboten verwaltet diese Obergrenzen automatisch.
- Obergrenzen für Sonderangebote:
- Punkte
- Gutscheine
- Kundenobergrenzen:
- Punkte
- Gutscheine
- Verwenden pro Kunde
Sie müssen Prozesse einrichten, um die Obergrenzen für Einkaufswagen, Belegposten, Verbindlichkeiten und Gesamtnutzung zu verwalten.
Nach der Ausführung der API wird der Wert des Felds "Nutzungsanzahl" in der Nutzung der Sonderangebotspartei des Kunden um 1 erhöht.
API für Sonderangebotsbelohnungsanträge für Sonderangebote mit Gutscheinen
Geben Sie beim Ausführen der API den Gutscheincode an, den der Kunde für seine Bestellung verwendet hat. Der Gutscheincode identifiziert eindeutig das Sonderangebot, das der Kunde für seine Bestellung verwendet hat.
Die API besteht aus dem Parameter shouldCheckCouponUsageLimit. Wenn Sie die Nutzung des Gutscheins bereits erhöht haben, legen Sie den Parameter auf "Falsch" fest. Wenn Sie die API verwenden möchten, um zu überprüfen, ob der Gutschein eingelöst werden kann, und dann die Anzahl der Gutscheinverwendungen erhöhen möchten, legen Sie den Parameter auf "Wahr" fest.
