Show Menu
TÓPICOS×

Implementação do Target sem um gerenciador de tags

Information about implementing Adobe Target without using a tag manager (Adobe Launch or Dynamic Tag Manager).
O Adobe Launch é o método preferido para a implementação do Target e da biblioteca at.js. As informações a seguir não são aplicáveis quando o Adobe Launch é usado para implementar o Target.
Para acessar a página Implementação , clique em Administração > Implementação .
Você pode especificar as seguintes configurações nesta página:
  • Detalhes da conta
  • Métodos de implementação
  • API do perfil
  • Ferramentas do depurador
  • Privacidade
É possível substituir as configurações na biblioteca at.js em vez de definir as configurações na interface do usuário do Target Standard/Premium ou usar APIs REST. Para obter mais informações, consulte targetGlobalSettings() .

Detalhes da conta

Você pode visualização os seguintes detalhes de conta. Essas configurações não podem ser alteradas.
Configuração
Descrição
Código do cliente
O código do cliente é uma sequência específica do cliente de caracteres frequentemente necessários ao usar as APIs do Target.
ID da organização IMS
Essa ID vincula sua implementação à sua conta da Adobe Experience Cloud.

Métodos de implementação

As seguintes configurações podem ser definidas no painel Métodos de implementação:

Configurações globais

Essas configurações são aplicadas a todas as bibliotecas Target .js. Depois de fazer alterações na seção Métodos de implementação, é necessário baixar a biblioteca e atualizá-la na implementação.
Configuração
Descrição
Carregamento de página ativado (Criar mbox global automaticamente)
Selecione se a chamada mbox global no arquivo at.js deve ser acionada automaticamente em cada carregamento de página.
Mbox global
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.
Tempo limite (segundos)
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 site 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 do Target. Se a solicitação alcançar a borda do Target, o visitante é contabilizado.
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 o 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.
Duração do perfil
Essa configuração determina a duração de armazenamento do perfil do visitante. Por padrão, os perfis são armazenados por duas semanas. Isso pode ser aumentado para até 90 dias.
Para alterar a configuração de Duração do perfil, entre em contato com o Atendimento ao cliente .

Método de implementação principal

A equipe do Público alvo oferece suporte para o at.js 1. x e at.js 2. x . Atualize para a atualização mais recente da versão principal do at.js para garantir que você esteja executando uma versão compatível.
Para baixar a versão desejada do at.js, clique no botão Download apropriado.
Para editar as configurações do at.js, clique em Editar ao lado da versão desejada do at.js.
Antes de alterar essas configurações padrão, consulte o Client Care para não afetar sua implementação atual.
Além das configurações explicadas acima, as seguintes configurações específicas do at.js também estão disponíveis:
Configuração
Descrição
Cabeçalho da biblioteca personalizada
Adicione qualquer JavaScript personalizado para incluir na parte superior da biblioteca.
Rodapé da biblioteca personalizada
Adicione qualquer JavaScript personalizado para incluir na parte inferior da biblioteca.

API do perfil

Ative ou desative a autenticação para atualizações em lote pela API e gere um token de autenticação de perfil.
For more information, see Profile API settings .

Ferramentas do depurador

Gere um token de autorização para usar ferramentas de Target depuração avançadas. Click Generate New Authentication Token .

Privacidade

Essas configurações permitem que você use de acordo Target com as leis de privacidade de dados aplicáveis.
Escolha a configuração desejada na lista suspensa Ofuscar endereço IP do Visitante:
  • Última ofuscação de octeto
  • Ofuscação de IP inteira
  • None
Para obter mais informações, consulte Privacidade .
A opção Suporte a navegador herdado estava disponível no at.js versão 0.9.3 e anterior. Essa opção foi removida na at.js versão 0.9.4. Para obter uma lista de navegadores suportados at.js, consulte Navegadores suportados
Os navegadores herdados são navegadores antigos que não suportam completamente CORS (Cross Origin Resource Sharing). Esses navegadores incluem: Internet Explorer em versão anterior a 11 e Safari versões 6 e anteriores. Se o suporte a navegador herdado estivesse desativado, o Público alvo não forneceria conteúdo ou contaria visitantes nos relatórios desses navegadores. Se essa opção estiver ativada, é recomendável fazer o controle de qualidade em navegadores mais antigos para garantir uma boa experiência do cliente.

Baixe a at.js

Instructions to download the library using the Target interface or the Download API.
  • O Adobe Launch é o método preferido para a implementação do Target e da biblioteca at.js. As informações a seguir não são aplicáveis quando o Adobe Launch é usado para implementar o Target.
  • A equipe do Público alvo oferece suporte para o at.js 1. x e at.js 2. x . Atualize para a atualização mais recente da versão principal do at.js para garantir que você esteja executando uma versão compatível. Para obter mais informações sobre o que há de novo em cada versão, consulte Detalhes da versão da at.js .

Download at.js using the Target interface

Para baixar a at.js na interface do Target:
  1. Clique em Administração > Implementação .
  2. Na seção Métodos de implementação, clique no botão Download ao lado da versão desejada para at.js.

Download at.js using the Target Download API

Para baixar a at.js usando a API.
  1. Obtenha o seu código de cliente.
    Your client code is available at the top of the Administration > Implementation page of the Target interface.
  2. Obtenha o seu número de administrador.
    Carregue este URL:
    https://admin.testandtarget.omniture.com/rest/v1/endpoint/<varname>client code</varname>
    
    
    Replace client code with the client code from Step 1.
    O resultado do carregamento deste URL deve ser semelhante ao seguinte exemplo:
    { 
      "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1" 
    }
    
    
    Neste exemplo, "6" é o número do administrador.
  3. Baixar at.js.
    Carregue este URL com a seguinte estrutura:
    https://admin<varname>admin number</varname>.testandtarget.omniture.com/admin/rest/v1/libraries/atjs/download?client=<varname>client code</varname>&version=<version number>
    
    
    • Replace admin number with your admin number.
    • Replace client code with the client code from Step 1.
    • Replace version number with the desired at.js version number (for example, 2.2).
    A equipe do Target mantém apenas duas versões de at.js—a versão atual e a segunda versão mais recente. Atualize a at.js conforme necessário para garantir que você esteja executando uma versão suportada. Para obter mais informações sobre o que há de novo em cada versão, consulte Detalhes da versão da at.js .
    O carreamento deste URL inicia o download do arquivo da at.js personalizado.

at.js implementation

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 o Adobe Launch ou Dynamic Tag Management é 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 HTML5 Doctype (por exemplo, <!doctype html> ) deve ser usado. Doctypes não compatíveis ou mais antigos poderiam imperdir o Target de 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. If you use these configurations, ensure that you replace <client code> with your own client code, which you can obtain from the Administration > **Implementation page.
  • 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. Esse posicionamento fornece a capacidade máxima de aproveitar essas informações no Target para personalização.
  • As funções especiais do Target, como targetPageParams() , targetPageParamsAll() , Provedores de dados e targetGlobalSettings() devem ser definidas após a camada de dados e antes dos carregamentos da at.js. Como alternativa, é possível salvá-las na seção Cabeçalho da biblioteca da página Editar configurações da at.js e 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 do Target, para que possa aproveitar a sintaxe e métodos delas ao criar as experiências do Target.
  • Inclua a at.js no <head> das suas páginas.

Track conversions

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".
Se usuários fazem compras no seu site, recomendamos implementar uma mbox de confirmação de pedido mesmo se você usar Analytics for Target (A4T) como seu gerador de relatórios.
  1. Na página de detalhes do pedido, insira o script da mbox seguindo o modelo abaixo.
  2. Substitua as PALAVRAS EM LETRAS MAIÚSCULAS por valores dinâmicos ou estáticos do seu catálogo.
    Utilize delimitação por vírgulas para separar várias IDs de produto.
    Dica: 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.
    <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:
Parâmetro
Descrição
orderId
Valor único para identificar um pedido de contagem de conversão.
O orderId deve ser único. Pedidos duplicados são ignorados em relatórios.
orderTotal
Valor monetário para a compra.
Não passe o símbolo de moeda. Use um ponto (não uma vírgula) para indicar valores decimais.
productPurchasedId (Opcional)
Lista separada por vírgula de IDs de produtos comprados no pedido.
Essas IDs de produtos são exibidas no relatório de auditoria para suportar análises de relatório adicionais.