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 - 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 modéliser des informations personnalisées dans les messages, déclencher l’envoi de messages et segmenter les utilisateurs.

Limites

• 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 suivantes du SDK prennent en charge les objets imbriqués :

Étape 1 : Générer 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. Allez dans 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èle liquide
• Envoi déclenché de messages
• 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": "McDonalds",
    "identifier": "12345678",
    "location" : {
      "city": "Montclair",
      "state": "NJ"
    }
  }
}
...

Modèle liquide

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

Envoi déclenché de messages

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. Après avoir 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. Cela permet d’ajouter des propriétés d’événement imbriquées après la génération d’un schéma.

!

Questions fréquemment posées

L’utilisation d’objets imbriqués permet-elle d’enregistrer des points de données supplémentaires ?

L’ajout de cette fonctionnalité ne modifie en rien la manière dont nous enregistrons les points de données. 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 demande dépassant cette limite sera rejetée.