Rastrear adições de carrinho com o Oracle Infinity na Web

Introdução

Este tutorial demonstrará como rastrear adições ao carrinho de um usuário no seu site usando o Oracle Infinity com a Tag do Oracle CX adicionando rastreamento ao seu carrinho ações de adição no seu site.

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: Adicionar uma chamada de clique às ações de adição de carrinho

Parâmetros disponíveis

Escolhendo seus Parâmetros: Consulte Escolhendo seus Parâmetros para obter orientação sobre como selecionar quais parâmetros você gostaria de enviar:

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

A seguir, há uma tabela dos parâmetros disponíveis que você pode enviar em adições de carrinho:

Parâmetros relacionados à adição de carrinho disponíveis

Parâmetro Nome do Parâmetro Obrigatório Valor de Amostra Notas
wt.tx_e Ação de eCommerce Obrigatórias a Valor predefinido
wt.currency Moeda Obrigatórias GBP Código da Moeda
wt.tx_s Preço do Item de Linha do Produto Obrigatórias 20,00 Lista delimitada por ';' por item de linha (Quantidade do Produto * Preço Unitário do Produto)
wt.product_price Preço Unitário do Produto Obrigatórias 10.00 Lista delimitada por ';' por produto (por item de linha)
wt.tx_u Unidades do produto Obrigatórias 2 Lista delimitada por ';' (por item de linha)
wt.pn_sku SKU do Produto Obrigatório* SKU1 Lista delimitada por ';' (por item de linha)
wt.cg_n Grupo de Conteúdo Recomendado acessórios Lista delimitada por ';' (por item de linha)
wt.cg_s Subgrupo de Conteúdo Recomendado sapatos Lista delimitada por ';' (por item de linha)
wt.si_p Nome da Etapa Recomendado Adição de Cesta Nome da etapa no seu funil
wt.si_x Número da Etapa Recomendado 2 Entre no seu funil
wt.si_n Nome do Cenário Recomendado Funil da Cesta Nome do seu funil
wt.pn_id ID do Produto Opcional* 232432 Lista delimitada por ';' (por item de linha)
wt.product_name Nome do Produto Opcional grandes treinadores Lista delimitada por ';' (por item de linha)
wt.product_discount Desconto do Produto Opcional 0 Lista delimitada por ';' por produto (por item de linha)
wt.pn_ma Marca de Produto Opcional acme Lista delimitada por ';' (por item de linha)

*SKU do Produto ou ID do Produto?

SKU do Produto (wt.pn_sku) é o parâmetro padrão necessário para declarar seus produtos no Oracle Infinity. Opcionalmente, você também pode declarar o ID do Produto (wt.pn_id) em sua implementação se desejar (você também pode ignorar a SKU do Produto, mas isso significa que alguns recursos do Oracle Infinity não estão disponíveis sem um workflow personalizado).

Conectando a chamada do seu clique

Depois de escolher os Parâmetros, você deve declará-los acionando a seguinte função JavaScript quando um usuário adicionar itens ao carrinho:

Implementação de Chamada de Exemplo de Clique

(function(){
 
    // Declare Your Parameters
    var cxDataObject = {};
    cxDataObject["wt.tx_e"] = "a"; // Transaction Event - Purchase
    cxDataObject["wt.currency"] = "GBP"; // Currency
    cxDataObject["wt.pn_sku"] = "SKU1;SKU2"; // Product SKUs (‘;’ delimited list - by line item)
    cxDataObject["wt.product_price"] = "20.00"; // Product Price (‘;’ delimited list - by line item)
    cxDataObject["wt.tx_u"] = "2	"; // Units (‘;’ delimited list - by line item)
    cxDataObject["wt.tx_s"] = "40.00"; // Transaction Subtotal (‘;’ delimited list per line item (Product Quantity * Product Unit Price))
    cxDataObject["wt.cg_n"] = "accessories"; // Content Group (‘;’ delimited list per line item)
    cxDataObject["wt.cg_s"] = "shoes"; // Content Sub Group (‘;’ delimited list per line item)
    
    // 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)]);
})();

Escolhendo seus Parâmetros?

Em Parâmetros Disponíveis, você pode ver Obrigatório em relação a vários parâmetros. Idealmente, você superaria todos os parâmetros disponíveis, mas se você tiver dúvidas sobre o suporte a comprimentos máximos de solicitações em navegadores mais antigos (por exemplo, Internet Explorer), poderá usá-lo para ajudá-lo a priorizar quais parâmetros você deve implementar:

O que? Descrição
Obrigatório Normalmente necessário para a funcionalidade principal do Oracle Infinity e dos produtos CX conectados
Recomendado Geralmente necessário para a funcionalidade recomendada para produtos Oracle Infinity e CX conectados
Opcional Geralmente necessário para funcionalidade opcional para produtos Oracle Infinity e CX conectados

Testar se sua Página está Enviando Dados

Depois que o rastreamento do Oracle Infinity tiver sido adicionado em todas as adições de carrinho, você poderá validar a solicitação abrindo o Chrome DevTools Network Debugger:

  1. Abra o Depurador de Rede do Chrome DevTools.
  2. Executar uma adição de carrinho (por exemplo, clicando em um botão adicionar ao carrinho).
  3. Filtrar por dcs no depurador.
  4. Selecione a solicitação dcs.gif (esta é a chamada de coleta de dados do Oracle Infinity).
  5. 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 3: 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.tx_e=a).

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.