Skip to content

Enregistrer des événements personnalisés

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

Pour les événements eCommerce recommandés, consultez Enregistrer des événements eCommerce.

Enregistrer un événement personnalisé

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

Pour un déploiement standard du SDK Web, vous pouvez utiliser la méthode suivante :

1

braze.logCustomEvent("YOUR_EVENT_NAME");

Si vous préférez utiliser Google Tag gestionnaire, vous pouvez utiliser le type d’étiquette Custom Event pour appeler la méthode logCustomEvent et envoyer des événements personnalisés à Braze, avec en option des propriétés d’événement personnalisées. Pour ce faire :

  1. Saisissez le Event Name en utilisant une variable ou en tapant un nom d’événement.
  2. Utilisez le bouton Add Row pour ajouter des propriétés d’événement.

Boîte de dialogue affichant les paramètres de configuration de l'étiquette d'action Braze. Les paramètres incluent « tag type » (custom event), « event name » (button click) et « event properties ».

Pour Android natif, 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');

Utilisez la méthode du plugin Braze Cordova :

1

BrazePlugin.logCustomEvent("YOUR_EVENT_NAME");

L’API logCustomEvent accepte :

  • eventName (chaîne de caractères requise) : utilisez jusqu’à 255 caractères. Ne commencez pas le nom par $. Utilisez des caractères alphanumériques et de la ponctuation.
  • eventProperties (objet optionnel) : ajoutez des paires clé-valeur pour les métadonnées de l’événement. Utilisez des clés de 255 caractères maximum et ne commencez pas les clés par $.

Pour les valeurs de propriété, utilisez string (jusqu’à 255 caractères), numeric, boolean, des tableaux ou des objets JSON imbriqués.

Pour les détails de déploiement, consultez le code source du SDK Braze Cordova :

Si vous avez intégré les Infillion Beacons dans votre application Android, vous pouvez éventuellement utiliser visit.getPlace() pour enregistrer des événements spécifiques à un emplacement. 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");

Ajout de propriétés de métadonnées

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

Pour ajouter des propriétés de métadonnées, utilisez la méthode d’enregistrement d’événement 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,
});

Enregistrez des custom events avec un objet de propriétés :

1
2
3
4
5

var properties = {};
properties["key1"] = "value1";
properties["key2"] = ["value2", "value3"];
properties["key3"] = false;
BrazePlugin.logCustomEvent("YOUR-EVENT-NAME", properties);

Vous pouvez également transmettre les propriétés en ligne :

1
2
3
4

BrazePlugin.logCustomEvent("YOUR-EVENT-NAME", {
  "key": "value",
  "amount": 42,
});

L’application exemple officielle Cordova inclut des propriétés de type chaîne de caractères, numérique, booléen, tableau et objet imbriqué :

Extrait du projet exemple :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

var properties = {};
properties["One"] = "That's the Way of the World";
properties["Two"] = "After the Love Has Gone";
properties["Three"] = "Can't Hide Love";
BrazePlugin.logCustomEvent("cordovaCustomEventWithProperties", properties);
BrazePlugin.logCustomEvent("cordovaCustomEventWithoutProperties");
BrazePlugin.logCustomEvent("cordovaCustomEventWithFloatProperties", {
  "Cart Value": 4.95,
  "Cart Item Name": "Spicy Chicken Bites 5 pack"
});
BrazePlugin.logCustomEvent("cordovaCustomEventWithNestedProperties", {
  "array key": [1, "2", false],
  "object key": {
    "k1": "1",
    "k2": 2,
    "k3": false,
  },
  "deep key": {
    "key": [1, "2", true]
  }
});

Pour plus de détails sur l’API et le pont natif, consultez :

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 vous assurer que vos propriétés d’événement personnalisé sont enregistrées comme prévu :

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

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 d’é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 d’événement sont correctement suivies, vous pouvez consulter toutes les propriétés d’événement depuis la page Custom Events.

  1. Accédez à Data Settings > Custom Events.
  2. Localisez votre événement personnalisé dans la liste.
  3. Pour votre événement, sélectionnez Manage Properties 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 ces étapes pour vérifier vos valeurs :

  1. Effectuez l’événement personnalisé dans l’application.
  2. Attendez environ 10 secondes pour que les données soient transmises.
  3. Actualisez le journal des événements utilisateurs pour voir l’événement personnalisé et la valeur de la propriété d’événement qui a été transmise avec.

Résolution des problèmes liés aux événements personnalisés

Utilisez ces scénarios pour résoudre les problèmes de journalisation des événements personnalisés dans les différents SDK.

Vérifier le déclencheur de l’événement personnalisé

Si un événement personnalisé n’apparaît pas, il se peut que l’action suivie dans votre application ne corresponde pas à l’action que vous testez.

  • Confirmez avec votre équipe de développement quelle action de l’application déclenche l’événement personnalisé.
  • Vérifiez s’il existe des chemins de code obsolètes après les mises à jour du SDK, tels que des références à appboy au lieu de braze.

Les événements personnalisés sont enregistrés sur un profil anonyme

Si vous n’identifiez pas un utilisateur avant de journaliser un événement personnalisé, Braze peut associer cet événement à un profil anonyme.

  • Appelez changeUser() avant d’effectuer l’événement personnalisé afin que Braze l’enregistre sur un profil utilisateur identifié.
  • Testez avec un utilisateur test identifié, puis consultez le journal des événements utilisateurs.

Vérifier la configuration de la journalisation des événements personnalisés

Si les événements personnalisés n’apparaissent pas comme prévu, confirmez que votre équipe de développement a implémenté la journalisation des événements personnalisés pour la bonne action de l’application.

  • Demandez à votre équipe de développement de vérifier que l’événement est correctement journalisé et déclenché par l’action utilisateur attendue.
  • Lorsque votre équipe ouvre un ticket auprès du support Braze, incluez les logs détaillés et les extraits de code pertinents.
  • Si votre application utilise Swift ou Android, votre équipe de développement peut utiliser les prérequis du débogueur SDK pour générer des logs détaillés.
  • Si votre équipe de développement ne parvient pas à identifier le problème, ouvrez un ticket auprès du support Braze.
New Stuff!