Profildaten im Canvas vor dem Senden aktualisieren

Wenn eine Journey Tage oder Wochen dauert, können sich Profildaten ändern, nachdem Nutzer:innen das Canvas betreten haben. Verwenden Sie einen Context-Schritt, um das passende Objekt im Profil nachzuschlagen, und verzweigen Sie dann das Messaging mit Zielgruppenpfaden oder Decision-Split.

Über dieses Beispiel

ClaimsJumpr, eine fiktive Versicherungsmarke, startet ein aktionsbasiertes Canvas, wenn eine Richtlinie noch 28 Tage bis zur Verlängerung hat. Während dieser 28 Tage sendet ClaimsJumpr mehrere Erinnerungen. Versicherungsnehmer:innen können die automatische Verlängerung dieser Richtlinie nach dem Entry ändern. Nachrichten, die nur Canvas-Entry-Eigenschaften verwenden, können daher einen falschen Status beschreiben.

Jedes Nutzerprofil speichert Richtlinien als angepasstes Attribut vom Typ Array von Objekten (policies). Jedes Objekt enthält eine eindeutige policy_id aus dem auslösenden Event sowie einen auto_renewal-Wert (opted_in oder opted_out). In diesem Beispiel wird vor späteren Nachrichten-Schritten ein Kontext-Schritt eingefügt, damit Liquid das aktuelle Objekt aus policies ausliest. Dabei wird die policy_id aus dem Canvas-Kontext (dem Entry-Event) abgeglichen.

Dieses Szenario:

1. Behält die policy_id aus dem Entry im Canvas-Kontext bei.
2. Verwendet einen Kontext-Schritt und den Liquid-Filter where, um das passende Objekt aus policies auszuwählen.
3. Speichert auto_renewal als Kontextvariable (auto_renewal) vom Typ String.
4. Steuert die Texte über Kontextvariablen-Filter in Zielgruppenpfaden oder Decision-Splits und nicht über dupliziertes Abbruch-Liquid in diesem Artikel.

Überlegungen

• Testen Sie das Canvas in einem Workspace außerhalb der Produktionsumgebung, auch mit Profilen, bei denen auto_renewal in einem Objekt fehlt.
• Die policy_id-Werte in policies sollten eindeutig sein, damit where genau ein Objekt zurückgibt.
• Wenn ein anderes Canvas mit einem Nutzer-Update-Schritt policies auf Basis desselben Trigger-Events schreibt, ist das Profil vor der ersten Nachricht möglicherweise noch nicht aktualisiert. Verwenden Sie für den ersten Nachrichten-Schritt nach dem Entry die Eigenschaften des Entry-Kontexts. Nutzen Sie diesen Kontext-Schritt für spätere Schritte, wenn das Profil-Update genug Zeit hatte, wirksam zu werden.
• Namen von Kontextvariablen bestehen nur aus Buchstaben, Zahlen und Unterstrichen (bis zu 100 Zeichen). Sie können bis zu 10 Variablen pro Kontext-Schritt definieren.
• Das Liquid in diesem Artikel ist ein Beispiel. Prüfen Sie Nutzerpfade in der Vorschau und führen Sie Testversendungen für Ihre eigenen Attributnamen und -werte durch.

Einrichtung

Dieses Beispiel setzt Folgendes voraus:

Schritt 1: Kontext-Schritt vor späteren Nachrichten platzieren

Fügen Sie im Canvas einen Kontext-Schritt unmittelbar vor den Nachrichten-Schritten ein, die den aktuellen Status der automatischen Verlängerung widerspiegeln müssen. Verlassen Sie sich bei diesen späteren Versendungen nicht allein auf Entry-Eigenschaften.

Schritt 2: Kontextvariable definieren

Im Kontext-Schritt:

1. Setzen Sie Name der Kontextvariable auf auto_renewal.
2. Setzen Sie den Datentyp auf String.
3. Geben Sie Liquid ein, das die passende Richtlinie auswählt und anschließend auto_renewal ausgibt. Umschließen Sie die Quelle von assign nicht mit zusätzlichen {{ }}-Tags.

1
2

{% assign matched_policies = custom_attribute.${policies} | where: "policy_id", context.${policy_id} %}
{{ matched_policies[0].auto_renewal }}

context.${policy_id} ist die Eigenschaft des Entry-Events, die als Kontextvariable verfügbar ist. where behält Objekte, deren policy_id mit diesem Wert übereinstimmt. Der Kontext-Schritt speichert das Feld auto_renewal des ersten Treffers.

4. Wählen Sie Vorschau aus und bestätigen Sie den Wert für eine:n Testnutzer:in, der oder die diese policy_id in policies hat.

Informationen zu Name, Typ und Liquid-Grenzen finden Sie unter Kontext und Kontextvariablen.

Schritt 3: Anhand der Kontextvariable verzweigen

Teilen Sie Nutzer:innen nach dem Kontext-Schritt mit einem Filter in Zielgruppenpfaden oder einem Decision-Split auf auto_renewal auf (zum Beispiel gleich opted_in gegenüber opted_out). Platzieren Sie die passende Erinnerung auf jedem Pfad.

Tipp

Informationen zur Einrichtung von Filtern und zum Abgleich von Datentypen finden Sie unter Filter für Kontextvariablen. Wie Gruppen ausgewertet werden, erfahren Sie unter Zielgruppenpfade und Decision-Split.

Wenn Sie einen Versand in einem Nachrichten-Schritt abbrechen, statt zu verzweigen, gelangen Nutzer:innen trotzdem zum nächsten Canvas-Schritt. Weitere Informationen finden Sie unter Nachrichten abbrechen und Wie Nutzer:innen voranschreiten.

Schritt 4: Vorschau und Test

Verwenden Sie die Vorschau von Nutzerpfaden und Testversendungen für:

• auto_renewal mit opted_in und opted_out im passenden Objekt
• Eine policy_id, die nicht in policies enthalten ist (leerer Kontextwert)
• Ein Objekt, in dem auto_renewal fehlt

Vergewissern Sie sich, dass spätere Erinnerungen mit dem Profil übereinstimmen und nicht nur mit dem Status beim Canvas-Entry.

Verwandte Artikel

• Kontext
• Kontextvariablen
• Canvas-Entry-Eigenschaften
• Zielgruppenpfade
• Decision-Split
• Nachricht-Schritt
• Nachrichten abbrechen
• Array von Objekten
• Nutzer-Update