Diese Aktion löst für einen Kunden eine Prämie ein, genauso wie er es selbst in seiner Kunden-App tun würde. JeriCommerce prüft die Regeln der Prämie, zieht die Punkte ab und gibt dem Kunden einen Rabattcode. Verwenden Sie sie, wenn Kunden auf Ihrer eigenen Website, in Ihrer App oder an Ihrer Kasse einlösen, oder um automatisch aus einem Klaviyo Flow einzulösen.

Was passiert

  • Die Punkte der Prämie werden vom Punktestand des Kunden abgezogen.
  • Der Kunde erhält einen Rabattcode: einen neuen Shopify-Code für die einmalige Verwendung oder den nächsten Code aus Ihrem hochgeladenen Vorrat, je nach Rabatt der Prämie.
  • Der Kunde erhält eine E-Mail mit dem Code, und der Code erscheint unter seinen Coupons.
  • Ein Ereignis Reward redeemed mit dem code und ein Ereignis Balance changed werden an Ihren Events-Webhook gesendet. Hören Sie auf Reward redeemed, wenn Ihr System den Code braucht.

Ein Fixed reward kostet immer seine Points cost. Bei einer Prämie vom Typ Points as cash wählt der Kunde, wie viele Punkte er einsetzt, zwischen dem Minimum und dem Maximum der Prämie. Der Rabatt ergibt sich aus den Punkten multipliziert mit dem Wert jedes Punkts, auf zwei Dezimalstellen gerundet. Zum Beispiel ergeben 500 Punkte im Wert von je 0,02 einen Rabatt von 10,00.

Das Einlösen wird abgelehnt, ohne dass Punkte abgezogen werden, wenn:

  • der Kunde nicht genug Punkte hat oder ein Teil seiner Punkte noch gesperrt ist.
  • der Kunde die Sichtbarkeits- oder Segmentregeln der Prämie nicht erfüllt.
  • im Rabatt der Prämie keine Codes mehr vorhanden sind.
  • bei einer Prämie vom Typ Points as cash die einzulösenden Punkte fehlen oder außerhalb von Minimum und Maximum liegen.

Einrichtung

Shopify Flow hat keine JeriCommerce-Aktion zum Einlösen von Prämien. Um aus einer Automatisierung einzulösen, verwenden Sie einen Klaviyo-Webhook oder die API.

In Ihrem Shop können Kunden Prämien selbst in der Kunden-App einlösen, und Ihr Team kann sie an der Kasse einlösen, wie unter Prämien von Kunden in Shopify POS ansehen und einlösen beschrieben.

Fügen Sie Ihrem Klaviyo Flow eine Aktion Webhook hinzu. Füllen Sie den folgenden Builder aus und kopieren Sie jeden Wert in die Webhook-Einstellungen. Die ID einer Prämie finden Sie, wenn Sie sie unter Loyalty > Ways to redeem öffnen.

Ihre Angaben

Sie finden ihn unter Settings > Technical > Program Information.

Erstellen Sie einen unter Settings > Technical > API Keys. Er bleibt in Ihrem Browser.

Aktionsdetails

Öffnen Sie die Prämie unter Loyalty > Ways to redeem, um ihre ID zu sehen.

Geben Sie für Points as cash eine ganze Zahl von mindestens 1 ein. Lassen Sie das Feld für Fixed reward leer.

Kopieren und in Klaviyo einfügen

Webhook-Einstellungen
Destination URL
https://api.jericommerce.com/v1/programs/your-program-slug/reward/redeem
Headers
Key
api-key
Value
your-api-key
JSON body
[
  {
    "email": "{{ person.email|default:'' }}",
    "rewardId": ""
  }
]

Geben Sie bei einer Prämie vom Typ Points as cash die einzulösenden Punkte als ganze Zahl von mindestens 1 ein. Lassen Sie das Feld bei einem Fixed reward leer. Klaviyo Customer Hub unterstützt nur Fixed-reward-Optionen.

Klaviyo-Webhooks werden in eine Warteschlange gestellt: JeriCommerce verarbeitet das Einlösen einige Sekunden später, und Klaviyo erfährt nicht, wenn es abgelehnt wird.

POST https://api.jericommerce.com/v1/programs/{program_slug}/reward/redeem

Senden Sie Ihren API-Schlüssel im Header api-key. Siehe Authentifizierung über die API. Der Body ist ein Array mit bis zu 100 Einträgen:

[
  {
    "email": "customer@example.com",
    "rewardId": "2f6c1a2e-8f3b-4f0e-9a51-1d2b3c4d5e6f"
  }
]
Feld Typ Erforderlich Hinweise
email string Ja E-Mail-Adresse eines Kunden, der bereits im Programm ist.
rewardId string Ja Die id der Prämie. Sie erhalten sie über Prämien auflisten.
pointsToRedeem integer Nur bei Points as cash Wie viele Punkte umgewandelt werden, zwischen minPoints und maxPoints der Prämie. Wird bei einem Fixed reward ignoriert.

In der API hat ein Fixed reward "type": "fixed" und kostet redeemCost Punkte. Eine Prämie vom Typ Points as cash hat "type": "dynamic", und ihr Rabatt ist pointsToRedeem multipliziert mit currencyPerPoint.

Die API antwortet mit 201 und leerem Body, sobald die Anfrage gültig ist. Das Einlösen wird einige Sekunden später verarbeitet. Die Antwort enthält daher nicht den Rabattcode, und Ablehnungen werden nicht gemeldet. Siehe Endpunkte mit Warteschlange. Um vorab zu prüfen, vergleichen Sie den Punktestand des Kunden aus Kundendetails abrufen mit den Kosten der Prämie.

Code Status Bedeutung
MAX_ITEMS_PER_REQUEST_EXCEEDED 400 Das Array enthält mehr als 100 Einträge.
Validierungsfehler 400 email fehlt, rewardId ist keine gültige ID oder pointsToRedeem ist keine ganze Zahl ab 1.

Erstellen Sie mit Ihren eigenen Werten eine fertige Anfrage:

Ihre Angaben

Sie finden ihn unter Settings > Technical > Program Information.

Erstellen Sie einen unter Settings > Technical > API Keys. Er bleibt in Ihrem Browser.

Aktionsdetails

Öffnen Sie die Prämie unter Loyalty > Ways to redeem, um ihre ID zu sehen.

Geben Sie für Points as cash eine ganze Zahl von mindestens 1 ein. Lassen Sie das Feld für Fixed reward leer.

Ihre Anfrage

curl --request POST \
  --url 'https://api.jericommerce.com/v1/programs/your-program-slug/reward/redeem' \
  --header 'api-key: your-api-key' \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "email": "customer@example.com",
    "rewardId": ""
  }
]'

Fügen Sie ihn in ein Terminal ein, um die Anfrage mit Ihrem Programm zu testen.