Eventos personalizados da at.js

Última atualização: 5 de maio de 2025
  • Tópicos:

Criado para:

  • Desenvolvedor

Informações sobre at.js custom events, que informam quando uma solicitação ou oferta de mbox falha ou é bem-sucedida.

Historicamente, a mbox.js (descontinuada) não permitiu que outro código do JavaScript executado na página saiba o que acontece nos bastidores. Com o avanço da at.js, tivemos uma oportunidade única de corrigir este problema.

De acordo com nossos clientes, há vários cenários dos quais eles gostariam de ser notificados, incluindo:

  • Uma falha em uma solicitação da mbox devido ao tempo limite, código do status incorreto, erro de análise do JSON, etc.
  • Uma solicitação da mbox foi bem-sucedida.
  • Falha na renderização da oferta devido à ausência do elemento da mbox de encapsulamento, não foi possível encontrar o seletor, etc.
  • Renderização de oferta bem-sucedida. As alterações de DOM foram aplicadas.

Os eventos predefinidos têm uma estrutura que permite que você extraia os dados necessários conforme o tipo de evento.

Para certificar-se de que os eventos possam ser usados em diferentes cenários, os eventos personalizados têm um objeto de carga que é atribuído à propriedade detalhada do objeto do evento (que é transmitido ao manipulador). Para evitar, também, transmitir sequências de caracteres como nomes de evento, os eventos são expostos como constantes usando o espaço de nome adobe.target.event.

Estrutura

ChaveTipoDescrição
typeString

Há vários cenários em que você gostaria de receber notificações para ajudar com o rastreamento, depuração e personalização da interação com a at.js.

Cada evento personalizado listado abaixo tem dois formatos: um "constante" e um "valor em sequência".

  • Constantes: Prefixado com adobe.target.event., apresentado em todas as maiúsculas e contém caracteres sublinhados. Para se inscrever em eventos personalizados após o carregamento da at.js, mas antes de receber a resposta da mbox, use o constante.
  • Valores da string: Minúsculas e contêm hifens. Para se inscrever em eventos personalizados antes do carregamento da at.js, use os valores em sequência.

Solicitação com Falha

Constante: adobe.target.event.REQUEST_FAILED

Valor da cadeia de caracteres: at-request-failed

Descrição: Uma falha em uma solicitação da mbox devido ao tempo limite, código do status incorreto, erro de análise do JSON, etc.

Solicitação bem-sucedida

Constante: adobe.target.event.REQUEST_SUCCEEDED

Valor da Cadeia: at-request-succeeded

Descrição: Uma solicitação da mbox foi bem-sucedida.

Falha na renderização do conteúdo

Constante: adobe.target.event.CONTENT_RENDERING_FAILED

Valor da Cadeia: at-content-rendering-failed

Descrição: Falha na renderização da oferta devido à ausência do elemento da mbox de encapsulamento, não foi possível encontrar o seletor, etc.

Renderização do conteúdo bem-sucedida

Constante: adobe.target.event.CONTENT_RENDERING_SUCCEEDED

Valor da Cadeia: at-content-rendering-succeeded

Descrição: A renderização da oferta foi bem-sucedida. As alterações de DOM foram aplicadas.

Biblioteca carregada

Constante: adobe.target.event.LIBRARY_LOADED

Valor da Cadeia: at-library-loaded

Descrição: este evento é ideal para monitorar quando a at.js tiver sido totalmente carregada. Você pode usar este evento para personalizar a execução da mbox global. Você também pode usar este evento para desativar a mbox global e depois ouvir este evento disparar a mbox global posteriormente.

Início da solicitação

Constante: adobe.target.event.REQUEST_START

Valor da Cadeia: at-request-start

Descrição: este evento é disparado antes que uma solicitação HTTP seja executada. Você pode usar este evento para avaliações de desempenho usando a API do Resource Timing.

Início da renderização do conteúdo

Constante: adobe.target.event.CONTENT_RENDERING_START

Valor da Cadeia: at-content-rendering-start

Descrição: este é evento é disparado antes que a pesquisa do seletor seja iniciada e o conteúdo seja renderizado para a página. Você pode usar este evento para monitorar o progresso da renderização de conteúdo.

Renderização do conteúdo sem ofertas

Constante: adobe.target.event.CONTENT_RENDERING_NO_OFFERS

Valor da Cadeia: at-content-rendering-no-offers

Descrição: Este evento é disparado quando não há retorno de ofertas.

Redirecionamento da renderização do conteúdo

Constante: adobe.target.event.CONTENT_RENDERING_REDIRECT

Valor da Cadeia: at-content-rendering-redirect

Descrição: Esse evento é disparado quando uma oferta é redirecionada e Target redirecionará para uma URL diferente.

mboxStringnome da mbox
messageStringContém descrição para leitura humana, como o que aconteceu, mensagem de erro, etc.
rastreamentoObjetoContém o sessionId e deviceId. Em alguns casos, o deviceId pode estar ausente, porque o Target não foi capaz de recuperá-lo do servidor do Edge.
typeString

Artefato de decisão no dispositivo bem-sucedido

Constante:

adobe.target.event.ARTIFACT_DOWNLOAD_SUCCEEDED

Valor da cadeia de caracteres: artifactDownloadSucceeded

Descrição: chamado quando o artefato de decisão no dispositivo é baixado com êxito.

Falha no artefato de decisão no dispositivo

Constante: adobe.target.event.ARTIFACT_DOWNLOAD_FAILED

Valor da Cadeia: artifactDownloadFailed

Descrição: chamado quando ocorria uma falha no download do artefato de decisão no dispositivo.

Uso

document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(event) {
  console.log('Event', event);
});

Vídeo de treinamento: tokens de resposta e os eventos personalizados da at.js Selo do tutorial

Assista ao vídeo a seguir para saber como usar Tokens de resposta e Eventos personalizados de at.js para compartilhar informações de perfil do Target com sistemas de terceiros.

Página anteriorsendNotifications() - at.js 2.1
Próxima páginaDepuração da at.js usando o depurador da Adobe Experience Cloud

Target