Implementar o Target sem um gerenciador de tags
Informações sobre como implementar o Adobe Target sem usar um gerenciador de tags ou tags no Adobe Experience Platform.
Para acessar a página de Implementação, clique em Administration > Implementation.
Você pode especificar as seguintes configurações nesta página:
- Detalhes da conta
- Métodos de implementação
- API de perfil
- Ferramentas de depuração
- Privacidade
Detalhes da conta
Você pode visualizar os seguintes detalhes da conta. Estas configurações não podem ser alteradas.
Para ativar a tomada de decisão no dispositivo, deslize o botão para a posição "ligado".
A decisão no dispositivo permite armazenar em cache as campanhas A/B e de Direcionamento de experiência (XT) no servidor e executar a decisão na memória com latência próxima a zero. Para obter mais informações, consulte Introdução à decisão no dispositivo.
(Condicional) Essa opção será exibida se você ativar a decisão no dispositivo.
Deslize o botão para a posição "ligado" se desejar que todas as atividades Target ativas qualificadas para decisões no dispositivo sejam incluídas automaticamente no artefato.
Deixar essa opção desativada significa que você deve recriar e ativar atividades de decisão no dispositivo para que elas sejam incluídas no artefato de regras gerado.
Métodos de implementação
As seguintes configurações podem ser definidas no painel Métodos de implementação:
Configurações globais
Selecione um nome para a mbox global. Como padrão, esse nome é target-global-mbox.
Caracteres especiais, incluindo o sinal gráfico (&), podem ser usados em nomes de mbox com a at.js.
Se o Target não responder ao conteúdo no período definido, o tempo limite da chamada do servidor acaba e o conteúdo padrão é exibido. Ainda há tentativas de chamadas adicionais durante a sessão do visitante. O limite padrão é de 5 segundos.
A biblioteca at.js usa a configuração de tempo limite em XMLHttpRequest. O tempo limite começa quando a solicitação é acionada e para quando Target recebe uma resposta do servidor. Para obter mais informações, consulte XMLHttpRequest.timeout no Mozilla Developer Network.
Se o tempo limite especificado ocorrer antes de receber uma resposta, o conteúdo padrão é mostrado e o visitante pode ser contabilizado como um participante em uma atividade, pois toda a coleta de dados acontece na borda Target. Se a solicitação alcançar a borda Target, o visitante será contado.
Leve em consideração o seguinte ao configurar o tempo limite:
- Se o valor for muito baixo, os usuários podem visualizar o conteúdo padrão na maioria das vezes, embora o visitante possa ser contabilizado como participante na atividade.
- Se o valor for muito alto, os visitantes podem ver regiões em branco na sua página da Web, ou páginas em branco se você ocultar o corpo por períodos prolongados.
Para obter uma compreensão melhor dos tempos de resposta do mbox, olhe a guia Rede nas Ferramentas de desenvolvedor do navegador. Você também pode usar ferramentas de monitoramento de desempenho na Web de terceiros, como Catchpoint.
Observação: a configuração visitorApiTimeout garante que Target não espere a resposta da API do visitante por muito tempo. Essa configuração e a configuração de Tempo limite para at.js descrita aqui não são conflitantes.
Essa configuração determina a duração de armazenamento do perfil do visitante. Por padrão, os perfis são armazenados por duas semanas. Essa configuração pode ser aumentada para até 90 dias.
Para alterar a configuração Tempo de Vida do Perfil, contate o Atendimento ao Cliente.
Principal método de implementação
Para baixar a versão desejada do at.js, clique no botão Baixar apropriado.
Para editar a configuração do at.js, clique em Edit ao lado da versão do at.js desejada.
Além das configurações explicadas acima, as seguintes configurações específicas da at.js também estão disponíveis:
disabled (navegadores definem cookies somente no seu domínio (cookies próprios)), x only (navegadores definem cookies somente no domínio do Target), ou ambos, selecionando enabled (navegadores definem cookies próprios e de terceiros). Para at.js v2.10 e posterior, especifique se os recursos entre domínios são enabled (os navegadores definem cookies próprios e de terceiros) ou disabled (os navegadores não definem cookies de terceiros).API de perfil
Ative ou desative a autenticação para atualizações em lote pela API e gere um token de autenticação de perfil.
Para obter mais informações, consulte Configurações da API de perfil.
Ferramentas de depuração
Gerar um token de autorização para usar as ferramentas de depuração Target avançadas. Clique em Generate New Authentication Token.
Privacidade
Essas configurações permitem que você use o Target em conformidade com as leis de privacidade de dados aplicáveis.
Escolha a configuração desejada na lista suspensa Ofuscar endereço IP do visitante:
- Ofuscação do último octeto
- Ofuscação de IP inteiro
- None
Para obter mais informações, consulte Privacidade.
Baixar at.js
Instruções para baixar a biblioteca usando a interface Target ou a API de Download.
Baixar at.js usando a interface Target
Para baixar a at.js na interface Target:
- Clique em Administration > Implementation.
- Na seção Métodos de implementação, clique no botão Download ao lado da versão desejada do at.js.
Baixar at.js usando a API de download Target
Para baixar a at.js usando a API.
-
Obtenha o seu código de cliente.
O código de cliente está disponível na parte superior da página Administration > Implementation da interface Target.
-
Obtenha o seu número de administrador.
Carregue este URL:
code language-none https://admin.testandtarget.omniture.com/rest/v1/endpoint/<varname>client code</varname>Substitua
client codecom o código de cliente da Etapa 1.O resultado do carregamento deste URL deve ser semelhante ao seguinte exemplo:
code language-none { "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1" }Neste exemplo, "6" é o número do administrador.
-
Baixe a at.js.
Carregue esse URL com a seguinte estrutura. O carregamento desse URL inicia o download do arquivo at.js personalizado.
code language-none https://admin<varname>admin number</varname>.testandtarget.omniture.com/admin/rest/v1/libraries/atjs/download?client=<varname>client code</varname>&version=<version number>- Substitua
admin numberpelo seu número de administrador. - Substitua
client codecom o código de cliente da Etapa 1. - Substitua
version numberpelo número de versão da at.js desejado (por exemplo, 2.2).
- Substitua
Implementação da at.js
A at.js deve ser implementada no elemento <head> de cada página do site.
Uma implementação típica do Target que não usa um gerenciador de tags, como tags na Adobe Experience Platform, é semelhante a:
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>Title of the Page</title>
<!--Preconnect and DNS-Prefetch to improve page load time-->
<link rel="preconnect" href="//<client code>.tt.omtrdc.net">
<link rel="dns-prefetch" href="//<client code>.tt.omtrdc.net">
<!--/Preconnect and DNS-Prefetch-->
<!--Data Layer to enable rich data collection and targeting-->
<script>
var digitalData = {
"page": {
"pageInfo": {
"pageName": "Home"
}
}
};
</script>
<!--/Data Layer-->
<!-- targetPageParams(), targetPageParamsAll(), Data Providers or targetGlobalSettings() functions to enrich the visitor profile or modify the library settings-->
<script>
targetPageParams = function() {
return {
"a": 1,
"b": 2,
"pageName": digitalData.page.pageInfo.pageName,
"profile": {
"age": 26,
"country": {
"city": "San Francisco"
}
}
};
};
</script>
<!--/targetPageParams()-->
<!--jQuery or other helper libraries should be implemented before at.js if you would like to use their methods in Target-->
<script src="jquery-3.3.1.min.js"></script>
<!--/jQuery-->
<!--Target's JavaScript SDK, at.js-->
<script src="at.js"></script>
<!--/at.js-->
</head>
<body>
The default content of the page
</body>
</html>
Considere as informações importantes a seguir:
- O Doctype HTML5 (por exemplo,
<!doctype html>) deve ser usado. Tipos de documento incompatíveis ou mais antigos podem resultar na incapacidade de Target fazer uma solicitação. - Pré-conectar e Buscar previamente são opções que podem auxiliar no carregamento mais rápido das páginas da Web. Se você usa essas configurações, substitua
<client code>pelo seu próprio código de cliente, que pode ser obtido na página Administration > Implementation. - Se você tiver uma camada de dados, é ideal definir o máximo dela possível em
<head>das suas páginas, antes dos carregamentos da at.js. Este posicionamento fornece a capacidade máxima de usar essas informações no Target para personalização. - As funções especiais Target, como
targetPageParams(),targetPageParamsAll(), Provedores de dados etargetGlobalSettings()devem ser definidas após a camada de dados e antes dos carregamentos da at.js. Como alternativa, essas funções podem ser salvas na seção Cabeçalho da biblioteca da página Editar configurações da at.js e salvas como parte da própria biblioteca at.js. Para obter mais informações sobre essas funções, consulte funções da at.js. - Se você usar as bibliotecas auxiliares do JavaScript, como jQuery, inclua-as antes de Target, para que possa usar sua sintaxe e métodos ao criar experiências de Target.
- Inclua a at.js no
<head>das suas páginas.
Rastrear conversões
A mbox de confirmação de pedido registra detalhes sobre pedidos no seu site e permite a geração de relatórios baseados em receita e pedidos. A mbox de confirmação de pedido também pode impulsionar algoritmos de recomendação, como "Pessoas que compraram o produto x também compraram o produto y".
-
Na página de detalhes do pedido, insira o script da mbox seguindo o modelo abaixo.
-
Substitua as PALAVRAS EM LETRAS MAIÚSCULAS por valores dinâmicos ou estáticos do seu catálogo.
note tip TIP Você também pode passar informações de pedido em qualquer mbox (ela não precisa ser chamada orderConfirmPage). Também é possível passar informações de pedidos em várias mboxes dentro da mesma campanha.code language-none <script type="text/javascript"> adobe.target.trackEvent({ "mbox": "orderConfirmPage", "params":{ "orderId": "ORDER ID FROM YOUR ORDER PAGE", "orderTotal": "ORDER TOTAL FROM YOUR ORDER PAGE", "productPurchasedId": "PRODUCT ID FROM YOUR ORDER PAGE, PRODUCT ID2, PRODUCT ID3" } }); </script>
A mbox de confirmação de pedido utiliza os seguintes parâmetros:
Valor único para identificar um pedido de contagem de conversão.
O orderId deve ser exclusivo. Pedidos duplicados são ignorados em relatórios.
Valor monetário para a compra.
Não transmita o símbolo de moeda. Use um ponto (não uma vírgula) para indicar valores decimais.
Lista separada por vírgula de IDs de produtos comprados no pedido.
Essas IDs de produto são exibidas no relatório de auditoria para oferecer suporte às análises de relatório adicionais.