Diese Aktion fügt dem Punktestand eines Kunden Punkte hinzu oder zieht sie ab. Verwenden Sie sie, wenn etwas außerhalb von JeriCommerce entscheidet, dass ein Kunde Punkte verdient hat, etwa eine Bewertung, eine Umfrage oder die Teilnahme an einer Veranstaltung, oder wenn Sie einen Punktestand korrigieren müssen.

Für einmalige Änderungen brauchen Sie keine Automatisierung: Verwenden Sie Update balance im Kundenprofil, beschrieben unter Punktestand erhöhen und verringern, oder die Möglichkeiten unter Punktestand über Shopify anpassen. Wenn Kunden die Handlung, für die es Punkte gibt, wiederholen können, passt eine eigene Sammelaktion besser, weil sie Ihre Limits anwendet und die Aktion bei den Möglichkeiten zum Sammeln anzeigt.

Was passiert

  • Der Betrag ist immer eine positive Zahl. Sie wählen, ob Punkte hinzugefügt oder abgezogen werden, und geben eine Begründung an, die mit der Änderung gespeichert wird.
  • Der Punktestand des Kunden und seine Treuekarte werden aktualisiert, und ein Ereignis Balance changed wird an Ihren Events-Webhook gesendet.
  • Beim Hinzufügen von Punkten vervielfacht eine Boost-Kampagne, die für Manual / API points gilt, den Betrag. Wenn der Geltungsbereich Ihres Stufenfaktors Tier balance and points ist, wird auch der Stufenfaktor angewendet. Die gutgeschriebenen Punkte können also höher sein als der Betrag, den Sie senden.
  • Bei punktebasierten VIP-Stufen zählen hinzugefügte Punkte auch für die Stufe des Kunden, und abgezogene Punkte werden davon abgezogen.
  • Der Kunde erhält eine Wallet-Benachrichtigung, wenn Benachrichtigungen zum Punktestand für das Programm und für den Kunden eingeschaltet sind.

Ein Punktestand kann nicht unter null fallen. Hat der Kunde weniger Punkte als den Betrag, den Sie abziehen, wird nichts abgezogen.

Einrichtung

Verwenden Sie die JeriCommerce-Aktionen Balance increase und Balance decrease in einem beliebigen Shopify-Flow-Workflow. Beide funktionieren mit dem JeriCommerce-Treueprogramm und mit LoyaltyLion.

1

Aktion hinzufügen

Öffnen Sie in Shopify Flow, erstellen oder bearbeiten Sie einen Workflow und fügen Sie nach Ihrem Auslöser Balance increase oder Balance decrease hinzu.

2

Felder ausfüllen

  • Email: die E-Mail-Adresse des Kunden. Wählen Sie sie mit Add variable aus dem Auslöser aus.
  • Amount: die Anzahl der Punkte, immer positiv.
  • Reason: warum sich der Punktestand ändert.
3

Workflow aktivieren

Speichern und aktivieren Sie den Workflow. Der Punktestand ändert sich bei jedem Auslösen.

Shopify-Flow-Aktionen zum Aktualisieren des Punktestands
Shopify-Flow-Aktionen für den Punktestand

Die Änderung passiert, während der Workflow läuft. Lässt sie sich nicht anwenden, schlägt der Schritt fehl und der Fehler erscheint im Ausführungsverlauf des Workflows. Das passiert, wenn die E-Mail-Adresse zu keinem Kunden gehört, der Kunde noch keinen Punktestand hat oder er nicht genug Punkte zum Abziehen hat.

Fügen Sie Ihrem Klaviyo Flow an der Stelle, an der sich der Punktestand ändern soll, eine Aktion Webhook hinzu. Wählen Sie, ob erhöht oder verringert wird, füllen Sie den Builder aus und kopieren Sie jeden Wert in die Webhook-Einstellungen.

Aktion wählen

Ihre Angaben

Sie finden ihn unter Settings > Technical > Program Information.

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

Aktionsdetails

Kopieren und in Klaviyo einfügen

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

Sie können auch im Grund Klaviyo-Variablen verwenden, zum Beispiel "Bonus for reviewing {{ event.product_name }}", damit jede Änderung im Verlauf des Kunden für sich spricht.

Klaviyo-Webhooks werden in eine Warteschlange gestellt: Klaviyo sendet die Anfrage und JeriCommerce wendet sie einige Sekunden später an. Gehört die E-Mail-Adresse zu keinem Kunden oder sind nicht genug Punkte zum Abziehen vorhanden, wird die Änderung übersprungen und Klaviyo erfährt davon nichts.

Ein paar Ideen für Flows: ein Willkommensbonus, wenn sich jemand in Ihre Liste einträgt, Punkte für eine Produktbewertung, ein Bonus zur Rückgewinnung von Kunden, die länger nicht bestellt haben, oder zusätzliche Punkte zum Geburtstag.

POST https://api.jericommerce.com/v1/programs/{program_slug}/balance/increase
POST https://api.jericommerce.com/v1/programs/{program_slug}/balance/decrease

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

[
  {
    "email": "customer@example.com",
    "amount": 100,
    "reason": "Thanks for attending our launch event"
  }
]
Feld Typ Erforderlich Hinweise
email string Ja E-Mail-Adresse eines Kunden, der bereits im Programm ist.
amount number Ja Anzahl der Punkte zum Hinzufügen oder Abziehen, als ganze Zahl größer als 0.
reason string Ja Warum sich der Punktestand ändert. Wird mit der Änderung gespeichert.

Die API antwortet mit 201 und leerem Body, sobald die Anfrage gültig ist, und wendet die Änderung einige Sekunden später an. Siehe Endpunkte mit Warteschlange. Kunden, die nicht existieren, werden übersprungen, ebenso Verringerungen, die größer sind als der Punktestand. Beides wird nicht gemeldet. Prüfen Sie das Ergebnis daher mit Kundendetails abrufen, wenn Sie sicher sein müssen. Ein Kunde, der existiert, aber noch keinen Punktestand hat, beginnt bei 0.

Code Status Bedeutung
MAX_ITEMS_PER_REQUEST_EXCEEDED 400 Das Array enthält mehr als 100 Einträge.
Validierungsfehler 400 Ein Feld fehlt, amount ist keine positive Zahl oder reason ist leer.

Erstellen Sie mit Ihren eigenen Werten eine fertige Anfrage:

Aktion wählen

Ihre Angaben

Sie finden ihn unter Settings > Technical > Program Information.

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

Aktionsdetails

Ihre Anfrage

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

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