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

A biblioteca at.js independente do Adobe Target é significativamente diferente do SDK da Web da plataforma. 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 SDK da Web da plataforma
  • Quais funções da at.js têm equivalentes do SDK da Web da plataforma.
  • Como as configurações do Target são aplicadas com o SDK da Web da plataforma
  • Como o fluxo de dados da at.js e do SDK da Web da Platform difere

Se você não estiver familiarizado com o SDK da Web da Platform, 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
Suportado
Acionar exibição para SPA
Suportado
Suportado
Recommendations do Target
Suportado
Suportado
Buscar ofertas baseadas em formulário
Suportado
Suportado
Rastrear eventos
Suportado
Suportado
A4T: aplicativo de página única
Suportado
Suportado
A4T: rastreamento de cliques
Suportado
Suportado
A4T: registro no lado do cliente
Suportado
Suportado
A4T: registro do lado do servidor
Suportado
Suportado
Aplicar ofertas
Suportado
Suportado
Renderizar novamente a exibição no SPA sem notificações
Suportado
Suportado
Aplicativos híbridos
Suportado
Suportado
URLs de garantia da qualidade
Suportado
Suportado
IDs de terceiros da mbox
Suportado
Suportado
Atributos do cliente
Suportado
Compatível
Ofertas remotas
Suportado
Suportado
Ofertas de redirecionamento
Suportado
Suportado. No entanto, um redirecionamento de uma página com o SDK da Web da Platform para uma página com a at.js (e na direção oposta) não é compatível.
Decisão no dispositivo
Suportado
Não suportado no momento
Buscar previamente mboxes
Compatível com escopos personalizados e VEC para SPA
No momento, não há suporte para o VEC regular
Eventos Personalizados
Suportado
Não suportado. Consulte a roteiro público para o status atual.
Tokens de resposta
Suportado
Suportado. Consulte a documentação dedicada dos tokens de resposta para obter exemplos de código e diferenças entre a at.js e o SDK da Web da plataforma
Provedores de dados
Suportado
Não suportado. O código personalizado pode ser usado para acionar um SDK da Web da plataforma sendEvent 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 SDK da Web 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. Ativado quando pageLoadEnabled está definida como true.
Especificado no SDK da Web da plataforma sendEvent comando. Habilitado ao configurar o renderDecisions opção para true.
Renderização manual do conteúdo
A variável applyOffer() e applyOffers() funções suportam somente configuração de HTML
A variável applyPropositions comando suporta configuração, substituição ou HTML de acréscimo para maior flexibilidade
Rastreamento de eventos personalizados
Compatível com trackEvent() e sendNotifications() funções. Essas funções são específicas do Target e não afetam as métricas do Adobe Analytics.
Todos os dados do SDK da Web da plataforma sendEvent As chamadas de são encaminhadas para o Target. Os dados suplementares necessários especificamente para o Target devem ser 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
Suportado. Isso é separado do CNAME usado para o Analytics e o Serviço de ID de Experience Cloud.
Não é mais relevante. Um único CNAME pode ser usado para todas as chamadas do SDK da Web da plataforma.
Depuração
A variável mboxDisable, mboxDebug, e mboxTrace Parâmetros de URL podem ser usados para depuração com as ferramentas do desenvolvedor do seu navegador.

O Adobe Experience Platform Debugger também é uma ferramenta de depuração compatível.
A variável mboxDisable, mboxDebug, e mboxTrace Não há suporte para parâmetros de URL.

Você pode ativar a depuração do SDK da Web adicionando o alloy_debug=true à sua cadeia de caracteres de consulta ou em execução 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 depuração do SDK da Web da Platform 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 SDK da Web da Platform enquanto uma determinada página é mantida em uma implementação existente do AppMeasurement Adobe Analytics.
É possível migrar sua implementação at.js (e AppMeasurement.js) para o SDK da Web da plataforma uma página por vez. Se você seguir essa abordagem, é melhor definir o idMigrationEnabled e targetMigrationEnabled opções para true com o configure comando.

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

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

Função da at.js 2.x
Equivalente ao SDK da Web da plataforma
getOffer() e getOffers()
Para solicitar e renderizar automaticamente Experiências baseadas em VEC do Target, use o sendEvent e defina o renderDecisions opção para verdadeiro.

Para solicitar experiências baseadas em formulário ou renderizar manualmente conteúdo, especifique uma matriz de decisionScopes (mboxes) com a variável sendEvent comando.
applyOffer() e applyOffers()
Use o applyPropositions para aplicar o conteúdo. Você pode optar por definir, substituir ou anexar HTML a um seletor específico.
triggerView()
O SDK da Web da Platform aciona automaticamente um exibir alteração para efeitos do VEC para o SPA, se a web.webPageDetails.viewName é definida na variável xdm opção do sendEvent comando.
trackEvent() e sendNotifications()
Use o sendEvent comando com um específico eventType definir:

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

decisioning.propositionInteract sinaliza uma 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 detalhes adicionais.
targetPageParams() e targetPageParamsAll()
Todos os dados transmitidos no xdm opção do sendEvent é mapeado para os parâmetros da mbox do Target. Como os parâmetros da mbox são nomeados usando a notação de pontos serializada, a migração para o SDK da Web da Platform pode exigir a atualização de públicos-alvo e atividades existentes para usar os novos nomes de parâmetro da mbox.

Dados transmitidos como parte de data.__adobe.target do sendEvent é mapeado para Perfil do Target e parâmetros específicos do Recommendations.
Eventos personalizados da at.js
Não suportado. Consulte a roteiro público para o status atual. Tokens de resposta são expostos como parte da propositions na resposta da Comissão sendEvent chame.

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

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 o targetGlobalSettings() função. A tabela abaixo compara essas configurações com as disponíveis com o SDK da Web da plataforma.

Configuração do at.js
Equivalente ao SDK da Web da plataforma
bodyHiddenStyle
Defina o prehidingStyle com o configure comando
bodyHidingEnabled
Se um prehidingStyle é definido com o configure , esse recurso será ativado. Se um estilo não estiver definido, o SDK da Web da Platform não tentará ocultar nenhum conteúdo.
clientCode
Configurado automaticamente
cookieDomain
Não aplicável
crossDomain
Defina o thirdPartyCookiesEnabled opção para true com o configure comando para ativar 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
Não suportado
decisioningMethod
Todos os SDKs da Web da Platform sendEvent Os comandos do 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 está definida como true com o configure , o mbox O cookie do é 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 o renderDecisions opção para true com o sendEvent para buscar e renderizar automaticamente experiências baseadas em VEC.

Solicitar um decisionScope para __view__ se preferir renderizar manualmente as experiências baseadas em VEC.
imsOrgId
Defina o orgId com o configure comando
optinEnabled e optoutEnabled
Consulte o SDK da Web da Platform opções de privacidade. A variável defaultConsent A opção se aplica a todas as soluções de Adobe compatíveis com o SDK da Web da plataforma.
overrideMboxEdgeServer e overrideMboxEdgeServerTimeout
Não aplicável. Todas as solicitações de SDK da Web da Platform usam a rede de borda da Adobe Experience Platform.
pageLoadEnabled
Defina o renderDecisions opção para true com o sendEvent comando
secureOnly
Não suportado. O SDK da Web da Platform define todos os cookies com o secure e sameSite="none" atributos.
selectorsPollingTimeout
Não suportado. O SDK da Web da Platform usa um valor de 5 segundos. O código personalizado pode ser usado para renderizar conteúdo manualmente, se necessário.
serverDomain
Use o edgeDomain configuração com o configure comando
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 buscado na primeira sendEvent() chamar se renderDecisions está definida como true ou o __view__ decisionScope está 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 at.js e uma implementação usando o SDK da Web da plataforma.

diagrama de sistema da at.js 2.x

Comportamento da at.js 2.0 no carregamento da página {zoom="yes"}

Chame
Detalhes
1
A chamada retorna a ID de Experience Cloud (ECID). Se o usuário for autenticado, outra chamada sincroniza a ID do cliente.
2
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).
3
A solicitação de Carregamento de página é feita, incluindo todos os parâmetros configurados, ECID, SDID e ID do cliente.
4
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, Audience Manager e assim por diante). Os atributos do cliente são enviados à Loja de perfis em um processo em lote.
5
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.
6
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.
7
Dados do Analytics enviados da página para os Servidores de coleta de dados.
8
Os dados do Target são correspondidos aos dados do Analytics pela SDID, e processados no armazenamento de relatório do Analytics. Em seguida, os dados do Analytics podem ser visualizados 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 Web SDK do Platform

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

Chame
Detalhes
1
O dispositivo carrega o SDK da Web da Platform. O SDK da Web da Platform 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.
2
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.
3
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.
4
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).
5
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.
6
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).
7
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 SDK da Web da plataforma para aplicativos de página única.

Depois de ter um bom conhecimento técnico da implementação do Target atual e dos recursos que usa, a próxima etapa é executar o configuração inicial.

NOTE
Estamos empenhados em ajudar você a ter sucesso com a migração do Target da at.js para o SDK da Web. Se você encontrar obstáculos com sua migração ou achar que informações críticas estão faltando neste guia, entre em contato conosco esta discussão da comunidade.
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110