Realice un seguimiento de los usuarios autenticados con Oracle Infinity en web.

Introducción

En este tutorial se mostrará cómo realizar un seguimiento de los usuarios autenticados en su sitio web mediante Oracle Infinity con Etiqueta CX de Oracle agregando parámetros de seguimiento a nivel de usuario a sus llamadas de seguimiento. Por ejemplo, declarar un ID de cliente para un usuario puede ayudarle a atribuir ingresos por usuario para un sitio web de comercio electrónico o activar Acciones a visitantes autenticados.

Objetivos

Los objetivos del tutorial son:

Requisitos

Consulte a continuación los requisitos para este tutorial:

Crear una etiqueta (para su etiqueta de Oracle CX)

Debe haber creado y configurado una etiqueta para su sitio web:

¿Ya tiene una etiqueta Oracle CX en su sitio web?

Si ya ha creado una etiqueta que está en uso en su sitio web, no necesita crear una nueva etiqueta específica para este caso de uso. Debe asegurarse de que (a) la etiqueta existente ya se haya implantado en las páginas necesarias o (b) debe crear una nueva etiqueta y implantarla en las páginas necesarias.

Paso 1: Implante la etiqueta Oracle CX en sus páginas

Si aún no ha implantado la etiqueta CX en las páginas deseadas, deberá agregarla a las páginas para cargar la biblioteca de etiquetas de CX, de modo que pueda iniciar solicitudes de seguimiento a Oracle Infinity.

  1. Debe tener una URL de etiqueta según los requisitos, que utilizará el siguiente formato:

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

    GUID de cuenta, ID de etiqueta y configuración

    {Account GUID} identifica la cuenta. Todas las etiquetas utilizarán el mismo GUID de cuenta para que todos los datos recopilados para la cuenta se almacenen juntos.

    {Tag ID} permite asignar derechos de acceso a las etiquetas de Oracle Infinity y ponerlas en un formato jerárquico.

    {_ora.config} indica el entorno al que apunta la etiqueta (por ejemplo, analytics:test para permitirle apuntar a diferentes configuraciones de etiquetas por Entorno, por ejemplo, Prueba y Producción). Consulte Entornos para obtener más información.

  2. Implante el siguiente bloque de código en <head>* de todas las páginas de las que realizará el seguimiento (sustituyendo {Account GUID}, {Tag ID} y {_ora.config} según la URL de etiqueta). Por ejemplo:

    Implementación síncrona

    <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>

    Implementación asíncrona

    	<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>

    *Síncrono o Asíncrono?

    Si va a utilizar Oracle Maxymiser, debe implantarlo en <head> de forma síncrona como se ha indicado anteriormente para asegurarse de que el contenido de la página se puede manipular antes de que sea visible para el usuario. Sin embargo, si no utiliza Oracle Maxymiser, puede ser asíncrono y no necesariamente en <head>.

    Si esto no es factible, consulte Oracle Maxymiser CX Tag Guidelines o póngase en contacto con Oracle Consulting Services para obtener un compromiso que le permita los requisitos de etiquetado para una implantación asíncrona.

Paso 2: Declaración de parámetros de nivel de usuario en las llamadas de seguimiento

Cuando un usuario se ha autenticado, puede agregar detalles sobre ellos en llamadas de seguimiento nuevas o existentes (por ejemplo, puede que desee mostrar el ID de cliente para cada visitante autenticado).

Parámetros disponibles

Debe decidir qué parámetros desea enviar a Oracle Infinity para las adiciones de carro.

A continuación, se muestra una tabla de parámetros sugeridos que puede enviar a los usuarios autenticados:

Parámetros sugeridos de nivel de usuario

Parámetro Nombre de parámetro Valor de ejemplo Notas
wt.dcsvid ID de visitante externo CUST123 Consulte abajo*
wt.customer_id ID de cliente CUST123 Su ID para el cliente
wt.email Dirección de correo electrónico stevie.nicks@oracle.com Dirección de correo electrónico raw
wt.e_id_s Dirección de correo electrónico (SHA-256 con hash) 9A0FF5B8ADEC41340B433CB2E343DA2DF0DFCBB7447301D97755B6568E41BB8B SHA-256 Dirección de correo electrónico con hash
wt.e_id_m Dirección de correo electrónico (con hash MD5) 0FED850BA5BC6D3A126270F5DFA43C15 Dirección de correo electrónico con hash MD5
wt.mobile_phone Número de Teléfono Móvil +447809839594 Número de teléfono sin formato
wt.riid ID de destinatario de Responsys (RIID) 564228225 ID de destinatario de Responsys
wt.customer_type Tipo de Cliente Prima Tipo de Cliente

*ID de visitante externo

Este parámetro sustituirá el ID de visitante por defecto generado por el visitante por Oracle Infinity. Consulte ID de visitante externo para obtener más información.

Declaración de parámetros

Una vez que haya seleccionado los parámetros, puede declararlos en llamadas nuevas o existentes. Por ejemplo:

Llamada de vista de muestra para usuario autenticado en una página inicial

(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)]);
})();

Paso 3: Pruebe que se declaran los parámetros

Una vez que haya declarado los parámetros de nivel de usuario, puede validar la solicitud abriendo el Depurador de red DevTools de cromo:

  1. Abra el Depurador de red DevTools cromado.
  2. Asegúrese de que está autenticado en su sitio (o cumple los criterios para declarar los nuevos parámetros).
  3. Refresque la página.
  4. Filtrar por dcs en el depurador.
  5. Seleccione la solicitud dcs.gif (esta es la llamada de recopilación de datos de Oracle Infinity).
  6. Visualice los parámetros que se están enviando.

Visualización de la llamada de recopilación de datos de Oracle Infinity

Visualización de la llamada de recopilación de datos de Oracle Infinity

Paso 4: Compruebe que Oracle Infinity está recibiendo datos

Ahora puede comprobar los datos disponibles en Oracle Infinity para los datos de compra según los parámetros definidos en la llamada de clic anterior (por ejemplo, data.wt.customer_id).

Más recursos de aprendizaje

Explore otras prácticas en docs.oracle.com/learn o acceda a contenido de aprendizaje más gratuito en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en un explorador de formación de Oracle.

Para obtener documentación sobre los productos, visite Oracle Help Center.