Objets imbriqués dans les événements personnalisés

Cette page explique comment envoyer des données JSON imbriquées en tant que propriétés d’événements personnalisés et d’achats, et comment utiliser ces objets imbriqués dans votre envoi de messages.

Vous pouvez utiliser des objets imbriqués (c.-à-d. des objets qui se trouvent à l’intérieur d’un autre objet) pour envoyer des données JSON imbriquées en tant que propriétés d’événements personnalisés et d’achats. Ces données imbriquées peuvent être utilisées pour créer des modèles d’informations personnalisées dans les messages, déclencher l’envoi de messages et segmenter les utilisateurs.

Restrictions

• Les données imbriquées sont prises en charge pour les événements personnalisés et les événements d’achat, mais pas pour les autres types d’événements.
• Les objets de propriété d’événement qui contiennent des valeurs de tableau ou d’objet peuvent avoir une charge utile de propriété d’événement allant jusqu’à 100 Ko.
• Les schémas de propriétés d’événement ne peuvent pas être générés pour les propriétés d’achat.
• Les schémas de propriétés d’événements sont générés par l’échantillonnage des événements personnalisés des dernières 24 heures.

Versions minimales du SDK

Les versions SDK suivantes prennent en charge les objets imbriqués :

Étape 1 : Générez un schéma

Vous pouvez accéder aux données imbriquées dans votre événement personnalisé en générant un schéma pour chaque événement avec des propriétés d’événement imbriqué. Pour générer un schéma :

1. Sélectionnez Paramètres des données > Événements personnalisés.
2. Sélectionnez Gérer les propriétés pour les événements comportant des propriétés imbriquées.
3. Sélectionnez le bouton pour générer le schéma. Pour visualiser le schéma, sélectionnez le bouton plus.

Si de nouvelles propriétés sont envoyées à l’avenir, elles ne figureront pas dans le schéma tant qu’il n’aura pas été régénéré. Les schémas peuvent être régénérés toutes les 24 heures.

Étape 2 : Utiliser l’objet imbriqué

Vous pouvez faire référence aux données imbriquées lors de la segmentation et de la personnalisation. Notez qu’un schéma n’est pas nécessaire. Vous trouverez des exemples d’utilisation dans les sections suivantes :

• Corps de la requête API
• Modèles Liquid
• Déclenchement du message
• Segmentation
• Personnalisation

Corps de la requête API

• music example
• restaurant example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
...
"properties": {
  "songs": [
    {
      "title": "Smells Like Teen Spirit",
      "artist": "Nirvana",
      "album": {
        "name": "Nevermind",
        "yearReleased": "1991"
      }
    },
    {
      "title": "While My Guitar Gently Weeps",
      "artist": "the Beatles",
      "album": {
        "name": "The Beatles",
        "yearReleased": "1968"
      }
    }
  ]
}
...

1
2
3
4
5
6
7
8
9
10
11
12
...
"properties": {
  "r_details": {
    "name": "SandwichEmperor",
    "identifier": "12345678",
    "location" : {
      "city": "Montclair",
      "state": "NJ"
    }
  }
}
...

Modèles Liquid

L’exemple suivant montre comment créer un modèle Liquid qui fait référence aux propriétés imbriquées demandées dans la requête API précédente.

• music example
• restaurant example

Déclenchement du message

Pour utiliser ces propriétés afin de déclencher une campagne, sélectionnez votre événement personnalisé ou votre achat, puis ajoutez un filtre de propriétés imbriquées. Notez que le déclenchement des messages n’est pas encore pris en charge pour les messages in-app, mais les propriétés imbriquées dans la personnalisation Liquid dans les messages s’afficheront toujours.

• music example
• restaurant example

Segmentation

Pour segmenter les utilisateurs en fonction des propriétés d’événements imbriqués, vous devez utiliser les extensions de segments. Une fois que vous avez généré un schéma, l’explorateur d’objets imbriqués s’affiche dans la section Segmentation.

La segmentation utilise la même notation que le déclenchement (voir Déclenchement des messages).

Pour modifier ou créer des extensions de segments, vous devez disposer de l’autorisation “Modifier les segments”.

Personnalisation

Dans la fenêtre modale/boîte de dialogue Ajouter une personnalisation, sélectionnez Propriétés d’événement avancées comme type de personnalisation. Ceci permet d’ajouter des propriétés d’événements imbriqués après la génération d’un schéma.

Test des objets imbriqués dans les messages

L’outil de test de &prévisualisation du tableau de bord ne prend pas en charge l’ajout de données fictives pour les objets imbriqués ou les attributs personnalisés imbriqués. Pour tester les messages qui font référence à des données imbriquées via Liquid, vous pouvez prévisualiser les messages avec des attributs imbriqués en tant qu’utilisateur existant disposant de cet attribut imbriqué, ou prévisualiser les messages avec des propriétés d’événement personnalisées en lançant une campagne en ligne pour tester les utilisateurs.

Attributs personnalisés imbriqués

1. Veuillez importer les attributs imbriqués dans le profil utilisateur test via l’API.
2. Dans votre campagne ou votre canvas, veuillez vous rendre dans Aperçu& Test.
3. Veuillez sélectionner « Aperçu en tant qu’utilisateur » et effectuer la recherche d’utilisateurs pour trouver l’utilisateur test. Le Liquid sera résolu en utilisant les attributs imbriqués réels du profil utilisateur.

Propriétés d’événement imbriquées

Les propriétés de l’événement imbriqué ne peuvent pas être prévisualisées dans le tableau de bord, car elles nécessitent un déclencheur d’événement en ligne/en production/instantané. Pour tester :

1. Créez une campagne ou une étape du canvas qui cible uniquement vos utilisateurs test et qui est déclenchée par (ou fait référence à) l’événement personnalisé avec des propriétés imbriquées.
2. Veuillez lancer la campagne auprès de votre audience test.
3. Enregistrez l’événement personnalisé avec la charge utile de l’objet imbriqué dans le profil utilisateur test (à l’aide de l’API ou du SDK).
4. Veuillez vérifier que le message s’affiche correctement avec les valeurs de propriété imbriquées.

Foire aux questions

L’utilisation d’objets imbriqués entraîne-t-elle l’enregistrement de points de données supplémentaires ?

L’ajout de cette fonctionnalité n’entraîne aucun changement dans la manière dont nous enregistrons les points de donnée. La segmentation basée sur des objets imbriqués utilise les extensions de segments, qui n’utilisent pas de points de données supplémentaires.

Combien de données imbriquées peuvent être envoyées ?

Si une ou plusieurs propriétés de l’événement contiennent des données imbriquées, la charge utile maximale pour toutes les propriétés combinées d’un événement est de 100 Ko. Toute requête dépassant cette limite de taille sera rejetée.