SDK Piano Analytics
Avec le SDK Piano Analytics, vous avez la possibilité de marquer des propriétés personnalisées sans utiliser de méthode particulière compte tenu de l'approche par "Tag first" utilisée.
Vous avez donc la possibilité de marquer une propriété personnalisée de la façon suivante :
pa.sendEvent('page.display', {
'page':'pagename',
'custom_prop':'value'
})
Toutefois, il est possible que vous ayez besoin d'envoyer cette propriété sur plusieurs évènements de la même page. Dans ce cas, vous pouvez utiliser la méthode pa.setProperty.
Cette méthode permet d'ajouter une notion de persistance.
pa.setProperty('custom_prop', 'value', {
'persistent':true
});
pa.sendEvent('page.display', {
'page':'pagename'
})
Le paramètre persistent peut prendre la valeur "true" ce qui permet d'ajouter la propriété à tous les évènements suivants de la même page. Si ce paramètre prend la valeur "false", seul le prochain évènement appelé après la méthode sera enrichi avec la propriété personnalisée.
Vous avez la possibilité de définir quels évènements bénéficient de cette propriété personnalisée via le paramètre events.
pa.setProperty('custom_prop', 'value', {
'persistent':true,
'events': ['page.*', 'click.navigation']
});
Dans l'exemple ci-dessus, seuls les évènements commençant par "page." et les "click.navigation" seront alimentés avec la propriété "custom_prop".
Si vous souhaitez envoyer plusieurs propriétés via la méthode pa.setProperties, le fonctionnement est similaire.
Smarttag
La notion de persistance est également possible avec le smarttag via l'utilisation de la méthode setProp ou setProps pour l'envoi de plusieurs propriétés.
Vous trouverez ci-dessous un exemple pour la méthode setProp :
var tag = new ATInternet.Tracker.Tag();
tag.page.set({
name:'Article'
});
tag.setProp("article_ID": "1", true); // Persistent
tag.dispatch();
Dans l'exemple ci-dessus, l'ensemble des hits de la page seront enrichis avec la propriété "article_ID" avec valeur "1". Le paramètre de persistance étant à "True".
Cette méthode ne permet pas choisir quels sont les évènements sur lesquels cette méthode s'applique contrairement au SDK Piano Analytics et le paramètre event.