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:
-
Implementar a Tag do Oracle CX em qualquer página em que você possa adicionar itens ao seu carrinho: Isso carregará a biblioteca de tags do Oracle CX na sua página para permitir a funcionalidade de rastreamento.
-
Adicionar um Oracle Infinity Clique em Chamar em todas as adições de carrinho: Essa chamada enviará os dados de adição do carrinho ao Oracle Infinity à medida que os usuários adicionarem itens ao carrinho.
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.
-
Ativado o Plug-in de Gerenciamento de Tags: Você deve ter ativado o plug-in Gerenciamento de Tags para sua tag para garantir que a chamada de exibição automática seja reprimida (você será disparando a chamada de exibição independentemente).
-
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 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:
- Abra o Depurador de Rede do Chrome DevTools.
- Executar uma adição de carrinho (por exemplo, clicando em um botão adicionar ao carrinho).
- Filtrar por
dcs
no depurador. - Selecione a solicitação
dcs.gif
(esta é a chamada de coleta de dados do Oracle Infinity). - Exiba os parâmetros que estão sendo enviados.
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
).
Links Relacionados
- Rastreando Compras com o Oracle Infinity - Tutorial do Oracle Help Center Learn sobre 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.
- Rastreando Usuários Autenticados com o Oracle Infinity - Tutorial do Oracle Help Center Learn sobre o rastreamento de compras com o 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 cart adds with Oracle Infinity on Web
F50839-01
November 2021
Copyright © 2021, Oracle and/or its affiliates.