Persistente Entry-Eigenschaften
Wenn ein Canvas durch ein angepasstes Event, einen Kauf oder einen API-Aufruf getriggert wird, können Sie Metadaten aus dem API-Aufruf, dem angepassten Event oder dem Kauf-Event zur Personalisierung in jedem Schritt Ihres Canvas-Workflows verwenden. Sie können diese Eigenschaften nutzen, um besser kuratierte Nachrichten zu senden.
Persistente Entry-Eigenschaften sind ein Artefakt des ursprünglichen Canvas-Editors, daher gibt es veraltete Verweise auf Begriffe wie Canvas-Entry-Eigenschaften, die aus historischen Gründen bestehen bleiben. Für den aktuellen Canvas-Editor lesen Sie Kontext- und Event-Eigenschaften.
Um persistente Entry-Eigenschaften im aktuellen Canvas-Editor zu verwenden, müssen Sie entweder einen neuen Canvas erstellen oder einen bestehenden in den aktuellen Editor Klon.
Entry-Eigenschaften verwenden
Entry-Eigenschaften können in aktionsbasierten und API-getriggerten Canvases verwendet werden. Diese Entry-Eigenschaften werden definiert, wenn ein Canvas durch ein angepasstes Event, einen Kauf oder einen API-Aufruf getriggert wird. Weitere Informationen finden Sie in den folgenden Artikeln:
Eigenschaften, die von diesen Objekten übergeben werden, können über den Liquid-Tag canvas_entry_properties referenziert werden. Beispielsweise könnte eine Anfrage mit "canvas_entry_properties": {"product_name": "shoes", "product_price": 79.99} das Wort „shoes“ zu einer Nachricht hinzufügen, indem der Liquid-Code {{canvas_entry_properties.${product_name}}} verwendet wird.
Wenn ein Canvas eine Nachricht mit dem Liquid-Tag canvas_entry_properties enthält, werden die mit diesen Eigenschaften verknüpften Werte für die Dauer der Journey der Nutzer:innen im Canvas gespeichert und gelöscht, wenn die Nutzer:innen das Canvas verlassen. Beachten Sie, dass Canvas-Entry-Eigenschaften nur zur Referenzierung in Liquid verfügbar sind. Um innerhalb des Canvas nach den Eigenschaften zu filtern, verwenden Sie stattdessen die Event-Eigenschafts-Segmentierung.
Das Canvas-Entry-Eigenschaften-Objekt hat eine maximale Größenbeschränkung von 50 KB.
Canvas aktualisieren, um Entry-Eigenschaften zu verwenden
Wenn ein aktives Canvas, das zuvor keine Nachrichten mit canvas_entry_properties enthielt, so bearbeitet wird, dass es canvas_entry_properties enthält, ist der Wert, der dieser Eigenschaft entspricht, für Nutzer:innen, die das Canvas betreten haben, bevor canvas_entry_properties zum Canvas hinzugefügt wurde, nicht verfügbar. Die Werte werden nur für Nutzer:innen gespeichert, die das Canvas nach der Änderung betreten.
Wenn Sie beispielsweise ein Canvas, das keine Entry-Eigenschaften verwendete, ursprünglich am 3. November gestartet und dann am 11. November eine neue Eigenschaft product_name zum Canvas hinzugefügt haben, werden Werte für product_name nur für Nutzer:innen gespeichert, die das Canvas ab dem 11. November betreten haben.
Falls eine Canvas-Entry-Eigenschaft null oder leer ist, können Sie Nachrichten mithilfe von Bedingungen abbrechen. Das folgende Code-Snippet ist ein Beispiel dafür, wie Sie Liquid verwenden können, um eine Nachricht abzubrechen.
1
2
3
{% if canvas_entry_properties.${product_name} == blank %}
{% abort_message() %}
{% endif %}
Weitere Informationen zum Abbrechen von Nachrichten mit Liquid finden Sie in unserer Liquid-Dokumentation.
Globale Canvas-Entry-Eigenschaften
Mit canvas_entry_properties können Sie globale Eigenschaften festlegen, die für alle Nutzer:innen gelten, oder nutzerspezifische Eigenschaften, die nur für die angegebenen Nutzer:innen gelten. Die nutzerspezifische Eigenschaft hat für diese:n Nutzer:in Vorrang vor der globalen Eigenschaft.
Beispielanfrage
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
curl -X POST \
-H 'Content-Type: application/json' \
-d '{
"api_key": "a valid rest api key",
"canvas_id": "the ID of your Canvas",
"canvas_entry_properties": {
"food_allergies": "none"
},
"recipients": [
{
"external_user_id": "Customer_123",
"canvas_entry_properties": {
"food_allergies": ["dairy", "soy"],
"nutrition": {
"calories_per_serving": 200,
"serving_size_in_ounces": 4
}
}
}
]
}'
In dieser Anfrage ist der globale Wert für „food allergies“ gleich „none“. Für Customer_123 ist der Wert „dairy“. Nachrichten in diesem Canvas, die das Liquid-Snippet {{canvas_entry_properties.${food_allergies}}} enthalten, werden für Customer_123 mit „dairy“ und für alle anderen mit „none“ gerendert.
Anwendungsfall
Wenn Sie ein Canvas haben, das ausgelöst wird, wenn Nutzer:innen einen Artikel auf Ihrer E-Commerce-Website ansehen, ihn aber nicht in den Warenkorb legen, könnte der erste Schritt des Canvas eine Push-Benachrichtigung sein, in der gefragt wird, ob Interesse am Kauf des Artikels besteht. Sie könnten den Produktnamen referenzieren, indem Sie {{canvas_entry_properties.${product_name}}} verwenden.
Der zweite Schritt könnte eine weitere Push-Benachrichtigung senden, die Nutzer:innen zum Bezahlen auffordert, wenn sie den Artikel in den Warenkorb gelegt, aber noch nicht gekauft haben. Sie können weiterhin auf die Entry-Eigenschaft product_name verweisen, indem Sie {{canvas_entry_properties.${product_name}}} verwenden.
Fehlerbehebung
Entry-Eigenschaften sind leer bei mehreren Entry-Triggern
Braze speichert canvas_entry_properties von dem Trigger, der diese:n Nutzer:in in den Canvas geführt hat, nicht von jedem auf dem Canvas konfigurierten Trigger. Wenn dieser Trigger kein Event oder API-Payload hat – zum Beispiel Sitzung starten oder Angepassten Attributwert ändern – ist Liquid canvas_entry_properties für diese Journey leer. Nutzer:innen, die denselben Canvas über ein angepasstes Event, einen Kauf oder einen API-Aufruf betreten, verfügen weiterhin über die Eigenschaften aus diesem Payload.
Um Entry-Eigenschaften für alle Nutzer:innen befüllt zu halten, verwenden Sie nur Entry-Typen, die diese Eigenschaften übergeben (angepasstes Event, Kauf oder API-getriggert). Für die Personalisierung im aktuellen Canvas-Editor verwenden Sie Kontext- und Event-Eigenschaften. Um nach Eigenschaften zu filtern, nutzen Sie die Event-Eigenschaften-Segmentierung anstelle von Liquid canvas_entry_properties.