Developers » Piano Analytics Tagging » Marquer des événements » Envoyer des événements
Envoyer des événements
Ce guide n'est disponible que pour des analyses sur Piano Analytics
Veuillez vérifier le tableau de compatibilité
Avant-propos
Le Tracker dispose de méthodes techniques de marquage d’événements utiles pour compléter les fonctionnalités de base des SDK.
Ces méthodes sont disponibles pour les SDK :
- JavaScript à partir de la version
5.21.0- Android à partir de la version
2.17.0- Apple à partir de la version
2.18.0
Méthodes de marquage
Le Tracker expose des fonctions permettant l’envoi d’événements personnalisés :
tag.events.sendpour un envoi indépendant d’un événement,tag.events.addettag.dispatchpour un envoi groupé d’un événement avec d’autres marqueurs.
tracker.events.addettracker.dispatchpour un envoi groupé d’un événement avec d’autres marqueurs.
tracker.Events().addettracker.dispatchpour un envoi groupé d’un événement avec d’autres marqueurs.
send
events.send(name, data, options)
Envoyer un événement de façon indépendante.
| Param | Type | Description |
| name | string | Nom de l’événement |
| data | object | Contenu de l’événement |
| options | object | Eléments de configuration techniques du Tracker pour l’envoi |
Le paramètre
optionspermet de déclarer des propriétés utiles pour la gestion automatique des clics ou encore pour l’exécution automatique d’une méthode après envoi du hit.Il accepte donc trois propriétés telles que :
elemcorrespondant à l’élément du DOM marqué,eventcorrespondant à l’événement de clic,callbackcorrespondant à une fonction personnalisée à exécuter après envoi.
Exemple de marquage
tag.events.send('product.display',
{
'placement': 'homepage_slider',
'product': {
'id': 'id1',
'name': 'name1',
'brand': 'brand1',
'original_price': 16.50,
'price': 14.00,
'currency': 'EUR',
'stock': true,
'category1': 'category1',
'category2': 'category2',
'position': 1
}
},
{
elem: this, // (optional) Tagged DOM element
event: event, // (optional) JavaScript event (prevent event propagation)
callback: callback // (optional) function to execute
});
Pas d’équivalence.
Pas d’équivalence.
add / dispatch
events.add(name, data)
Ajouter un événement pour un envoi groupé.
| Param | Type | Description |
| name | string | Nom de l’événement |
| data | object | Contenu de l’événement |
Exemple de marquage
tag.page.set({'name': 'homepage'});
tag.events.add('product.display',
{
'placement': 'homepage_slider',
'product': {
'id': 'id1',
'name': 'name1',
'brand': 'brand1',
'original_price': 16.50,
'price': 14.00,
'currency': 'EUR',
'stock': true,
'category1': 'category1',
'category2': 'category2',
'position': 1
}
});
tag.dispatch();
events.add(name, data)
Ajouter un événement pour un envoi groupé.
| Param | Type | Description |
| name | String | Nom de l’événement |
| data | [String : Any] | Contenu de l’événement |
Exemple de marquage
tracker.screens.add("homepage")
_ = tracker.events.add(name: "product.display", data:
[
"placement": "homepage_slider",
"product":
[
"id": "id1",
"name": "name1",
"brand": "brand1",
"original_price": 16.50,
"price": 14.00,
"currency": "EUR",
"stock": true,
"category1": "category1",
"category2": "category2",
"position": 1
]
])
tracker.dispatch()
Events().add(name, dataObject)
Ajouter un événement pour un envoi groupé.
| Param | Type | Description |
| name | String | Nom de l’événement |
| dataObject | Map<String, Object> | Contenu de l’événement |
Exemple de marquage
tracker.Screens().add("homepage");
tracker.Events().add("product.display", new HashMap<String, Object>() {{
put("placement", "homepage_slider");
put("product", new HashMap<String, Object>() {{
put("id", "id1");
put("name", "name1");
put("brand", "brand1");
put("original_price", 16.50);
put("price", 14.00);
put("currency", "EUR");
put("stock", true);
put("category1", "category1");
put("category2", "category2");
put("position", 1);
}});
}});
tracker.dispatch();