SessionM Treueplattform

SessionM ist eine Plattform für Customer-Engagement und Kundentreue, Teil von Capillary Technologies, die Marketern Features für das Kampagnenmanagement und Lösungen für das Loyalitätsmanagement zur Verfügung stellt, um das Engagement und den Gewinn durch gezielte Ansprache zu steigern.

Voraussetzungen

Anwendungsfälle

Die folgenden Anwendungsfälle zeigen einige Möglichkeiten, wie Sie die Integration von SessionM und Braze nutzen können.

• Erstellen Sie eine Segmentierung, die Daten aus allen Kundenbindungs-, Kundenmanagement- und Messaging-Plattformen einbezieht.
• Nutzen Sie eine robuste Segmentierung, um bestimmte Nutzergruppen mit Angeboten und Aktionen anzusprechen.
• Nutzen Sie immer die aktuellsten Nutzer:innen-, Angebots- und Treueinformationen, wenn Sie Nachrichten versenden.
• Informieren Sie Ihre Kund:innen ausführlich über den Fortschritt und den Abschluss von Werbe- und Treueaktionen.
• Benachrichtigen Sie Ihre Kund:innen, wenn ein neues Angebot vergeben wird, und teilen Sie die Angebotsdetails mit.

Integration von SessionM mit Braze

1. Schritt: Segment in Braze erstellen

Erstellen Sie in Braze ein Segment von Nutzer:innen für das Targeting mit SessionM-Aktionen und -Angeboten.

2. Schritt: Braze Segments in SessionM importieren

Option 1: Export zum SessionM-Tag-Endpunkt (empfohlen)

Erstellen Sie zunächst eine Webhook-Kampagne in Braze und setzen Sie die Webhook-URL auf {{endpoint_core}}/priv/v1/apps/{{appkey_core}}/users/{{${user_id}}}/tags. Verwenden Sie Liquid, um die user_id innerhalb der URL zu definieren.

Stellen Sie den Body für die Anfrage des Webhooks mit Hilfe eines Rohtextes so zusammen, dass er die gewünschten Tags, die dem Nutzerprofil in SessionM hinzugefügt werden sollen, und die gewünschte Gültigkeitsdauer enthält. Ein Beispiel:

1
2
3
4
5
6
 {
   "tags":[
    "braze_test"
   ],
   "ttl":2592000
}

Fügen Sie im Tab Einstellungen die Schlüssel-Wert-Paare für jedes Anfrage-Header-Feld hinzu: - Erstellen Sie einen Schlüssel Content-Type mit dem entsprechenden Wert application/json - Erstellen Sie einen Schlüssel Authorization mit dem entsprechenden Wert Basic YOUR-ENCODED-STRING-KEY. Wenden Sie sich an Ihr SessionM-Team, um den kodierten String-Schlüssel für Ihren Endpunkt zu erhalten.

Planen Sie Ihre Zustellung, legen Sie Ihre Zielgruppen für das Targeting des zuvor erstellten Segments fest und starten Sie dann Ihre Kampagne.

Wichtig

Dieser Vorgang kann auch über einen API-Client wie Postman durchgeführt werden, indem Sie eine Anfrage direkt an den SessionM-Tag-Endpunkt stellen und dabei die Kund:in, den Tag-Namen und eine Gültigkeitsdauer für jede Nutzer:in im Aufruf angeben (eine Nutzer:in pro Aufruf).

Die folgende Beispielanfrage verwendet cURL.

1
2
3
4
5
6
7
8
9
10
curl --location -g --request POST '{{endpoint_core}}/priv/v1/apps/{{apikey_core}}/users/{{user_id}}/tags' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{base64_encoded_string}}' \
--data-raw '{
"tags":[
"tagname1",
"tagname2"
],
"ttl":20000
}'

Option 2: CSV-Import

Exportieren Sie Ihr Braze Segment mit dem Braze Segmenter und stellen Sie SessionM eine CSV-Datei zur Verfügung, die die zu taggenden Kund:innen, den Tag-Namen und eine Gültigkeitsdauer für jede Nutzer:in in der Datei enthält.

Realtime-Angebotsmappe mit Braze abrufen

Die Integration von SessionM mit Braze ermöglicht den Abruf von SessionM-Nutzerdaten in Echtzeit zum Zeitpunkt des Nachrichtenversands mithilfe von Connected-Content, um das Risiko auszuschließen, dass veraltete, abgelaufene oder bereits eingelöste Treueangebote an Kund:innen übermittelt werden.

Das folgende Beispiel zeigt, wie Connected-Content verwendet wird, um Daten der Angebotsmappe als Template in eine Nachricht einzufügen. Connected-Content kann jedoch mit jedem der Connect-Endpunkte von SessionM verwendet werden.

1. Schritt: Angebot in SessionM ausgeben

SessionM gibt Kund:innen Angebote über verschiedene interne Hebel aus, die konfiguriert werden können. Nach der Ausgabe werden die Angebote in einen Zustand versetzt, den SessionM als „Angebotsmappe“ bezeichnet.

Eine Kund:in muss die erforderliche Aktion durchführen oder das Targeting erfüllen und erhält das Angebot innerhalb von SessionM.

SessionM fügt das Angebot dann der Angebotsmappe der Kund:in im ausgegebenen Zustand hinzu.

2. Schritt: SessionM Offer Wallet API aufrufen

Verwenden Sie in einer Kampagne oder einem Canvas-Schritt mit den SessionM-Angeboten Connected-Content, um einen API-Aufruf an den SessionM get_user_offers-Endpunkt zu tätigen.

Geben Sie in der Connected-Content-Anfrage die SessionM user_id der Nutzer:in und Ihre retailer_id an, um die vollständige Liste der aktiven Angebote abzurufen, die die Kund:in in ihrer Angebotsmappe hat. Jede Anfrage an diesen Endpunkt kann eine einzelne Nutzer:in enthalten. Wenden Sie sich an das SessionM-Team, um den kodierten String-Schlüssel für den Basic-Authorization-Header in Ihrem Connected-Content-Aufruf zu erhalten.

Im Anfrage-Body ist culture standardmäßig auf en-US eingestellt, aber Sie können Liquid verwenden, um die Sprache einer Nutzer:in für mehrsprachige SessionM-Angebote als Template einzusetzen (z. B. mit "culture":"{{${language}}}").

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{% capture postbody %}
{"retailer_id":"YOUR-RETAIL-ID","user_id":"{{${user_id}}}","skip":0,"take":1000,"include_pending_extended_data":false,"culture":"en-US"}
{% endcapture %}

{% connected_content
     {{endpoint_connect}}/offers/api/2.0/offers/get_user_offers
:method post
:headers {
       "Content-Type": "application/json",
       "Authorization": "Basic YOUR-BASE64-ENCODED-KEY"
  }
     :body {{postbody}}
     :save wallet
%}

3. Schritt: Angebotsmappe für Braze-Messaging befüllen

Nachdem eine Anfrage an den Endpunkt gestellt wurde, gibt SessionM die vollständige Liste der Angebote im ausgegebenen Zustand zurück, zusammen mit den vollständigen Details zu jedem Angebot. Dies ist ein Beispiel für eine zurückgegebene Antwort:

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
29
30
31
32
33
34
35
36
{
    "status": "ok",
    "payload": {
      "user": {
        "opted_in": false,
        "activated": false,
        ...
      },
      "user_id": "00000000-0000-0000-0000-000000000000",
      "user_offers": [
        {
          "offer_id": "1a2b3324-1da6-4e49-b921-afc386dabb60",
          "offer_group_id": "00000000-0000-0000-0000-000000000000",
          "offer_type": "manual_fulfillment",
          ...
        }
      ],
      "total_records": 1,
      "offer_groups": [
        {
          "id": "00000000-0000-0000-0000-000000000000",
          "name": "All Offers",
          "sort_order": 0
        }
      ],
      "offer_categories": [
        {
          "id": "9a82f973-aae6-4e10-839b-7117a852cf9e",
          "name": "All Offers",
          "sort_order": 0
        }
      ],
      "total_points": 1000,
      "available_points": 100
    }
}

Mit der Liquid-Dot-Notation kann dies in die Nachricht eingefügt werden. Um die Nachricht beispielsweise mit der resultierenden offer_id zu personalisieren, könnten Sie die Rückgabe-Payload nutzen, indem Sie {{wallet.payload.available_points}} verwenden, was 100 zurückgibt.

Hinweis

Dies ist eine individuelle API. Wenn Sie beabsichtigen, einen Batch von mehr als 500 Nutzer:innen zu versenden, erkundigen Sie sich bei Ihrem SessionM-Team, wie Sie Massendaten in die Integration einbeziehen können.

Getriggertes Messaging einrichten

Die Integration von SessionM und Braze ermöglicht es, Nutzerprofildaten, Angebotsdetails und Punktesalden dynamisch in Messaging einzubringen und in Echtzeit an die Kund:innen zu senden, sobald diese aktiv werden.

1. Schritt: SessionM Delivery-Team konfiguriert Templates

Arbeiten Sie mit Ihrem SessionM Delivery-Team zusammen, um Templates für die Verwendung in Ihren getriggerten Nachrichten zu entwickeln. SessionM fügt Nutzerprofildaten, Angebotsdetails und Punktesalden in das Messaging ein und triggert sie in Braze für Realtime-Nachrichten.

Zu den Standardfeldern in allen Templates von SessionM gehören:

• canvas_id
• campaign_id
• broadcast flag
• customer identifier
• email address

Hinweis

Wenn Sie das broadcast flag auf true setzen, wird die Nachricht an das gesamte Segment gesendet, auf das die Kampagne oder das Canvas in Braze abzielt.

Zusätzliche Felder können je nach Bedarf konfiguriert werden:

• Angebotsdaten: offer_id, offer title, user offer id, description, terms and conditions, logo, pos discount id, expiration date
• Punkteprämien-Daten: point award amount, point account name
• Ereignis-Trigger-Daten: Alle Daten im Trigger-Ereignis, die das Ergebnis des Trigger/Sende-Webhooks nutzen
• Kampagnenspezifische Daten: campaign runtime, campaign_id, campaign name, campaign custom data

Zusätzliche Felder werden als trigger_properties an Braze gesendet, um die Nachricht zu personalisieren.

2. Schritt: Braze-Kampagne oder Canvas erstellen

Erstellen Sie eine API-getriggerte Kampagne oder ein Canvas in Braze, das von SessionM getriggert werden kann. Wenn zusätzliche Felder konfiguriert wurden, wie offer_id oder offer title, verwenden Sie Liquid (z. B. {{api_trigger_properties.${offer_id}}}), um die personalisierten Felder in Ihre Nachrichten einzufügen.

Notieren Sie sich im Tab Zustellung planen die ID der Kampagne oder des Canvas, da diese zu den erweiterten Einstellungen der SessionM-Kampagne hinzugefügt wird.

Schließen Sie die Details Ihrer Kampagne oder Ihres Canvas ab und wählen Sie Starten.

3. Schritt: SessionM Werbe- oder Messaging-Kampagne erstellen

Erstellen Sie als Nächstes Ihre Kampagne in SessionM.

Aktualisieren Sie die erweiterten Einstellungen in der SessionM-Kampagne, um die folgende JSON-Payload einzuschließen, die die braze_campaign_id oder braze_canvas_id enthält.

1
2
3
4
{
"braze_campaign_id": "{{CAMPAIGN ID}}",
"braze_canvas_id": "{{CANVAS ID}}",
}

Erstellen Sie einen Nachrichten-Trigger nach dem gewünschten Zeitplan oder Verhalten. Wählen Sie dann im Menü External Message die Braze Messaging Variant als Messaging Variant aus, um das Template zu verwenden.

Dieses Template ruft die relevanten statischen und dynamischen Attribute ab und stellt eine Anfrage an den Braze-Endpunkt.