Visão geral da extensão do Adobe Target v2

Use essa referência para obter informações sobre as opções disponíveis ao usar esta extensão para criar uma regra.

Configurar a extensão do Adobe Target v2

Se a extensão do Adobe Target ainda não estiver instalada, abra a propriedade, selecione Extensões > Catálogo, passe o mouse sobre a extensão do Target e selecione Instalar.

Para configurar a extensão, abra a guia Extensões, passe o mouse sobre a extensão e selecione Configurar.

configurações do at.js

Todas as suas configurações de at.js, com exceção do tempo limite, são automaticamente recuperadas da configuração de at.js na interface do Target. A extensão recupera apenas as configurações da interface do Target quando adicionada pela primeira vez. Se forem necessárias atualizações adicionais, as configurações serão gerenciadas na interface do usuário.

As opções de configuração disponíveis são as seguintes:

Código do cliente

O código de cliente é o identificador de conta do Target. Isso deve ser quase sempre deixado como o valor padrão. Pode ser alterado usando elementos de dados.

ID da organização

Essa ID vincula sua implementação à sua conta da Adobe Experience Cloud. Isso deve ser quase sempre deixado como o valor padrão. Pode ser alterado usando elementos de dados.

Domínio do servidor

O domínio do servidor se refere ao domínio para o qual as solicitações do Target são enviadas. Isso deve ser quase sempre deixado como o valor padrão.

Aceitação do GDPR

Quando ativado, o Adobe Target fornece a funcionalidade de “aceitar” para auxiliar na estratégia de gerenciamento de consentimento. A funcionalidade de aceitar permite que os clientes controlem como e quando a tag do Target é acionada. Para obter mais informações sobre a aceitação em produtos Adobe, consulte Privacidade e Regulamento Geral sobre a Proteção de Dados (GDPR).

Tempo limite (ms)

Se a resposta do Target não for recebida dentro do período definido, a solicitação expirará e o conteúdo padrão será exibido. Ainda há tentativas de solicitações adicionais durante a sessão do visitante. O padrão é 3000 ms, que pode ser diferente do tempo limite configurado na interface do usuário do Target.

Para obter mais informações sobre como funciona a configuração de Tempo limite, consulte a ajuda do Adobe Target.

Tipos de ação da extensão do Target

Esta seção descreve os tipos de ação disponíveis na extensão do Target.

A extensão do Target fornece as seguintes ações no trecho Then de uma regra:

Carregar Target

Adicione essa ação à sua regra de tag quando fizer sentido carregar o Target no contexto da regra. Isso carrega a biblioteca do at.js na página. Na maioria das implementações, o Target deve ser carregado em todas as páginas do site. A Adobe recomenda usar a ação Laod Target somente se ela for precedida por uma chamada do Target. Caso contrário, você poderá enfrentar problemas como atraso na chamada do Analytics.

Nenhuma configuração é necessária.

Carregar o Target com Decisão no dispositivo

Adicione essa ação à regra de tag quando fizer sentido carregar o Target com a habilitação de tomada de decisões no dispositivo no contexto da regra. Isso carrega a biblioteca da at.js com a decisão no dispositivo ativada na página. Na maioria das implementações, o Target deve ser carregado em todas as páginas do site. A Adobe recomenda usar a ação Carregar destino com decisão no dispositivo apenas se for precedida por uma chamada do Target. Caso contrário, você poderá enfrentar problemas como atraso na chamada do Analytics.

Nenhuma configuração é necessária.

Adicionar params a todas as solicitações

Esse tipo de ação permite que parâmetros sejam adicionados a todas as solicitações do Target. A ação Carregar Target deve ser usada anteriormente.

Adicionar params à solicitação de carregamento de página

Esse tipo de ação permite que parâmetros sejam adicionados especificamente às solicitações de carregamento de página. A ação Carregar Target deve ser usada anteriormente.

Acionar solicitação de carregamento de página

Esse tipo de ação permite que o Target acione uma solicitação quando a página é carregada. A ação Carregar Target deve ser usada anteriormente.

Especifique se deseja ativar a ocultação de corpo para evitar oscilação e qual estilo deve ser usado ao ocultar o elemento de corpo. As opções disponíveis são as seguintes:

Para obter mais informações, consulte a documentação de ajuda online do Target.

Acionar visualização

A ação para acionar a exibição pode ser chamada sempre que uma nova página é carregada ou quando um componente em uma página é renderizado novamente. O acionamento da exibição deve ser implementado para aplicativos de página única.

Para obter mais informações sobre como acionar uma exibição, consulte a triggerView()documentação de ajuda.

Implantação básica do Adobe Target

Depois que a extensão do Target estiver instalada, crie pelo menos uma regra para implantá-la corretamente. Primeiro, é preciso carregar a biblioteca do Target (at.js), especificar os parâmetros que você deseja usar com a solicitação de carregamento de página e acionar a solicitação de carregamento de página.

Uma regra do Target com esta implementação básica parece com o seguinte:

Depois de salvar essa regra, você precisará adicioná-la a uma biblioteca e criá-la/implantá-la para testar o comportamento.

Extensão do Adobe Target com uma implantação assíncrona

As tags podem ser implantadas de forma assíncrona. Se você estiver carregando a biblioteca de tags de forma assíncrona com o Target inserido, o Target também será carregado de forma assíncrona. Esse cenário é totalmente suportado, mas há uma consideração adicional que deve ser tratada.

Nas implantações assíncronas, é possível que a página conclua a renderização do conteúdo padrão antes que a biblioteca do Target seja totalmente carregada e tenha realizado a troca de conteúdo. Isso pode levar ao que é conhecido como "oscilação", em que o conteúdo padrão é exibido brevemente antes de ser substituído pelo conteúdo personalizado especificado pelo Target. Para evitar essa oscilação, sugerimos usar um trecho pré-ocultado e carregar o pacote de tag assíncrono para evitar oscilação de conteúdo.

Estas são algumas coisas que devem ser lembradas ao usar o trecho pré-ocultação:

O trecho de código de pré-ocultação é o seguinte e pode ser minimizado. As opções configuráveis estão no final:

;(function(win, doc, style, timeout) {
  var STYLE_ID = 'at-body-style';

  function getParent() {
    return doc.getElementsByTagName('head')[0];
  }

  function addStyle(parent, id, def) {
    if (!parent) {
      return;
    }

    var style = doc.createElement('style');
    style.id = id;
    style.innerHTML = def;
    parent.appendChild(style);
  }

  function removeStyle(parent, id) {
    if (!parent) {
      return;
    }

    var style = doc.getElementById(id);

    if (!style) {
      return;
    }

    parent.removeChild(style);
  }

  addStyle(getParent(), STYLE_ID, style);
  setTimeout(function() {
    removeStyle(getParent(), STYLE_ID);
  }, timeout);
}(window, document, "body {opacity: 0 !important}", 3000));

Por padrão, o trecho oculta previamente todo o HTML BODY. Em alguns casos, você pode querer ocultar previamente apenas certos elementos de HTML e não a página inteira. Você pode conseguir isso personalizando o parâmetro de estilo. Substitua por algo que oculta apenas regiões específicas da página.

Por exemplo, você tem duas regiões identificadas por IDs, contêiner-1 e contêiner-2, o estilo poderá ser substituído pelo seguinte:

#container-1, #container-2 {opacity: 0 !important}

Em vez do padrão:

body {opacity: 0 !important}

Por padrão, o trecho expira em 3000 ms ou 3 segundos. Esse valor pode ser personalizado.