Nutzerprofildaten in Connected-Content-Aufrufen abrufen
Auf dieser Seite erfahren Sie, wie Sie Nutzerprofile in Ihre Connected-Content-Aufrufe einbinden und welche Best Practices für Liquid-Templating gelten.
Voraussetzungen
Wenn eine Connected-Content-Antwort Nutzerprofilfelder enthält (innerhalb eines Liquid-Personalisierungs-Tags), müssen diese Werte zuvor in der Nachricht mit Liquid definiert werden – und zwar vor dem Connected-Content-Aufruf –, damit der Liquid-Passback korrekt dargestellt wird. Ebenso muss das :rerender-Flag in der Anfrage enthalten sein. Beachten Sie, dass das :rerender-Flag nur eine Ebene tief wirkt, d. h. es wird nicht auf verschachtelte Connected-Content-Tags angewendet.
Liquid-Templating in Connected-Content-Aufrufen
Für die Personalisierung ruft Braze Nutzerprofilfelder ab, bevor dieses Feld an Liquid übergeben wird. Wenn die Antwort von Connected Content also Nutzerprofilfelder enthält, müssen diese vorher definiert werden.
Wenn dies beispielsweise der Connected-Content-Aufruf wäre:
Hi ${first_name},
{% connected_content https://examplewebsite.com :rerender %}
Die Connected-Content-Antwort ist Your language is ${language}. Der in diesem Beispiel angezeigte Inhalt ist Hi Jon, your language is.
Die Sprache selbst wird nicht als Template verarbeitet. Das liegt daran, dass Braze wissen muss, welche Felder von der Nutzerin oder dem Nutzer abgerufen werden sollen, bevor der Connected-Content-Aufruf erfolgt.
Um den Liquid-Passback korrekt darzustellen, müssen Sie das ${language}-Tag an einer beliebigen Stelle in der Anfrage einfügen, wie im folgenden Code-Snippet gezeigt. Der Liquid-Präprozessor erkennt dann, dass das Attribut „language“ abgerufen werden muss, damit es für das Templating der Antwort bereitsteht.
Hi ${first_name}, {% connected_content https://examplewebsite.com?language=${language} :rerender %}
Beachten Sie, dass die :rerender-Flag-Option nur eine Ebene tief wirkt. Wenn die Connected-Content-Antwort selbst weitere Connected-Content-Tags oder Katalog-Tags enthält, wird Braze diese zusätzlichen Tags nicht erneut rendern.
Best Practices
json_escape mit Liquid-Tags verwenden, die das JSON-Format beschädigen könnten
Wenn Sie :rerender verwenden, fügen Sie den json_escape-Filter zu jedem Liquid-Tag hinzu, das potenziell das JSON-Format beschädigen könnte. Wenn Ihre Liquid-Tags Zeichen enthalten, die das JSON-Format beschädigen, wird die gesamte Connected-Content-Antwort als Text interpretiert und in die Nachricht eingefügt, und keine der Variablen wird gespeichert.
Wenn beispielsweise die Ereigniseigenschaft message im folgenden Beispiel Zeichen enthält, die das JSON-Format beschädigen könnten, fügen Sie den json_escape-Filter wie in diesem Beispiel hinzu:
[{
"message":"{{event_properties.${message} | json_escape}}"
}]