Detalhes sobre alterações em cada versão da biblioteca at.js de JavaScript do Adobe Target.
A equipe do Target é compatível com o at.js 1.x e at.js 2.x. Atualize para a atualização mais recente de qualquer versão principal do at.js para garantir que você esteja executando uma versão compatível.
Tags em Adobe Experience Platform é o método preferido para atualizar a at.js. Os desenvolvedores de extensão adicionam continuamente novos recursos a suas extensões e corrigem erros com frequência. Essas atualizações são colocadas em novas versões de uma extensão e disponibilizadas no Adobe Experience Platform como atualizações. Para obter mais informações, consulte Atualizações de extensão no Visão geral das tags guia.
pageLoad
que não era mapeado para a target-global-mbox no modo de execução híbrido On Device Decisioning (ODD).A biblioteca JavaScript at.js do Target agora coleta dados de uso de recursos e de telemetria de desempenho. Os dados pessoais não são coletados. A opção de recusa para este recurso está disponível ao configurar telemetryEnabled
para falso em targetGlobalSettings
. Para mais informações, consulte telemetryEnabled em targetGlobalSettings.
Esta versão inclui os seguintes aprimoramentos:
Esta versão contém as seguintes alterações:
reactor-window
e reactor-document
Adobe Experience Platform Launch para garantir que a Platform Launch criar funções corretamente para clientes que window.default
ou document-default
definido.Samesite=None
e Secure
para garantir que os cookies de domínio de terceiros sejam definidos corretamente.secureOnly
da at.js estiverem definidas como true
.triggerView()
.CONTENT_RENDERING_NO_OFFERS
. Agora, esse evento é acionado corretamente sempre que não há conteúdo retornado do Target.prefetch
.Math.random()
, mas depende de window.crypto
.sessionId
é estendida corretamente em cada chamada de rede.viewsEnable
.Essa versão da at.js inclui os seguintes aprimoramentos e alterações:
Esta versão também remove o suporte ao Microsoft Internet Explorer 10 e versões posteriores.
Essa versão do at.js é uma versão de manutenção e inclui os seguintes aprimoramentos e correções:
targetPageParams
era incluído nas solicitações da mbox. targetPageParams
deve ser incluído somente em solicitações pageLoad
. (TNT-40247)Essa versão do at.js é uma versão de manutenção e inclui os seguintes aprimoramentos e correções:
Essa versão do at.js é uma versão de manutenção e inclui os seguintes aprimoramentos e correções:
Essa versão do at.js é uma versão de manutenção e inclui os seguintes aprimoramentos e correções:
Essa versão do at.js é uma versão de manutenção e inclui os seguintes aprimoramentos e correções:
Essa versão do at.js é uma versão de manutenção e inclui os seguintes aprimoramentos e correções:
deviceIdLifetime
foi substituída por targetGlobalSettings. (TNT-36349)sendBeacon
. (TNT-36407, TNT-35990, TNT-36000)Essa versão do at.js é uma versão de manutenção e inclui os seguintes aprimoramentos e correções:
targetGlobalSettings.cspScriptNonce
e targetGlobalSettings.cspStyleNonce
para que a at.js possa definir o script correspondente e as funções da tag de estilo em ofertas aplicadas. Consulte targetGlobalSettings para obter mais detalhes.check
para at_check
para evitar colisões com as implementações dos clientes.Essa versão do at.js é uma versão de manutenção e inclui os seguintes aprimoramentos e correções:
check
para at_check
para evitar colisões com as implementações dos clientes.Essa versão da at.js inclui os seguintes aprimoramentos e correções:
Correção de um problema em que o rastreamento de cliques não relatava conversões no Analytics for Target (A4T) quando o código do Adobe Analytics não estava presente nos elementos da página.
Desempenho aprimorado ao usar o Serviço de ID de Experience Cloud (ECID) v4.4 e o at.js 2.2 em suas páginas da Web.
Anteriormente, a ECID fazia duas chamadas de bloqueio antes que a at.js pudesse buscar experiências. Isso foi reduzido a uma única chamada, o que melhora significativamente o desempenho.
Correção de um processamento de exibição com busca prévia incorreto, no qual os tokens de evento das ofertas padrão não eram incluídos nas notificações enviadas.
Atualize sua extensão da ECID para v4.4 para aproveitar esse aprimoramento de desempenho.
A at.js versão 2.2 também fornece uma nova configuração chamada serverState
. Essa configuração pode ser usada para otimizar o desempenho da página quando uma integração híbrida do Target é implementada. A integração híbrida significa que você está usando a at.js v2.2+ no lado do cliente e a API de entrega ou um SDK do Target no lado do servidor para fornecer experiências. O serverState
fornece ao at.js v2.2+ a capacidade de aplicar experiências diretamente de conteúdo buscado no lado do servidor e retornado ao cliente como parte da página que está sendo veiculada. Para obter mais informações, consulte "serverState" em targetGlobalSettings.
Essa versão da at.js inclui os seguintes aprimoramentos e correções:
Atualize sua extensão da ECID para v4.4 para aproveitar esse aprimoramento de desempenho.
Essa versão do at.js é uma versão de manutenção e inclui os seguintes aprimoramentos e correções:
(Os números de edição entre parênteses são para uso interno da Adobe.)
triggerView()
não renderizasse ofertas mais de uma vez. (TNT-32780)triggerView()
para garantir que a solicitação contivesse informações da Experience Cloud ID (ECID). (TNT-32776)triggerView()
, mesmo se não houvesse exibições salvas. (TNT-32614)Navigator.sendBeacon()
. (TNT-32683)mboxThirdPartyId
usando a função do targetPageParams
que fazia com que a carga da solicitação não estivesse presente nos parâmetros de consulta ou na carga da solicitação. (TNT-32613)Esta versão inclui os seguintes recursos e melhorias:
Suporte ao Adobe Opt-in: o Adobe Opt-in é uma maneira de simplificar as integrações das soluções da Adobe com as plataformas de gerenciamento de consentimento. Para obter mais informações sobre o Adobe Opt-in, consulte Privacidade e Regulamento Geral sobre a Proteção de Dados (GDPR).
Compatível com o CSP padrão do setor: a at.js não usa mais eval() para executar o JavaScript.
Registro de análises do cliente: forneça aos clientes controle total sobre como enviar dados de análise para o Adobe Analytics, seja no cliente ou no servidor.
Para obter mais informações, consulte Registro de análises no cliente em Antes de implementar.
Enviar notificações: permite aos desenvolvedores enviar notificações quando uma experiência é renderizada pelo seu código em vez de usar applyOffer()
ou applyOffers()
.
Para obter mais informações, consulte adobe.target.sendNotifications(options).
Tamanho da at.js reduzido em ~24%: o tamanho da at.js foi reduzido em ~24%. O tamanho de arquivo menor melhora o desempenho do carregamento da página e reduz o tempo para baixar a at.js na página.
Essa é uma versão de manutenção e inclui os seguintes aprimoramentos e correções:
(Os números de edição entre parênteses são para uso interno da Adobe.)
Essa é uma versão de manutenção e inclui a seguinte correção:
(Os números de edição entre parênteses são para uso interno da Adobe.)
A at.js 2.x fornece conjuntos de recursos avançados para sua empresa personalizar tecnologias de próxima geração no lado do cliente. Essa nova versão tem como foco a atualização da at.js para ter interações harmoniosas com aplicativos de página única (SPAs).
Estes são alguns benefícios do uso da at.js 2.x que não estão disponíveis nas versões anteriores:
A at.js 2.x apresenta as seguintes novas funções:
As seguintes funções foram descontinuadas com a introdução da at.js 2.x:
Para obter mais informações, consulte Atualização da at.js 1.x para at.js 2.x e funções da at.js.
Se você precisar de suporte do Adobe Opt-in para o Regulamento Geral sobre a Proteção de Dados (GDPR), use a at.js 1.7.0 ou 2.1.0.
O at.js 1.7.0 traz suporte à Adobe Opt-In. O Adobe Opt-In é uma maneira de simplificar as integrações das soluções da Adobe com as plataformas de gerenciamento de consentimento.
Para obter mais informações sobre o Adobe Opt-in, consulte Privacidade e Regulamento Geral sobre a Proteção de Dados (GDPR).
Esta versão também corrige um problema em que o Target pode substituir parâmetros de URL de redirecionamento por parâmetros provenientes do URL de redirecionamento.
Se você precisar de suporte do Adobe Opt-in para o GDPR, use a at.js 1.7.0 ou 2.1.0.
Para obter uma lista de todas as versões, consulte Detalhes de versão da at.js.
O at.js 1.6.4 é uma versão de manutenção e aborda o seguinte problema:
A versão 1.6.3 do at.js inclui as seguintes correções e aprimoramentos:
Esta é uma versão de manutenção e aborda o seguinte problema:
Além disso, a versão 1.6.2 da at.js também contém todos os aprimoramentos e correções incluídos na versão 1.6.1 e 1.6.0 da at.js. Essas versões não estão mais disponíveis para download. Recomendamos que você atualize para a versão 1.6.2, se estiver usando a 1.6.1 ou 1.6.0
Aqui estão as melhorias e correções incluídas na at.js versão 1.6.1:
Aqui estão as melhorias e correções incluídas na at.js versão 1.6.0:
A at.js versão 1.5.0 já está disponível.
Os detalhes do evento at-request-succeeded
contêm sinalizador de redirecionamento. Esse sinalizador pode ser usado para determinar se a página será redirecionada a um URL diferente. Caso queira saber o URL, cadastre-se em at-content-rendering-redirect
. (TNT-29834)
Correção de um problema que fazia com que window.targetGlobalSettings.enabled
falhasse com uma exceção de tempo de execução se fosse definido como false. (TNT-29829)
Correção de um problema que fazia com que a página falhasse ao carregar o Visual Experience Composer (VEC) se estivesse usando o código personalizado para acionar uma solicitação de mbox global o usando ocultação do evento body. (TNT-29795)
Suporte adicionado para screenOrientation
, devicePixelRatio
e webGLRenderer
. Esses novos parâmetros de solicitação do Target são usados para detecção de iPhone X e outra detecção de dispositivo moderna. Para obter mais informações, consulte Dispositivo móvel. (TNT-29781)
Correção de um problema em que a dica de localização do Adobe Audience Manager (AAM) não é sempre enviada. (TNT-29695)
Em navegadores com suporte para isso, o at.js 1.5.0 é alternado para MutationObserver para polling de seletor. Versões anteriores ao at.js 1.0.0 usavam um polyfill MutationObserver, que se mostrou problemático. Para evitar problemas de polyfill, a versão 1.5.0 usa o seguinte pseudocódigo para decidir qual mecanismo de agendamento utilizar:
if MutationObserver is supported
scheduler = MutationObserver
else if document is visible
scheduler = requestAnimationFrame
else
scheduler = setTimeout
A at.js versão 1.3.0 já está disponível.
Os seguintes novos eventos estão disponíveis para ajudar no rastreamento, depuração e personalização das interações com a at.js:
Para obter mais informações, consulte Eventos personalizados da at.js.
É possível aumentar uma solicitação de at.js com parâmetros adicionais provenientes de provedores de dados. Os provedores de dados devem ser adicionados a window.targetGlobalSettings
sob o dataProviders key
.
Para obter mais informações, consulte Provedores de dados.
As solicitações de at.js agora usam GET, mas mudam para POST quando o tamanho do URL excede 2048 caracteres. Existe uma nova propriedade chamada urlSizeLimit
, na qual você pode aumentar o limite de tamanho, se necessário. Essa alteração permite que o Target alinhe a at.js ao AppMeasurement, que usa a mesma técnica.
O Target agora reforça que a chave da mbox
é usada na função adobe.target.applyOffer(options)
. Essa chave era exigida anteriormente, mas o Target agora a aplica para garantir que tenha a validação adequada e que os clientes estejam usando a função corretamente.
A at.js melhorou a funcionalidade de rastreamento de eventos e cliques. O at.js usa navigator.sendBeacon()
para enviar dados de rastreamento de eventos e fallback para XHR síncrono quando navigator.sendBeacon()
não é suportado. Esse fallback afeta, principalmente, o Internet Explorer 10 e 11 e algumas versões do Safari. O Safari adicionará suporte para navigator.sendBeacon()
no próximo iOS versão 11.3.
A at.js agora pode renderizar ofertas mesmo quando uma página é aberta em guias em segundo plano. Alguns clientes do Target encontraram um problema quando requestAnimationFrame()
foi desativado devido ao comportamento de controle do navegador para guias em segundo plano.
Esta versão adiciona muitas melhorias de desempenho, incluindo callstacks mais curtos ao inspecionar um perfil de CPU do Chrome.
A at.js 1.3.0 não oferece mais suporte à entrega de conteúdo no Microsoft Internet Explorer 9. Para obter uma lista de navegadores compatíveis, consulte Navegadores suportados. A partir de agora, todas as solicitações serão executadas por XMLHttpRequest
com suporte ao CORS sem solicitações JSONP. Essa alteração melhora muito a segurança.
A at.js versão 1.2.3 já está disponível.
A at.js versão 1.2.2 já está disponível.
getOffer() params
quando targetPageParams()
retornava uma string em branco. (TNT-28359)A at.js versão 1.2.1 já está disponível.
A at.js versão 1.2 já está disponível como uma versão de manutenção que contém a maioria das correções de problemas.
target="_blank"
impedia o Target de abrir o link em uma nova guia. (TNT-28072)sdidParamExpiry
seja inicializado e passado corretamente para a API do visitante. Esta é uma regressão que foi adicionada à at.js 1.1.0
. As versões anteriores da at.js não foram afetadas. Isso afeta apenas clientes que usam ofertas de redirecionamento e o A4T. (TNT-27791)SCRIPT
seja executado, independentemente do atributo de tipo que está sendo usado. (TNT-27865)Data: 2 de agosto de 2017
Os seguintes aprimoramentos e correções estão incluídos na at.js versão 1.1:
document.currentScript polyfill
não interfira com o Angular 1.X.at-element-click-tracking
, em vez de at-element-marker
.Data: sexta-feira, 7 de julho de 2017
Os seguintes aprimoramentos e correções estão incluídos na at.js versão 1.0:
getOffer()
que retornava um erro em alguns sites.Data: segunda-feira, 22 de maio de 2017
Os seguintes aprimoramentos e correções estão incluídos na at.js versão 0.9.7:
insertAfter
e insertBefore
no Visual Experience Composer (VEC). Esses problemas estavam relacionados com a migração de ofertas visuais para modelos de ofertas.Data: quinta-feira, 13 de abril de 2017
Os seguintes aprimoramentos e correções estão incluídos na at.js versão 0.9.6:
Suporte à oferta de redirecionamento para A4T. Depois de baixar e instalar a at.js versão 0.9.6, poderá usar as ofertas de redirecionamento nas atividades que usam o Adobe Analytics como Fonte dos relatórios para o Target (A4T). Além da at.js versão 0.9.6, há outros requisitos mínimos que sua implementação deve atender para usar as ofertas de redirecionamento e o A4T. Para obter mais informações e outras informações importantes que você deveria saber, consulte Perguntas frequentes das Ofertas de redirecionamento - A4T.
Antes da at.js 0.9.6, quando a API de visitante estava presente na página e a configuração visitorApiTimeout
era muito agressiva, poderia ocorrer uma situação no em que nenhum dado MCID era enviado na solicitação do TargetTarget. Isso pode levar a problemas como ocorrências não corrigidas no Analytics ao usar o A4T.
Este comportamento foi alterado na at.js 0.9.6, mesmo que visitorApiTimeout
seja definido para 1 ms, o Target tentará coletar dados de SDID, servidores de rastreamento e IDs do cliente e enviá-los na solicitação.
Adição da configuração selectorsPollingTimeout
. Para obter mais informações, consulte targetGlobalSettings().
O formato do formulário de resposta de getOffer()
foi alterado. Para obter mais informações, consulte adobe.target.getOffer(options).
O registro do console foi adicionado para declarações <!DOCTYPE>
não suportadas.
Correção de um problema em que os plug-ins do Target Classic não eram aplicados corretamente quando várias ofertas padrão eram entregues a uma única mbox. (TGT-22664)
Melhoria na configuração de cookies para dois domínios de alto nível (TLDs) para garantir que o cookie da mbox seja definido corretamente para esses domínios (por exemplo, test.no e autodrives.ca e assim por diante).
O algoritmo para extrair o domínio de nível superior que deve ser usado ao salvar cookies foi alterado na at.js versão 0.9.6. Por causa dessa alteração, os cookies não pode ser salvos em endereços que usam IP. Na maioria das vezes, os endereços IP são usados para fins de teste, mas, como solução alternativa, é possível usar entradas de DNS ou ajustar o arquivo de hosts em uma caixa local.
Correção das ações de mover e reorganizar quando as propriedades são valores de cadeia de caracteres em vez de números inteiros.
Data: quinta-feira, 19 de janeiro de 2017
Os nomes das mboxes agora podem conter caracteres especiais, incluindo "E" comercial (&).
Para obter uma lista de caracteres especiais permitidos, consulte Configurações da at.js.
Adição da configuração secureOnly
, que indica se a at.js deve usar somente HTTPS ou pode alternar entre HTTP e HTTPS com base no protocolo da página. Esta é uma configuração avançada cujo padrão é Falso e pode ser substituída por targetGlobalSettings
.
A opção Suporte a navegador herdado está disponível na at.js versão 0.9.3 e posteriores. Esta opção foi removida na at.js versão 0.9.4.
Data: segunda-feira, 10 de outubro de 2016
Data: quarta-feira, 21 de setembro de 2016
optoutEnabled
para ativar ou desativar a não participação no Gráfico de dispositivos. Se essa configuração for definida como true
e o visitante tiver desativado o rastreamento, o navegador do visitante não fará chamadas de mbox. O Gráfico de dispositivos está atualmente na versão beta. Esta configuração é definida para false
por padrão, mas deve ser definido para true
se você estiver usando o Gráfico de dispositivos.CustomEvent
ao mecanismo de notificação. Anteriormente, o mecanismo de notificação de eventos da at.js não podia ser usado por meio das APIs DOM padrão, como document.addEventListener()
. Agora você pode usar document.addEventListener()
para assinar eventos at.js, como eventos de solicitação e eventos de renderização de conteúdo.Data: quinta-feira, 14 de julho de 2016
Versão do Target: 16.6.1
Data: 23 de junho de 2016
Corrige um problema de tela branca ao usar ofertas do VEC. Qualquer pessoa que utilize a at.js deve atualizar para esta nova versão.
Nova API registerExtension
.
Esta nova API permite que os desenvolvedores acessem determinados módulos jQuery usados na at.js para desenvolver extensões (também conhecidos como plug-ins) para a biblioteca. Existem algumas implicações para essa alteração. Isso afeta apenas os usuários que usam esses recursos:
A API getSettings()
() removida, mas a mesma funcionalidade está disponível usando registerExtension()
.
A API getTracking()
() removida, mas a mesma funcionalidade está disponível usando registerExtension()
.
A extensões existentes (por exemplo, as extensões AngularJS) devem ser atualizadas para usar a abordagem registerExtension()
.
Nova API de notificação da at.js.
O objetivo desse sistema de notificação é fornecer mais informações sobre o que a at.js está fazendo na página e quando há problemas. Um problema comum observado com o VEC: uma versão de TI altera a página, um seletor de VEC é interrompido e o teste para de fornecer conteúdo corretamente. Um objetivo desse sistema de notificação é tornar esse problema de entrega conhecido na página, para que os desenvolvedores possam acessar essas informações, transmiti-las para um sistema como o Adobe Analytics e enviar alertas aos proprietários do negócio, informando-os de que ocorreram problemas no teste.
Novo método da API targetGlobalSettings()
.
Você pode substituir as configurações na biblioteca da at.js, em vez de configurar as configurações no Target Standard/Premium UIou usando as apis REST.
Data: 5 de maio de 2016.
Esta é a primeira versão oficial da biblioteca at.js.
A at.js é uma nova biblioteca de implementação do Target, projetada para implementações típicas da Web e aplicativos de página única.
at.js substitui mbox.js para implementações de Adobe Target.
Entre outros benefícios, a at.js melhora o tempo de carregamento de página para implementação da Web, melhora a segurança e fornece opções de implementações melhores para aplicativos de página única.
A at.js contém os componentes que foram incluídos em target.js; portanto, target.js não é mais chamada.
Ao implementar a at.js, esteja ciente do seguinte: