Documentação Experience Platform Migraçã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 Oct 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

Intermediário
Experiente
Desenvolvedor

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:

Avalie sua implementação atual e determine uma abordagem de migração
Configure os componentes iniciais para conectar ao Edge Network Adobe Experience Platform
Atualize a implementação básica para substituir a at.js pelo SDK da Web da plataforma
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.
Atualizar objetos na interface do Target, como scripts de perfil, atividades e definições de público-alvo
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