Rastrear usuários autenticados com o Oracle Infinity na Web

Introdução

Este tutorial demonstrará como rastrear usuários autenticados no seu site usando o Oracle Infinity com a Tag do Oracle CX adicionando parâmetros de rastreamento no nível do usuário às suas chamadas de rastreamento. Por exemplo, declarar um ID de cliente para um usuário pode ajudá-lo a atribuir receita por usuário para um site de e-commerce ou acionar Ações contra visitantes autenticados.

Objetivos

Os objetivos do tutorial são:

Pré-requisitos

Veja abaixo os pré-requisitos deste tutorial:

Crie uma Tag (para sua Tag do Oracle CX)

Você deve ter criado e configurado uma tag para seu site:

Já tem uma tag Oracle CX em seu site?

Se você já tiver criado uma tag que esteja sendo usada no seu site, não será necessário criar uma nova tag específica para este caso de uso. Certifique-se de que (a) a tag existente já tenha sido implementada na(s) página(s) necessária(s) ou (b) você deve criar uma nova tag e implementar esta na(s) página(s) necessária(s).

Etapa 1: Implementar a Tag do Oracle CX em sua(s) página(s)

Se você ainda não tiver implementado a Tag CX em sua(s) página(s) desejada(s), será necessário adicioná-la à(s) página(s) para carregar a Biblioteca de Tags CX para que você possa iniciar solicitações de rastreamento no Oracle Infinity.

  1. Você deve ter um URL de Tag de acordo com os pré-requisitos que usarão o seguinte formato:

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

    GUID, ID da Tag e Configuração da Conta

    {Account GUID} identifica sua conta. Todas as tags usarão o mesmo GUID de conta para que todos os dados coletados para sua conta sejam armazenados juntos.

    {Tag ID} permite que você designe direitos de acesso às Tags do Oracle Infinity e as coloque em um formato hierárquico.

    {_ora.config} denota para qual Ambiente a tag está apontando (por exemplo, analytics:test para permitir que você aponte para diferentes configurações de tag por Ambiente, por exemplo, Teste e Produção). Consulte Ambientes para obter mais detalhes.

  2. Implemente o bloco de código a seguir no <head>* de todas as páginas que você rastreará (substituindo {Account GUID}, {Tag ID} e {_ora.config} de acordo com seu URL de Tag). Por exemplo:

    Implementação 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>

    Implementação Assí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>

    *Sincronizado ou Assíncrono?

    Se você estiver usando o Oracle Maxymiser, deverá implementá-lo no <head> sincronamente conforme acima para garantir que o conteúdo da página possa ser manipulado antes de ser visível para o usuário. No entanto, se você não estiver usando o Oracle Maxymiser, isso poderá ser assíncrono e não necessariamente no <head>.

    Se isso não for viável, consulte Diretrizes de Tag do Oracle Maxymiser CX ou entre em contato com o Oracle Consulting Services para obter suporte aos seus requisitos de tag para uma implementação assíncrona.

Etapa 2: Declarando Parâmetros em Nível de Usuário em suas Chamadas de Rastreamento

Quando um usuário tiver se autenticado, você poderá adicionar detalhes sobre ele em chamadas de rastreamento novas ou existentes (por exemplo, talvez você queira apresentar o ID do cliente para cada visitante autenticado).

Parâmetros disponíveis

Você deve decidir quais Parâmetros deseja enviar ao Oracle Infinity para adições de carrinho.

Veja a seguir uma tabela de parâmetros sugeridos que você pode enviar para usuários autenticados:

Parâmetros Sugeridos no Nível do Usuário

Parâmetro Nome do Parâmetro Valor de Amostra Notas
wt.dcsvid ID do Visitante Externo CUST123 Consulte abaixo*
wt.customer_id ID do Cliente CUST123 Seu ID para o cliente
wt.email Endereço de E-mail stevie.nicks@oracle.com Endereço de e-mail bruto
wt.e_id_s Endereço de E-mail (SHA-256 Hashed) 9A0FF5B8ADEC41340B433CB2E343DA2DF0DFCBB7447301D97755B6568E41BB8B SHA-256 Endereço de E-mail Hashed
wt.e_id_m Endereço de E-mail (MD5 Mantido) 0FED850BA5BC6D3A126270F5DFA43C15 MD5-Endereço de e-mail gerado
wt.mobile_phone Número do Telefone Celular +447809839594 Número de telefone bruto
wt.riid ID do destinatário do Responsys (RIID) 564228225 ID do Destinatário do Responsys
wt.customer_type Tipo de Cliente Prêmio Tipo de Cliente

*ID do Visitante Externo

Esse parâmetro substituirá o ID do visitante padrão gerado por visitante pelo Oracle Infinity. Consulte ID do Visitante Externo para obter mais detalhes.

Declarando Parâmetros

Depois de escolher seus Parâmetros, você poderá declará-los em chamadas novas ou existentes. Por exemplo:

Exemplo de chamada de visualização para usuário autenticado em uma 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)]);
})();

Etapa 3: Teste se os Parâmetros estão sendo declarados

Depois de declarar os parâmetros no nível do usuário, você poderá validar a solicitação abrindo o Depurador de Rede do Chrome DevTools:

  1. Abra o Depurador de Rede do Chrome DevTools.
  2. Certifique-se de que você esteja autenticado no seu site (ou atenda aos critérios para declarar seus novos parâmetros).
  3. Atualize a página.
  4. Filtrar por dcs no depurador.
  5. Selecione a solicitação dcs.gif (esta é a chamada de coleta de dados do Oracle Infinity).
  6. Exiba os parâmetros que estão sendo enviados.

Exibindo sua chamada de coleta de dados do Oracle Infinity

Exibindo sua chamada de coleta de dados do Oracle Infinity

Etapa 4: Verifique se o Oracle Infinity está Recebendo Dados

Agora você pode Verificar os dados disponíveis no Oracle Infinity para seus dados de compra, de acordo com os Parâmetros definidos em seu Clique em Chamada acima (por exemplo, data.wt.customer_id).

Mais Recursos de Aprendizagem

Explore outros laboratórios em docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal YouTube do Oracle Learning. Além disso, visite education.oracle.com/learning-explorer para se tornar um Oracle Learning Explorer.

Para obter a documentação do produto, visite o Oracle Help Center.