Suivre les utilisateurs authentifiés avec Oracle Infinity sur le Web

Introduction

Ce tutoriel montre comment suivre les utilisateurs authentifiés sur votre site Web à l'aide d'Oracle Infinity avec la balise Oracle CX en ajoutant des paramètres de suivi au niveau de l'utilisateur à vos appels de suivi. Par exemple, la déclaration d'un ID client pour un utilisateur peut vous aider à attribuer un chiffre d'affaires par utilisateur à un site Web de commerce électronique ou à déclencher des actions sur des visiteurs authentifiés.

Objectifs

Les objectifs du tutoriel sont les suivants :

Prérequis

Voici les prérequis pour ce tutoriel :

Créer une balise (pour votre balise Oracle CX)

Vous devez avoir créé et configuré une balise pour votre site Web :

Vous disposez déjà d'une balise Oracle CX sur votre site Web ?

Si vous avez déjà créé une balise en cours d'utilisation sur votre site Web, vous n'avez pas besoin d'en créer une pour ce cas d'emploi. Vous devez vous assurer que (a) la balise existante a déjà été implémentée sur les pages requises ou (b) que vous devez créer une balise et implémenter sur les pages requises.

Etape 1 : Implémenter la balise Oracle CX sur vos pages

Si vous n'avez pas encore implémenté la balise CX sur les pages souhaitées, vous devez l'ajouter aux pages afin de charger la bibliothèque de balises CX afin de pouvoir lancer des demandes de suivi vers Oracle Infinity.

  1. Vous devez disposer d'une URL de balise conformément aux prérequis qui utiliseront le format suivant :

    //c.oracleinfinity.io/acs/account/{YOUR_ACCOUNT_GUID}/js/{YOUR_TAG_ID}/odc.js?_ora.config={_ora.config}

    GUID de compte, ID étiquette et configuration

    {Account GUID} identifie votre compte. Toutes vos balises utiliseront le même GUID de compte afin que toutes les données collectées pour votre compte soient stockées ensemble.

    {Tag ID} vous permet d'affecter des droits d'accès à vos balises Oracle Infinity et de les placer dans un format hiérarchique.

    {_ora.config} indique l'environnement vers lequel la balise pointe (par exemple, analytics:test pour vous permettre de pointer vers différentes configurations de balise par environnement, par exemple, test et production). Pour plus de détails, reportez-vous à Environnements.

  2. Implémentez le bloc de code suivant dans le fichier <head>* de toutes les pages à suivre (remplacement de {Account GUID}, {Tag ID} et {_ora.config} conformément à votre URL de balise). Par exemple :

    Implémentation synchrone

    <head>
...
<!-- CX Tag - Library Load -->
<script type="text/JavaScript" src="//c.oracleinfinity.io/acs/account/{Account GUID}/js/{Tag ID}/odc.js?_ora.config={_ora.config}"></script>
...
</head>

    Implémentation asynchrone

    	<head>
	...
	<script type="text/JavaScript">
	(function() {

	    var accountGUID = "{Account GUID}";
	    var tagID = "{Tag ID}";
	    var config = "{_ora.config}";

	    // DO NOT EDIT BELOW THIS LINE
	    for(var odc_requested=!1,scripts=document.getElementsByTagName("SCRIPT"),s=0;s<scripts.length;s++)scripts[s].src&&/oracleinfinity.*odc\.\js/.test(scripts[s].src)&&(odc_requested=!0);if(!odc_requested){var sc_scripts=document.getElementsByTagName("script")[0],sc=document.createElement("script");if(sc.async=!0,void 0===config)var config="";config&&(config="?_ora.config="+config),sc.src="//c.oracleinfinity.io/acs/account/"+accountGUID+"/js/"+tagID+"/odc.js"+config,sc_scripts.parentNode.insertBefore(sc,sc_scripts)}
	}());
	</script>
	...
	</head>

    *Synchrone ou Asynchrone ?

    Si vous prévoyez d'utiliser Oracle Maxymiser, vous devez implémenter ce paramètre dans <head> synchroniquement comme indiqué ci-dessus pour vous assurer que le contenu de la page peut être manipulé avant qu'il ne soit visible pour l'utilisateur. Toutefois, si vous n'utilisez pas Oracle Maxymiser, cela peut être asynchrone et pas nécessairement dans <head>.

    Si cela n'est pas possible, reportez-vous à la section Oracle Maxymiser CX Tag Guidelines ou contactez Oracle Consulting Services au sujet d'un engagement qui vous aidera à respecter vos exigences en matière de balisage pour une implémentation asynchrone.

Etape 2 : Déclaration des paramètres de niveau utilisateur dans vos appels de suivi

Lorsqu'un utilisateur s'est authentifié, vous pouvez ajouter des détails les concernant dans les appels de suivi nouveaux ou existants (par exemple, vous pouvez souhaiter afficher votre ID client pour chaque visiteur authentifié).

Paramètres disponibles

Vous devez déterminer les paramètres à envoyer à Oracle Infinity pour les ajouts de panier.

Vous trouverez ci-dessous un tableau des paramètres suggérés que vous pouvez envoyer pour les utilisateurs authentifiés :

Paramètres suggérés au niveau de l'utilisateur

Paramètre Nom du paramètre Exemple de valeur Notes
wt.dcsvid ID visiteur externe CUST123 Voir ci-dessous*
wt.customer_id ID client CUST123 Votre ID pour le client
wt.email Courriel stevie.nicks@oracle.com Adresse électronique brute
wt.e_id_s Adresse électronique (SHA-256 hachée) 9A0FF5B8ADEC41340B433CB2E343DA2DF0DFCBB7447301D97755B6568E41BB8B SHA-256 Adresse électronique hachée
wt.e_id_m Adresse électronique (MD5 haché) 0FED850BA5BC6D3A126270F5DFA43C15 Adresse électronique MD5-Hachage
wt.mobile_phone Numéro de téléphone mobile +447809839594 Numéro de téléphone non formaté
wt.riid ID du destinataire Responsys 564228225 ID destinataire Responsys
wt.customer_type Type de client Prime Type de client

*ID visiteur externe

Ce paramètre remplace l'ID visiteur par défaut généré par visiteur par Oracle Infinity. Pour plus de détails, voir ID visiteur externe.

Déclaration de paramètres

Une fois que vous avez choisi vos paramètres, vous pouvez les déclarer dans des appels nouveaux ou existants. Par exemple :

Exemple d'appel de vue pour un utilisateur authentifié sur une page d'accueil

(function(){
 
    // Declare Your Parameters
    var cxDataObject = {};
    cxDataObject["wt.page_name"] = "homepage"; // Custom parameter denoting page name
    cxDataObject["wt.customer_id"] = "EXAMPLECUSTOMERID123"; // Customer ID
    cxDataObject["wt.e_id_s"] = "9A0FF5B8ADEC41340B433CB2E343DA2DF0DFCBB7447301D97755B6568E41BB8B"; // SHA-256 hashed email address
    cxDataObject["wt.customer_type"] = "VIP Customer"; // Custom parameter denoting type of customer
     
    // DO NOT EDIT BELOW THIS LINE - ORA.click()
    window.ORA = window.ORA || {productReady: []};
    ORA.productReady.push(['analytics', function(cxDataObject) {return function() {return ORA.click({"data": cxDataObject})}}(cxDataObject)]);
})();

Etape 3 : test de la déclaration de vos paramètres

Une fois que vous avez déclaré les paramètres de niveau utilisateur, vous pouvez valider la demande en ouvrant le Débogueur réseau du chrome DevTools :

  1. Ouvrez le Débogueur réseau du chrome DevTools.
  2. Assurez-vous que vous êtes authentifié sur votre site (ou respectez les critères de déclaration des nouveaux paramètres).
  3. Actualisez la page.
  4. Filtre par dcs dans le débogueur.
  5. Sélectionnez la demande dcs.gif (appel de collecte de données Oracle Infinity).
  6. Affichez les paramètres envoyés.

Afficher votre appel de collecte de données Oracle Infinity

Afficher votre appel de collecte de données Oracle Infinity

Etape 4 : Vérifier qu'Oracle Infinity reçoit des données

Vous pouvez désormais Vérifier les données disponibles dans Oracle Infinity pour vos données d'achat conformément aux paramètres définis dans votre cliquez sur Appel au-dessus (par exemple, data.wt.customer_id).

Ressources de formation supplémentaires

Explorez d'autres exercices sur docs.oracle.com/learn ou accédez à davantage de contenu d'apprentissage gratuit sur le canal Oracle Learning YouTube. De plus, visitez le site education.oracle.com/learning-explorer pour devenir Oracle Learning Explorer.

Pour consulter la documentation du produit, consultez le centre d'aide Oracle.