Skip to content

Consigner un événement personnalisé

Découvrez comment enregistrer des événements personnalisés via le SDK de Braze.

Enregistrement d’un événement personnalisé

Pour enregistrer un événement personnalisé, utilisez la méthode d’enregistrement des événements suivante.

Pour une implémentation standard du SDK Web, vous pouvez utiliser la méthode suivante :

1

braze.logCustomEvent("YOUR_EVENT_NAME");

Si vous souhaitez utiliser Google Tag Manager à la place, vous pouvez utiliser le type d’étiquette Custom Event pour appeler la méthodelogCustomEvent et envoyer des événements personnalisés à Braze, en incluant éventuellement des propriétés d’événement personnalisées. Pour ce faire :

  1. Saisissez le nom de l’événement en utilisant une variable ou en tapant un nom d’événement.
  2. Utilisez le bouton Ajouter une ligne pour ajouter des propriétés d’événement.

Une boîte de dialogue affichant les paramètres de configuration de la balise d’action de Braze. Les paramètres inclus sont le « type de balise » (événement personnalisé), « nom d’événement » (clic de bouton) et les « propriétés de l’événement ».

Pour les versions natives d’Android, vous pouvez utiliser la méthode suivante :

1

Braze.getInstance(context).logCustomEvent(YOUR_EVENT_NAME);

1

Braze.getInstance(context).logCustomEvent(YOUR_EVENT_NAME)

1

AppDelegate.braze?.logCustomEvent(name: "YOUR_EVENT_NAME")

1

[AppDelegate.braze logCustomEvent:@"YOUR_EVENT_NAME"];

1

braze.logCustomEvent('YOUR_EVENT_NAME');

Si vous avez intégré des balises Infillion dans votre application Android, vous pouvez éventuellement utiliser visit.getPlace() pour enregistrer des événements spécifiques à l’emplacement/localisation. requestImmediateDataFlush vérifie que votre événement sera enregistré même si votre application est en arrière-plan.

1
2

Braze.getInstance(context).logCustomEvent("Entered " + visit.getPlace());
Braze.getInstance(context).requestImmediateDataFlush();

1
2

Braze.getInstance(context).logCustomEvent("Entered " + visit.getPlace())
Braze.getInstance(context).requestImmediateDataFlush()

1

Braze.logCustomEvent("YOUR_EVENT_NAME");

1

m.Braze.logEvent("YOUR_EVENT_NAME")

1

AppboyBinding.LogCustomEvent("YOUR_EVENT_NAME");

Ajouter des propriétés de métadonnées

Lorsque vous enregistrez un événement personnalisé, vous avez la possibilité d’ajouter des métadonnées sur cet événement personnalisé en transmettant un objet de propriétés avec l’événement. Les propriétés sont définies comme des paires clé-valeur. Les clés sont des chaînes de caractères et les valeurs peuvent être string, numeric, boolean, Date des objets, des tableaux ou des objets JSON imbriqués.

Pour ajouter des propriétés d’événement, utilisez la méthode d’enregistrement des événements suivante.

1
2
3
4
5
6
7
8
9
10

braze.logCustomEvent("YOUR-EVENT-NAME", {
  you: "can", 
  pass: false, 
  orNumbers: 42,
  orDates: new Date(),
  or: ["any", "array", "here"],
  andEven: {
     deeply: ["nested", "json"]
  }
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

Braze.logCustomEvent("YOUR-EVENT-NAME",
    new BrazeProperties(new JSONObject()
        .put("you", "can")
        .put("pass", false)
        .put("orNumbers", 42)
        .put("orDates", new Date())
        .put("or", new JSONArray()
            .put("any")
            .put("array")
            .put("here"))
        .put("andEven", new JSONObject()
            .put("deeply", new JSONArray()
                .put("nested")
                .put("json"))
        )
));

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

Braze.logCustomEvent("YOUR-EVENT-NAME",
    BrazeProperties(JSONObject()
        .put("you", "can")
        .put("pass", false)
        .put("orNumbers", 42)
        .put("orDates", Date())
        .put("or", JSONArray()
            .put("any")
            .put("array")
            .put("here"))
        .put("andEven", JSONObject()
            .put("deeply", JSONArray()
                .put("nested")
                .put("json"))
        )
))

1
2
3
4
5
6
7
8
9
10
11
12
13

AppDelegate.braze?.logCustomEvent(
  name: "YOUR-EVENT-NAME",
  properties: [
    "you": "can",
    "pass": false,
    "orNumbers": 42,
    "orDates": Date(),
    "or": ["any", "array", "here"],
    "andEven": [
      "deeply": ["nested", "json"]
    ]
  ]
)

1
2
3
4
5
6
7
8
9
10
11

[AppDelegate.braze logCustomEvent:@"YOUR-EVENT-NAME"
                       properties:@{
  @"you": @"can",
  @"pass": @(NO),
  @"orNumbers": @42,
  @"orDates": [NSDate date],
  @"or": @[@"any", @"array", @"here"],
  @"andEven": @{
    @"deeply": @[@"nested", @"json"]
  }
}];

1
2
3
4
5

braze.logCustomEvent('custom_event_with_properties', properties: {
    'key1': 'value1',
    'key2': ['value2', 'value3'],
    'key3': false,
});

1
2
3
4
5

Braze.logCustomEvent("custom_event_with_properties", {
    key1: "value1",
    key2: ["value2", "value3"],
    key3: false,
});

1

m.Braze.logEvent("YOUR_EVENT_NAME", {"stringPropKey" : "stringPropValue", "intPropKey" : Integer intPropValue})

1

AppboyBinding.LogCustomEvent("event name", properties(Dictionary<string, object>));

Bonnes pratiques

Il y a trois vérifications importantes à effectuer pour que vos propriétés d’événement personnalisé soient enregistrées comme prévu :

Plusieurs propriétés peuvent être consignées chaque fois qu’un événement personnalisé est journalisé.

Vérifier les événements

Vérifiez auprès de vos développeurs quelles propriétés d’événement sont suivies. Gardez à l’esprit que toutes les propriétés de l’événement sont sensibles à la casse. Pour plus d’informations sur le suivi des événements personnalisés, consultez ces articles en fonction de votre plateforme :

Vérifier le journal

Pour confirmer que les propriétés de l’événement sont bien suivies, vous pouvez afficher toutes les propriétés de l’événement à partir de la page Événements personnalisés.

  1. Sélectionnez Paramètres des données > Événements personnalisés.
  2. Emplacement/localisation de votre événement personnalisé dans la liste.
  3. Pour votre événement, sélectionnez Gérer les propriétés pour afficher les noms des propriétés associées à un événement.

Vérifier les valeurs

Après avoir ajouté votre utilisateur en tant qu’utilisateur test, suivez les étapes suivantes pour vérifier vos valeurs :

  1. Exécutez l’événement personnalisé dans l’application.
  2. Attendez environ 10 secondes pour que les données se déversent.
  3. Actualisez le journal des événements utilisateurs pour afficher l’événement personnalisé et la valeur de la propriété d’événement qui lui a été transmise.
Github   Modifier cette page sur GitHub
New Stuff!