Objet Propriétés du déclencheur

Lorsque vous utilisez l’un des endpoints pour envoyer une Campaign avec une réception déclenchée par API, vous pouvez fournir un mappage de clés et de valeurs pour personnaliser votre message.

Si vous effectuez une requête API contenant un objet dans trigger_properties, les valeurs de cet objet peuvent alors être référencées dans votre modèle de message sous l’espace de noms api_trigger_properties. Par exemple, une requête contenant les éléments suivants pourrait ajouter le mot "shoes" à un message en ajoutant {{api_trigger_properties.${product_name}}}.

Notez que si les propriétés de déclencheur peuvent être intégrées dans les messages, elles ne sont pas automatiquement stockées dans le profil utilisateur par défaut.

Remarque

L’objet trigger_properties et la syntaxe api_trigger_properties.${product_name} ne sont pris en charge que dans les Campaigns. Pour personnaliser les messages avec des clés et des valeurs provenant d’une requête de déclenchement par API pour Canvas, utilisez l’objet de propriétés d’entrées Canvas. La taille maximale de l’objet trigger_properties est de 50 ko.

Corps de l’objet

L’objet trigger_properties prend en charge les chaînes de caractères, les nombres, les booléens, les dates, les objets et les tableaux comme types de données.

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"]
  }
}

Exemples de modèles Liquid

Référencez les propriétés de déclencheur dans vos modèles de message en utilisant l’espace de noms api_trigger_properties :

• Chaînes de caractères : {{api_trigger_properties.${product_name}}} renvoie "shoes"
• Nombres : {{api_trigger_properties.${product_price}}} renvoie 79.99
• Objets imbriqués : {{api_trigger_properties.${details}.${color}}} renvoie "red"
• Éléments de tableau : {{api_trigger_properties.${related_skus}[0]}} renvoie "123"