Documentação Experience Platform Migração do Target da at.js 2.x para o SDK da Web

Comparação da at.js com o Platform Web SDK

Last update: Tue Sep 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

Intermediário
Experiente
Desenvolvedor

A biblioteca at.js independente do Adobe Target difere significativamente da Platform Web SDK. As tabelas a seguir são uma referência para ajudar a avaliar as áreas da sua implementação nas quais talvez seja necessário se concentrar durante o processo de migração.

Depois de revisar as informações abaixo e avaliar sua implementação técnica atual da at.js, você deve ser capaz de entender o seguinte:

Quais recursos do Target são compatíveis com o Platform Web SDK
Quais funções da at.js têm equivalentes do Platform Web SDK
Como as configurações do Target são aplicadas com o Platform Web SDK
Como o fluxo de dados da at.js e do Platform Web SDK difere

Se você não estiver familiarizado com o Platform Web SDK, não se preocupe. Os itens abaixo são abordados com mais detalhes neste tutorial.

Comparação de recursos

at.js 2.x do Target

SDK da Web da Platform

Atualizar perfil de destino

Suportado

Acionar exibição para SPAs

Suportado

Recomendações do Target

Suportado

Buscar ofertas baseadas em formulário

Suportado

Rastrear eventos

Suportado

A4T: aplicativo de página única

Suportado

A4T: rastreamento de cliques

Suportado

A4T: registro no lado do cliente

Suportado

A4T: registro do lado do servidor

Suportado

Aplicar ofertas

Suportado

Renderizar novamente a exibição no SPA sem notificações

Suportado

Aplicativos híbridos

Suportado

URLs de garantia da qualidade

Suportado

IDs de terceiros da mbox

Suportado

Atributos do cliente

Suportado

Ofertas remotas

Suportado

Parcialmente compatível. As ofertas remotas dinâmicas não são compatíveis.

Ofertas de redirecionamento

Suportado

Compatível. No entanto, um redirecionamento de uma página com o Platform Web SDK para uma página com a at.js (e na direção oposta) não é suportado.

Decisão no dispositivo

Suportado

Não suportado no momento

Buscar previamente mboxes

Compatível com escopos personalizados e SPA VEC

A busca prévia é o modo padrão do Web SDK

Eventos personalizados

Suportado

Não suportado. Consulte o roteiro público para ver o status atual.

Tokens de resposta

Suportado

Compatível. Consulte a documentação de tokens de resposta dedicados para obter exemplos de código e as diferenças entre a at.js e o Platform Web SDK

Provedores de dados

Suportado

Não suportado. O código personalizado pode ser usado para acionar um comando sendEvent do Platform Web SDK depois que os dados forem recuperados de outro provedor.

Chamadas notáveis

at.js 2.x do Target

SDK da Web da Platform

Mitigação de cintilação

O trecho pré-ocultação para implementações assíncronas usa uma ID de estilo de at-body-style. A at.js procura essa ID de elemento para remover o estilo depois que uma resposta é recebida.

O trecho pré-ocultação padrão usa uma ID de estilo de alloy-prehiding. O Web SDK não é compatível com o trecho pré-ocultação da at.js, portanto, ele deve ser alterado como parte do processo de migração.

Renderizar conteúdo automaticamente no carregamento da página

Controlado com uma configuração global do Target. Habilitado quando pageLoadEnabled está definido como true.

Especificado no comando sendEvent do Platform Web SDK. Habilitado ao configurar a opção renderDecisions como true.

Renderização manual do conteúdo

As funções applyOffer() e applyOffers() oferecem suporte somente à configuração HTML

O comando applyPropositions oferece suporte à configuração, substituição ou acréscimo de HTML para maior flexibilidade

Rastreamento de eventos personalizados

Com suporte nas funções trackEvent() e sendNotifications(). Essas funções são específicas do Target e não afetam as métricas do Adobe Analytics.

Todos os dados das chamadas sendEvent do Platform Web SDK são encaminhados para o Target. Os dados complementares necessários especificamente para o Target devem ser incluídos com o comando sendEvent com um eventType de decisioning.propositionDisplay ou decisioning.propositionInteract para garantir que as métricas do Adobe Analytics não sejam afetadas.

CNAME de destino

Compatível. Isso é separado do CNAME usado para o Analytics e o Serviço da Experience Cloud ID.

Não é mais relevante. Um único CNAME pode ser usado para todas as chamadas do Platform Web SDK.

Depuração

Os parâmetros de URL do mboxDisable, mboxDebug e mboxTrace podem ser usados para depuração com as ferramentas de desenvolvedor do seu navegador.

O Adobe Experience Platform Debugger também é uma ferramenta de depuração com suporte.

Os parâmetros de URL mboxDisable, mboxDebug e mboxTrace não têm suporte.

Você pode ativar a depuração do Web SDK adicionando o alloy_debug=true à sua cadeia de caracteres de consulta ou executando alloy("setDebug", { "enabled": true }); no console do desenvolvedor.

A extensão do navegador Adobe Experience Platform Debugger pode ser usada para iniciar um rastreamento de borda para depuração.

Consulte a documentação de depuração do Platform Web SDK para obter mais informações.

Analytics for Target (A4T)

Usa valores SDID para unir chamadas do Target e do Analytics

Suporte nativo sem a necessidade de compilação

NOTE

Não há suporte para a migração do Target para o Platform Web SDK enquanto uma determinada página estiver retendo uma implementação existente do AppMeasurement Adobe Analytics.

É possível migrar sua implementação da at.js (e AppMeasurement.js) para a Platform Web SDK uma página por vez. Se você seguir esta abordagem, é melhor definir as opções idMigrationEnabled e targetMigrationEnabled como true com o comando configure.

Funções da at.js e equivalentes do Platform Web SDK

Muitas funções da at.js têm uma abordagem equivalente usando o Platform Web SDK descrita na tabela abaixo. Para obter mais detalhes sobre as funções da at.js, consulte o Guia do Desenvolvedor do Adobe Target.

Função da at.js 2.x

Equivalente ao Platform Web SDK

getOffer() e getOffers()

Para solicitar e renderizar automaticamente experiências baseadas em VEC do Target, use o comando sendEvent e defina a opção renderDecisions como verdadeira.

Para solicitar experiências baseadas em formulário ou renderizar manualmente o conteúdo, especifique uma matriz de decisionScopes (mboxes) com o comando sendEvent.

applyOffer() e applyOffers()

Use o comando applyPropositions para aplicar conteúdo. Você pode optar por definir, substituir ou anexar o HTML a um seletor específico.

triggerView()

O Platform Web SDK aciona automaticamente uma alteração de exibição para fins de SPA VEC se a propriedade web.webPageDetails.viewName estiver definida na opção xdm do comando sendEvent.

trackEvent() e sendNotifications()

Use o comando sendEvent com um conjunto específico eventType:

decisioning.propositionDisplay sinaliza a renderização de uma atividade

decisioning.propositionInteract sinaliza a interação do usuário com uma atividade, como um clique do mouse.

targetGlobalSettings()

Sem equivalente direto. Consulte a Comparação de configurações do Target para obter mais detalhes.

targetPageParams() e targetPageParamsAll()

Todos os dados passados na opção xdm do comando sendEvent são mapeados para parâmetros mbox de Destino. Como os parâmetros da mbox são nomeados usando a notação de pontos serializada, a migração para o Platform Web SDK pode exigir a atualização dos públicos-alvo e atividades existentes para usar os novos nomes de parâmetros da mbox.

Os dados passados como parte de data.__adobe.target do comando sendEvent estão mapeados para Parâmetros específicos do perfil de destino e das Recomendações.

Eventos personalizados da at.js

Não suportado. Consulte o roteiro público para ver o status atual. Tokens de resposta são expostos como parte de propositions na resposta da chamada sendEvent.

Configurações da at.js e equivalentes do Platform Web SDK

A biblioteca at.js pode ser configurada e baixada com várias configurações na interface do usuário do Target. Essas configurações também podem ser atualizadas com a função targetGlobalSettings(). A tabela abaixo compara essas configurações com as disponíveis no Platform Web SDK.

Configuração do at.js

Equivalente ao Platform Web SDK

bodyHiddenStyle

Defina o prehidingStyle com o comando configure

bodyHidingEnabled

Se um prehidingStyle for definido com o comando configure, esse recurso será habilitado. Se um estilo não estiver definido, o Platform Web SDK não tentará ocultar o conteúdo.

clientCode

Configurado automaticamente

cookieDomain

Não aplicável

crossDomain

Defina a opção thirdPartyCookiesEnabled como true com o comando configure para habilitar cookies próprios e de terceiros para casos de uso entre domínios

cspScriptNonce e cspStyleNonce

Consulte a documentação para configurar uma CSP

dataProviders

Incompatível

decisioningMethod

Todos os comandos sendEvent do Platform Web SDK usam a decisão do lado do servidor. A decisão híbrida e no dispositivo não é compatível.

defaultContentHiddenStyle e defaultContentVisibleStyle

Aplicável somente com a at.js 1.x. Semelhante à at.js 2.x, qualquer mitigação de cintilação para experiências baseadas em formulário pode ser realizada usando o código personalizado.

deviceIdLifetime

Não suportado. Se targetMigrationEnabled estiver definido como true com o comando configure, o cookie mbox será definido com a duração do dispositivo definida como 2 anos. Este valor não é configurável.

enabled

A funcionalidade do Target está ativada ou desativada com a configuração do fluxo de dados

globalMboxAutoCreate

Defina a opção renderDecisions como true com o comando sendEvent para buscar e renderizar automaticamente experiências baseadas em VEC.

Solicite um decisionScope para __view__ se preferir renderizar manualmente as experiências baseadas em VEC.

imsOrgId

Definir o orgId com o comando configure

optinEnabled e optoutEnabled

Consulte as opções de privacidade do Platform Web SDK. A opção defaultConsent se aplica a todas as soluções da Adobe compatíveis com a Platform Web SDK.

overrideMboxEdgeServer e overrideMboxEdgeServerTimeout

Não aplicável. Todas as solicitações do Platform Web SDK usam a rede Adobe Experience Platform Edge.

pageLoadEnabled

Defina a opção renderDecisions como true com o comando sendEvent

secureOnly

Não suportado. O Platform Web SDK define todos os cookies com os atributos secure e sameSite="none".

selectorsPollingTimeout

Não suportado. O Platform Web SDK usa um valor de 5 segundos. O código personalizado pode ser usado para renderizar conteúdo manualmente, se necessário.

serverDomain

Usar a configuração edgeDomain com o comando configure

telemetryEnabled

Não aplicável

timeout

Não suportado. Recomenda-se garantir que qualquer código de mitigação de cintilação inclua um tempo limite apropriado.

viewsEnabled

Não suportado. O conteúdo das exibições do Target sempre será obtido na primeira chamada sendEvent() se renderDecisions estiver definido como true ou se o __view__ decisionScope estiver incluído na solicitação.

visitorApiTimeout

Não aplicável

Comparação do diagrama do sistema

Os diagramas a seguir devem ajudar você a entender as diferenças de fluxo de dados entre uma implementação do Target usando a at.js e uma implementação usando o Platform Web SDK.

diagrama de sistema da at.js 2.x

Comportamento do at.js 2.0 no carregamento da página {modal="regular"}

Chame

Detalhes

A chamada retorna a Experience Cloud ID (ECID). Se o usuário for autenticado, outra chamada sincroniza a ID do cliente.

A biblioteca at.js é carregada de forma síncrona e oculta o corpo do documento (a at.js também pode ser carregada de forma assíncrona com uma opção que oculta previamente o trecho implementado na página).

A solicitação de Carregamento de página é feita, incluindo todos os parâmetros configurados, ECID, SDID e ID do cliente.

Os scripts de perfil executam e fazem o feed na Loja do perfil. A Loja solicita públicos qualificados da Biblioteca de público-alvo (por exemplo, públicos-alvo compartilhados do Analytics, do Audience Manager e assim por diante). Os atributos do cliente são enviados à Loja de perfis em um processo em lote.

Com base no URL, parâmetros de solicitação e dados de perfil, o Target decide quais Atividades e Experiências retornarão ao visitante para a página atual e para as exibições futuras.

O conteúdo direcionado é enviado de volta para a página, opcionalmente incluindo valores de perfil para personalização adicional.

O conteúdo direcionado na página atual é revelado o mais rápido possível sem cintilação do conteúdo padrão.

O conteúdo direcionado para exibições futuras de um aplicativo de página única é armazenado em cache no navegador para que possa ser aplicado instantaneamente, sem uma chamada de servidor extra, quando as exibições forem acionadas.

Dados do Analytics enviados da página para os Servidores de coleta de dados.

Os dados do Target são correspondidos aos dados do Analytics pela SDID, e processados no armazenamento de relatórios do Analytics. Em seguida, os dados do Analytics podem ser exibidos no Analytics e no Target pelos relatórios do A4T.

Consulte o guia do desenvolvedor para obter mais informações sobre como implementar o Target usando a at.js para aplicativos de página única.

Diagrama de sistema do Platform Web SDK

Diagrama da decisão de borda do Adobe Target com o Platform Web SDK

Chame

Detalhes

O dispositivo carrega o Platform Web SDK. O Platform Web SDK envia uma solicitação para a rede de borda com dados XDM, a ID de ambiente dos fluxos de dados, os parâmetros transmitidos e a ID do cliente (opcional). A página (ou contêineres) é pré-oculta.

A rede de borda envia a solicitação aos serviços de borda para enriquecê-la com a ID do visitante, o consentimento e outras informações de contexto do visitante, como geolocalização e nomes amigáveis ao dispositivo.

A rede de borda envia a solicitação de personalização enriquecida para a borda do Target com a ID do visitante e os parâmetros transmitidos.

Os scripts de perfil executam e, em seguida, fazem o feed no armazenamento do perfil do Target. O armazenamento de perfil busca segmentos da Biblioteca de público-alvo (por exemplo, segmentos compartilhados da Adobe Analytics, Adobe Audience Manager, Adobe Experience Platform).

Com base nos parâmetros de solicitação de URL e dados de perfil, o Target determina quais atividades e experiências serão exibidas para o visitante na exibição de página atual e para exibições futuras de busca prévia. O Target envia isso de volta para a rede de borda.

a. A rede de borda envia a resposta de personalização de volta para a página, incluindo, opcionalmente, valores de perfil para personalização adicional. O conteúdo personalizado na página atual é revelado o mais rápido possível sem cintilação do conteúdo padrão.

b. O conteúdo personalizado para exibições que são mostradas como resultado das ações do usuário em um Aplicativo de página única (SPA) é armazenado em cache para renderização instantânea sem chamadas de servidor adicionais.

c A rede de borda envia a ID do visitante e outros valores em cookies (por exemplo, consentimento, ID de sessão, identidade, verificação de cookie, personalização e assim por diante).

A rede de borda encaminha os detalhes do Analytics for Target (A4T) (metadados de atividade, experiência e conversão) para a borda do Analytics.

Consulte o guia do desenvolvedor para obter mais informações sobre como implementar o Target usando o Platform Web SDK para aplicativos de página única.

Depois de ter uma boa compreensão técnica da sua implementação do Target atual e dos recursos que você usa, a próxima etapa é executar a configuração inicial.

NOTE

Estamos empenhados em ajudá-lo a ter sucesso com a migração do Target da at.js para o Web SDK. Se você encontrar obstáculos com sua migração ou achar que há informações críticas ausentes neste guia, envie-nos uma mensagem em esta discussão da comunidade.

recommendation-more-help

a69e1b51-9545-4d8a-822d-319242c29110