DocumentaçãoExperience PlatformMigração do Target da at.js 2.x para o SDK da Web

Visão geral da migração do at.js para o SDK da Web da plataforma

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined
  • undefined

O nível de esforço para migrar do at.js para o SDK da Web da plataforma depende da complexidade da implementação atual e dos recursos de produto usados.

Independentemente da simplicidade ou complexidade de sua implementação, é importante entender totalmente seu estado atual antes de migrar. Este guia ajuda a detalhar os componentes da implementação atual e desenvolver um plano gerenciável para migrar cada parte.

O processo de migração envolve as seguintes etapas principais:

  1. Avalie sua implementação atual e determine uma abordagem de migração
  2. Configure os componentes iniciais para conectar ao Edge Network Adobe Experience Platform
  3. Atualize a implementação básica para substituir a at.js pelo SDK da Web da plataforma
  4. Aprimore a implementação do SDK da Web da plataforma para seus casos de uso específicos. Isso pode envolver a transmissão de parâmetros adicionais, a contabilização de alterações de exibição de aplicativo de página única (SPA), o uso de tokens de resposta e muito mais.
  5. Atualizar objetos na interface do Target, como scripts de perfil, atividades e definições de público-alvo
  6. Valide a implementação final antes de fazer o switch no ambiente de produção

Principais diferenças entre a at.js e o SDK da Web da plataforma

Antes de iniciar o processo de migração, é importante entender as diferenças entre a at.js e o SDK da Web da plataforma.

Diferenças operacionais

O SDK da Web da Platform combina a funcionalidade de vários aplicativos Adobe em uma única biblioteca. Essa abordagem unificada significa que você deve considerar as responsabilidades e os processos entre equipes para garantir uma implementação saudável.

at.js 2.x do Target
SDK da Web da Platform
Propriedade
A biblioteca da at.js é independente de outras bibliotecas de aplicativos. As personalizações e a propriedade dessas bibliotecas diferentes podem se alinhar a equipes diferentes na organização.
A biblioteca de SDK da Web da Platform e os dados transmitidos são unificados para todos os aplicativos Adobe. A propriedade da implementação do SDK da Web da Platform deve representar as partes interessadas de todos os aplicativos downstream.
Manutenção
Equipes separadas podem trabalhar nos aprimoramentos de implementação para cada aplicativo do Adobe, como Target e Analytics.
Idealmente, uma única equipe deve ser responsável pelos aprimoramentos que afetam a implementação do SDK da Web da plataforma.
Processo
As alterações em uma implementação do Target podem seguir um processo que tem uma cadência ou requisitos de controle de qualidade diferentes em comparação a outros aplicativos, como o Analytics.
As alterações na implementação do SDK da Web de uma plataforma devem considerar todos os aplicativos downstream e o processo de controle de qualidade e publicação deve ser ajustado de acordo.
Colaboração
Os dados específicos do Target podem ser transmitidos diretamente nas chamadas do Target. Dependendo da implementação, pode haver chamadas adicionais do Target. Isso não tem impacto direto nos dados do Adobe Analytics e a coordenação com a equipe de análise não é tão crítica.
Os dados transmitidos em chamadas de SDK da Web da plataforma podem ser encaminhados para o Target e para o Analytics. É necessária coordenação entre as equipes para garantir que as alterações não afetem negativamente um aplicativo específico.

Diferenças técnicas

O SDK da Web da Platform não é uma evolução da biblioteca at.js do Target. É uma abordagem nova e unificada para implementar todos os aplicativos Adobe para o canal da Web. Há várias diferenças técnicas que devem ser consideradas.

at.js 2.x do Target
SDK da Web da Platform
Funcionalidade de biblioteca
A funcionalidade do Target fornecida pela at.js. Integrações com outros aplicativos fornecidos pelo Visitor.js e AppMeasurement.js
Funcionalidade para todos os aplicativos Adobe fornecidos por uma única biblioteca de SDK da Web da plataforma: alloy.js
Desempenho
A at.js é uma das várias bibliotecas que devem ser carregadas para a integração adequada entre os aplicativos. Isso resulta em tempo de carregamento inferior ao ideal.
O SDK da Web da Platform é uma única biblioteca leve que elimina a necessidade de várias bibliotecas específicas do aplicativo, resultando em um melhor desempenho do carregamento da página.
Solicitações
Chamadas separadas para cada aplicativo Adobe. As chamadas do Target são em grande parte independentes das outras chamadas de rede.
Uma única chamada para todos os aplicativos Adobe. As alterações nos dados transmitidos nessas chamadas podem afetar vários aplicativos downstream.
Pedido de carregamento
A integração adequada com outros aplicativos Adobe requer uma ordem de carregamento específica de bibliotecas e chamadas de rede.
A integração adequada não depende da compilação de dados de chamadas de rede diferentes específicas do aplicativo, portanto, a ordem de carregamento não é uma preocupação.
Edge Network
Usa o Edge Network Adobe Experience Cloud (tt.omtrdc.net), opcionalmente com um CNAME específico do Target.
Usa o Edge Network Adobe Experience Platform (edge.adobedc.net), opcionalmente com um único CNAME.
Terminologia básica
Nomeação do at.js:
- mbox
- pageLoad evento (mbox global)
- offer
Equivalente ao SDK da Web da plataforma:
- decisionScope
- __view__ decisionScope
- proposition

Visão geral do vídeo

O vídeo a seguir fornece uma visão geral do SDK da Web da Adobe Experience Platform e do Edge Network Adobe Experience Platform.

https://video.tv.adobe.com/v/37265/?learn=on&captions=por_br

Agora que você entende as diferenças de alto nível entre a at.js e o SDK da Web da Platform, é possível planejar a migração.

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 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