Rastreie compras com o Oracle Infinity na Web
Introdução
Este tutorial demonstrará como rastrear compras no seu site usando o Oracle Infinity com a Tag do Oracle CX adicionando rastreamento à página de confirmação de pedidos.
Objetivos
Os objetivos do tutorial são:
-
Implementar a Tag do Oracle CX em sua página de confirmação de pedido : Isso carregará a biblioteca de tags do Oracle CX em sua página para permitir a funcionalidade de rastreamento.
-
Adicionar uma Chamada de View do Oracle Infinity na página de confirmação da ordem : Essa chamada enviará os dados da compra para o Oracle Infinity à medida que os usuários desembarcarem na página de confirmação da ordem.
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:
-
Criou uma nova tag para a Tag do Oracle CX: Essa tag será o que você implementa na sua página de confirmação de pedido.
-
Módulo Oracle Infinity Ativado: Você deve ter ativado o módulo Oracle Infinity para sua tag para garantir que a coleta de dados esteja ativada.
-
Enabled the Tag Management Plugin - Você deve ter ativado o plug-in Tag Management para sua tag para garantir que a chamada de exibição automática seja reprimida (você será disparando a chamada de exibição de forma independente).
-
Promoveu sua Tag para Produção : Seu contêiner de tags deve ser promovido para produção.
-
Seu URL de Tag: Você deve ter seu URL de tag para sua configuração de produção (este será o ponto final real que você implementará em sua página Web). Ele estará no seguinte formato:
//c.oracleinfinity.io/acs/account/{YOUR_ACCOUNT_GUID}/js/{YOUR_TAG_ID}/odc.js?_ora.config=analytics:production
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.
-
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. -
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 visualização na sua página de confirmação de pedido
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 todas as compras.
Abaixo, há uma tabela dos parâmetros disponíveis que você pode enviar em sua página de confirmação de pedido para rastrear compras.
Parâmetros relacionados à compra disponíveis
Parâmetro | Nome do Parâmetro | Obrigatório | Valor de Amostra | Notas |
---|---|---|---|---|
wt.tx_e |
Ação de eCommerce | Obrigatórias | p | Valor predefinido |
wt.tx_id |
Data da NFF | Obrigatórias | 25/12/2021 | mm/dd/aaaa |
wt.tx_it |
Hora da Fatura | Obrigatórias | 23:58:10 | hh:mm:ss |
wt.tx_i |
Número da NFF | Obrigatórias | 132432ASP34 | ID da NFF/Ordem |
wt.currency |
Moeda | Obrigatórias | GBP | Código da Moeda |
wt.cart_subtotal |
Subtotal do carrinho | Obrigatórias | 105,00 | Valor do carrinho de compras (menos impostos + remessa) |
wt.cart_total |
Total do Carrinho | Obrigatórias | 116,00 | Valor do carrinho (incluindo imposto e remessa) |
wt.pn_sku |
SKU do Produto | Obrigatório* | SKU1;SKU3;SKU9 | Lista delimitada por ';' (por item de linha) |
wt.tx_s |
Preço do Item de Linha do Produto | Obrigatórias | 10,00;80,00;15,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;20,00;5,00 | Lista delimitada por ';' por produto (por item de linha) |
wt.tx_u |
Unidades do produto | Obrigatórias | 1;4;3 | Lista delimitada por ';' (por item de linha) |
wt.cg_n |
Grupo de Conteúdo | Recomendado | acessórios;menus;acessórios | Lista delimitada por ';' (por item de linha) |
wt.cg_s |
Subgrupo de Conteúdo | Recomendado | sapatos;esforços;meias | Lista delimitada por ';' (por item de linha) |
wt.product_coupon |
Cupom do Produto | Recomendado | CONTAGEM | Código do Desconto |
wt.cart_tax |
Imposto do carrinho de compras | Recomendado | 10.00 | Imposto do carrinho de compras |
wt.cart_shipping |
Remessa de Carrinho | Recomendado | 1.00 | Custos da remessa |
wt.cart_discount |
Desconto do Carrinho | Recomendado | 4.00 | Quaisquer descontos aplicados |
wt.si_p |
Nome da Etapa | Recomendado | Confirmação do Pedido | Nome da etapa no seu funil |
wt.si_x |
Número da Etapa | Recomendado | 5 | Entre no seu funil |
wt.si_n |
Nome do Cenário | Recomendado | Funil da Cesta | Nome do seu funil |
wt.conv |
Nome da Conversão | Recomendado | 1 | Definir como '1' |
wt.pn_id |
ID do Produto | Opcional | 232432;23423;32123 | Lista delimitada por ';' (por item de linha) |
wt.product_name |
Nome do Produto | Opcional | tremores grandes;vestimento grande;meias listradas | Lista delimitada por ';' (por item de linha) |
wt.pn_ma |
Marca de Produto | Opcional | acme;fudd;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 View Call
Depois de escolher seus Parâmetros, você deve declará-los implementando o seguinte bloco de código no <body>
da sua página de confirmação de pedido:
Implementação de chamada de visualização de amostra
<body>
...
<script type="text/JavaScript">
(function(){
// Declare Your Parameters
var cxDataObject = {};
cxDataObject["wt.tx_e"] = "p"; // Transaction Event - Purchase
cxDataObject["wt.tx_id"] = "12/25/2021"; // Transaction Date
cxDataObject["wt.tx_it"] = "23:58:10"; // Transaction Time
cxDataObject["wt.tx_i"] = "132432ASP34"; // Transaction ID
cxDataObject["wt.currency"] = "GBP"; // Currency
cxDataObject["wt.cart_subtotal"] = "105.00"; // Cart Subtotal
cxDataObject["wt.cart_total"] = "116.00"; // Cart Total
cxDataObject["wt.pn_sku"] = "SKU1;SKU3;SKU9"; // Product SKUs (';' delimited list - by line item)
cxDataObject["wt.product_price"] = "10.00;20.00;5.00"; // Product Price (';' delimited list - by line item)
cxDataObject["wt.tx_u"] = "1;4;3 "; // Units (';' delimited list - by line item)
cxDataObject["wt.tx_s"] = "10.00;80.00;15.00"; // Transaction Subtotal (';' delimited list per line item (Product Quantity * Product Unit Price))
cxDataObject["wt.cg_n"] = "accessories;womens;accessories"; // Content Group (';' delimited list per line item)
cxDataObject["wt.cg_s"] = "shoes;dresses;socks"; // Content Sub Group (';' delimited list per line item)
// DO NOT EDIT BELOW THIS LINE - ORA.view()
window.ORA = window.ORA || {productReady: []};
ORA.productReady.push(['analytics', function(cxDataObject) {return function() {return ORA.view({"data": cxDataObject})}}(cxDataObject)]);
})();
</script>
...
</body>
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 |
Etapa 3: Teste se sua Página está Enviando Dados
Depois que o rastreamento do Oracle Infinity tiver sido adicionado à página de confirmação de pedido, você poderá validar a solicitação abrindo o Chrome DevTools Network Debugger:
- Abra o Depurador de Rede do Chrome DevTools.
- Atualize a página.
- Filtrar por
dcs
no depurador. - Selecione a solicitação
dcs.gif
(esta é a chamada de coleta de dados do Oracle Infinity). - Exibir os parâmetros que estão sendo enviados
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 sua Chamada de Exibição acima (por exemplo, data.wt.tx_e=p
).
Links Relacionados
- Rastreando Adições de Carrinho no Oracle Infinity - Tutorial do Oracle Help Center Learn sobre rastreamento de adições de carrinho com o Oracle Infinity.
- Rastreando Usuários Autenticados com o Oracle Infinity - Tutorial do Oracle Help Center Learn sobre o rastreamento de compras com o Oracle Infinity.
- Verificando dados disponíveis no Oracle Infinity - Tutorial do Oracle Help Center Learn sobre como verificar dados disponíveis no Oracle Infinity.
- Central de Ajuda do Oracle Infinity - Central de Ajuda do Usuário para Oracle Infinity.
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.
Track purchases with Oracle Infinity on web
F50866-01
November 2021
Copyright © 2021, Oracle and/or its affiliates.