Personnaliser Guide Analytics à l'aide des API
Vous pouvez suivre le comportement du visiteur dans Guide en utilisant NiCE CXone Legacy Dashboard et en consultant les métriques Guide.
Utilisez les API suivantes pour définir des événements personnalisés, stocker des variables de visiteur, stocker des données de conversion, attribuer et supprimer des balises Web, et plus encore. Les événements personnalisés que vous envoyez avec Set Visitor Event sont sauvegardés avec vos autres données de visite Guide. Si vous utilisez Data Share, vous pouvez les trouver dans les vues d'activité de visite.
Définir un Événement propre au visiteur
Stocke le comportement du visiteur défini (événement) pour la génération de rapports. Guide ajoute custom. au début du nom de l'événement que vous envoyez. Lorsque cet appel est utilisé avec Guide, 'event_type' est remplacé par 'custom_event_type'. Remplacez 'custom_event_data' par un paramètre de données de tout type, y compris une structure d'objet.
cxone('analytics','setVisitorEvent', 'event_type', 'custom_event_data');
Conservez ces règles à l'esprit lorsque vous envoyez un événement personnalisé :
-
Conserver le nom de l’événement à 23 caractères ou moins. Avec custom. ajouté, le nom complet peut compter jusqu’à 30 caractères. Si le nom est plus long, Guide n’enregistre pas l’événement.
-
Vous pouvez envoyer du texte, une liste (tableau) ou un objet en tant que données d'événement. Le texte et les listes sont sauvegardés sous la forme { value: <your data> }. Les Objets sont sauvegardés tels que vous les envoyez. Si vous n'envoyez aucune donnée, Guide sauvegarde l'événement sans données.
Par exemple, cet appel enregistre la page que le visiteur a consultée :
cxone('analytics','setVisitorEvent', 'page_view', window.location.pathname);
Dans Data Share, chaque événement personnalisé apparaît dans la vue d'activité de visite avec le nom de l'événement dans CUSTOM_EVENT_Attribute_NAME et les données de l'Événement dans CUSTOM_EVENT_Attribute_VALUE. Pour plus de détails sur les colonnes, consultez la bibliothèque Data Share.
Définir la Variable propre au visiteur
Stocke les informations sur le visiteur définies pour la génération de rapports.
cxone('analytics','setVisitorVariable', 'variable_identifier', 'variable_value');
Stocker les conversions
Stocke le comportement du visiteur en tant que conversion pour la génération de rapports. Si le paramètre conversion_date est omis, la date et l'heure actuelles sont utilisées pour la conversion.
cxone('analytics','storeConversion', 'conversion_type', conversion_value, conversion_date);
Définissez-les comme suit :
-
Remplacez 'conversion_type' par une valeur telle que USD.
-
Remplacez conversion_value par une valeur numérique à utiliser dans les rapports Guide pour suivre l'efficacité des engagements.
-
Replace conversion_date avec un objet date JavaScript. En cas d'omission, new Date() est utilisé.
Assigner une balise à un internaute
Ajoute les balises spécifiées à un visiteur. Dans l'exemple de syntaxe suivant, remplacez tagID par une balise visiteur.
cxone('analytics','addVisitorTags', tagID);
Supprimer la balise d'un internaute
Supprime des balises spécifiques d’un visiteur. Dans l'exemple de syntaxe suivant, remplacez tagID par une balise de visiteur.
cxone('analytics','removeVisitorTags', [tagID, tagID]);
Effacer les données de visite
Supprime des informations concernant la visite en cours. La visite correspond à la session de navigation. Si l’utilisateur recharge une page, Guide considère cela comme une nouvelle visite.
cxone('analytics','clearVisit');
Définir le Pays
Permet de définir une valeur de pays personnalisée. La Saisie est une chaîne. Remplacez 'Country' par un code pays du navigateur.
cxone('analytics','setDeviceCountry','Country');
Définir l'Emplacement
Permet de définir une valeur d'emplacement personnalisée. La Saisie est une chaîne. Remplacez 'Location' par un code d'emplacement de navigateur.
cxone('analytics','setDeviceLocation','Location');
Désactiver la détection SPA
Désactive la détection automatique des applications à Page unique.
cxone('analytics', 'setSPADetection', false);
Page chargée
Permet à Guide de reconnaître qu’une page a été actualisée. Utilisé lorsque la détection de l'application monopage est désactivé. La Saisie est une chaîne. Remplacez 'page-url' par l'URL de la page ou remplacez 'page-title' par le titre de la page.
cxone('analytics', 'sendPageView', {url: 'page-url'});cxone('analytics', 'sendPageView', {title: 'page-title'});
Désactiver le suivi sur le Web
Désactive le module de suivi sur le Web.
cxone('disableModule', 'analytics');