Trigger-Eigenschaften-Objekt

Wenn Sie einen der Endpunkte für den Versand einer Campaign mit API-getriggerter Zustellung verwenden, können Sie eine Zuordnung von Schlüsseln und Werten bereitstellen, um Ihre Nachricht anzupassen.

Wenn Sie eine API-Anfrage stellen, die ein Objekt in trigger_properties enthält, können die Werte in diesem Objekt dann in Ihrem Nachrichten-Template unter dem Namensraum api_trigger_properties referenziert werden. Eine Anfrage mit folgendem Inhalt könnte zum Beispiel das Wort "shoes" zu einer Nachricht hinzufügen, indem Sie {{api_trigger_properties.${product_name}}} einfügen.

Beachten Sie, dass Trigger-Eigenschaften zwar als Template in Nachrichten eingefügt werden können, aber standardmäßig nicht automatisch im Nutzerprofil gespeichert werden.

Hinweis

Das Objekt trigger_properties und die Syntax api_trigger_properties.${product_name} werden nur in Campaigns unterstützt. Um Nachrichten mit Schlüsseln und Werten aus einer API-Trigger-Anfrage für Canvas anzupassen, verwenden Sie das Canvas-Eingangs-Eigenschaften-Objekt. Das Objekt trigger_properties hat eine maximale Größe von 50 KB.

Objektkörper

Das Objekt trigger_properties unterstützt Strings, Zahlen, Booleans, Datumsangaben, Objekte und Arrays als Datentypen.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "trigger_properties" : {
    "product_name" : "shoes",
    "product_price" : 79.99,
    "details" : {
      "color" : "red",
      "size" : {
        "numerical" : 10,
        "country" : "US"
      }
    },
    "related_skus": ["123", "456", "789"]
  }
}

Beispiele für Liquid-Templates

Referenzieren Sie Trigger-Eigenschaften in Ihren Nachrichten-Templates mithilfe des api_trigger_properties-Namespace:

• Strings: {{api_trigger_properties.${product_name}}} gibt "shoes" zurück
• Zahlen: {{api_trigger_properties.${product_price}}} gibt 79.99 zurück
• Verschachtelte Objekte: {{api_trigger_properties.${details}.${color}}} gibt "red" zurück
• Array-Elemente: {{api_trigger_properties.${related_skus}[0]}} gibt "123" zurück