Open Loyalty

Open Loyalty ist eine cloudbasierte Plattform für Kundenbindungs-Programme, mit der Sie Kundenbindungs- und Rewards-Programme erstellen und verwalten können. Die Integration von Braze und Open Loyalty synchronisiert Loyalitätsdaten – wie Punktestand, Tier-Änderungen und Ablaufwarnungen – in Realtime direkt mit Braze. So können Sie personalisierte Nachrichten (E-Mail, Push, SMS) triggern, wenn sich der Loyalitätsstatus einer Nutzerin oder eines Nutzers ändert.

Diese Integration wird von Open Loyalty gepflegt.

Über die Integration

Diese Integration verwendet Braze-Datentransformationen, um Webhooks von Open Loyalty zu erfassen und auf Braze-Nutzerprofile abzubilden.

• Realtime-Updates: Pushen Sie Loyalitäts-Events (verdiente Punkte, Tier-Upgrades) an Braze.
• Personalisierung: Verwenden Sie Loyalitäts-Attribute (aktueller Saldo, Name der nächsten Stufe) in Ihren Braze-Templates.
• Bidirektional: Aktualisieren Sie angepasste Attribute von Open-Loyalty-Kund:innen auf Grundlage von Braze-Engagement-Daten.

Anwendungsfälle

Diese Integration umfasst die folgenden Datenflüsse:

1. Events mit Braze synchronisieren (eingehend): Verfolgen Sie Punkteänderungen, Tier-Upgrades oder Prämieneinlösungen, indem Sie Daten von Open Loyalty an Braze senden. Die Datentransformation wandelt diese Daten in ein Nutzer-Event um.
2. Open-Loyalty-Mitglieder ändern (ausgehend): Aktualisieren Sie automatisch Mitgliedsdaten in Open Loyalty auf Grundlage des Nutzerverhaltens in Braze, z. B. durch Hinzufügen von „VIP“-Labels oder Aktualisieren angepasster Attribute.

Voraussetzungen

Bevor Sie beginnen, benötigen Sie Folgendes:

Integration

Die primäre Integration synchronisiert Open-Loyalty-Webhook-Events über Datentransformation mit Braze.

1. Schritt: Webhook-URL in Braze generieren

Erstellen Sie zunächst eine Datentransformation in Braze, um eine eindeutige URL für den Datenempfang zu generieren.

1. Öffnen Sie in Braze Data Settings > Data Transformation.
2. Klicken Sie auf Create Transformation.
3. Füllen Sie die folgenden Felder aus:
   • Transformation name: Geben Sie einen beschreibenden Namen ein (z. B. „Open Loyalty Point Update Events“).
   • Select destination: Wählen Sie POST: Track users.
4. Klicken Sie auf Create Transformation.
5. Suchen Sie die Webhook URL auf der rechten Seite und klicken Sie auf Copy.

Wichtig

Bewahren Sie diese URL sicher auf – Sie benötigen sie für den nächsten Schritt.

2. Schritt: Webhook-Abo in Open Loyalty erstellen

Weisen Sie Open Loyalty an, bestimmte Events an die soeben generierte URL zu senden.

1. Melden Sie sich in Ihrem Open Loyalty Admin Panel an.
2. Navigieren Sie zu General > Webhooks.
3. Klicken Sie auf Add new webhook und konfigurieren Sie das Abo:
   • eventName: Wählen Sie das Event aus, das Sie tracken möchten (z. B. AvailablePointsAmountChanged, CustomerLevelChanged oder CampaignEffectWasApplied).
   • url: Fügen Sie die Braze-Webhook-URL aus Schritt 1 ein.
   • Fügen Sie die folgenden Header hinzu:
     • Content-Type: application/json
     • User-Agent: partner-OpenLoyalty
4. Speichern Sie das Webhook-Abo.

3. Schritt: Datentransformation konfigurieren

Schreiben Sie die JavaScript-Logik in Braze, um den eingehenden Open-Loyalty-Payload auf Braze-Eigenschaften abzubilden.

1. Öffnen Sie in Braze die Datentransformation, die Sie in Schritt 1 erstellt haben.
2. Triggern Sie das Event in Open Loyalty (z. B. ändern Sie die Punkte eines Mitglieds oder weisen Sie eine Stufe zu), um einen Beispiel-Payload im Bereich Webhook details zu erzeugen.
3. Schreiben Sie im Transformation code-Editor ein Skript zur Abbildung der eingehenden Daten. Verwenden Sie das folgende Beispiel als Anhaltspunkt:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// 1. Parse the incoming Open Loyalty payload
const data = payload.data;

// 2. Construct the Braze API body
let brazecall = {
  "events": [
    {
      // CRITICAL: Map the identifier (e.g., loyaltyCardNumber -> external_id)
      "external_id": data.customer.loyaltyCardNumber,

      // Define the Event Name (what you see in Braze)
      "name": "Loyalty Event Triggered",

      // timestamp
      "time": new Date().toISOString(),

      // Map specific properties you want to use in emails/segments
      "properties": {
        "event_type": payload.type, // for example, 'AvailablePointsAmountChanged'
        "new_balance": data.amount,
        "change_amount": data.amountChange,
        "tier_name": data.tier ? data.tier.name : null
      }
    }
  ]
};

return brazecall;

4. Klicken Sie auf Validate, um sicherzustellen, dass der Code mit Ihrem Beispiel-Payload funktioniert, und klicken Sie dann auf Activate.

Open Loyalty mit Braze verwenden

Nachdem Sie die eingehende Integration abgeschlossen haben, konfigurieren Sie ausgehende Updates, um Open-Loyalty-Mitglieder auf Grundlage des Braze-Verhaltens zu ändern.

1. Schritt: Braze-Webhook-Campaign konfigurieren

Dieser Prozess verwendet Braze-Webhooks, um eine PATCH-Anfrage an die Open Loyalty Member API zu senden (z. B. um ein „VIP“-Label hinzuzufügen).

1. Erstellen Sie in Braze eine neue Webhook Campaign (oder verwenden Sie einen Webhook innerhalb eines Canvas).
2. Klicken Sie auf Compose Webhook.
3. Webhook URL: Konstruieren Sie die URL unter Verwendung Ihrer Open-Loyalty-Instanz, der Tenant-ID und der Braze-Liquid-Variable für die Nutzer-ID.

   • Format:

     https://<YOUR_OL_INSTANCE>/api/<TENANT_ID>/member/loyaltyCardNumber={{${user_id}}}

4. Füllen Sie die folgenden Felder aus:
   • Request Method: PATCH
   • Request Headers:
     • Content-Type: application/json
     • X-AUTH-TOKEN: <YOUR_PERMANENT_TOKEN>
     • User-Agent: Braze
5. Request Body: Wählen Sie Raw text und fügen Sie den Payload ein:

1
2
3
4
5
6
7
8
9
10
{
  "customer": {
    "labels": [
      {
        "key": "braze_vip_segment",
        "value": "optedIn"
      }
    ]
  }
}

2. Schritt: Trigger konfigurieren

1. Navigieren Sie zum Tab Delivery oder Entry Schedule.
2. Füllen Sie die folgenden Felder aus:
   • Delivery Method: Action-Based.
   • Trigger: Definieren Sie den entsprechenden Trigger (z. B. eine Nutzerin oder ein Nutzer tritt einem bestimmten Segment in Braze bei).
   • Launch: Aktivieren Sie die Campaign.

Fehlerbehebung

Eingehende Events überprüfen

Wenn die Datentransformation aktiv ist, erscheinen die Daten in Braze als angepasstes Event. Überprüfen Sie dies, indem Sie eine Campaign mit einem Perform Custom Event-Trigger erstellen und prüfen, ob das von Ihnen definierte Event (z. B. Loyalty Event Triggered) verfügbar ist.

Ausgehende Webhooks überprüfen

Überprüfen Sie das Nachrichten-Aktivitätsprotokoll in Braze, um sicherzustellen, dass der Webhook den Status 200 OK zurückgegeben hat.

• 401-Fehler: Überprüfen Sie Ihr Open Loyalty API-Token.
• 404-Fehler: Die Nutzer-ID in Braze existiert nicht in Open Loyalty.