Documentação Experience Platform Adobe Analytics para Web SDK usando tags

Migrar o Adobe Analytics para o Web SDK usando tags

Última atualização: 5 de maio de 2025

Tópicos:

Criado para:

Intermediário
Experiente
Desenvolvedor

Saiba mais sobre as etapas para migrar uma implementação do Adobe Analytics usando a extensão do Analytics em Tags de Experience Platform (conhecida anteriormente como Launch) para o Web SDK, usando a extensão do Web SDK também em Tags. Quando a extensão do Adobe Analytics em tags é usada, nos bastidores o código "AppMeasurement.js" está sendo usado. Portanto, você pode pensar nisso como um tutorial que está migrando o AppMeasurement para o Web SDK, mas este tutorial está totalmente em Tags e NÃO abrange a movimentação para ou de uma implementação do JavaScript (com exceção do código JavaScript usado na interface do usuário de Tags). Para migração de implementações do JavaScript, consulte a documentação.

OBSERVAÇÃO

Tutoriais de migração semelhantes estão disponíveis para:

CUIDADO

Como o Platform Web SDK suporta várias aplicações Adobe, todas as bibliotecas de Adobe em uma determinada página devem ser migradas ao mesmo tempo. Por exemplo, uma implementação mista do Web SDK para Target e AppMeasurement para Analytics em uma única página não é suportada. No entanto, há suporte para uma implementação mista em páginas diferentes, por exemplo, Web SDK na página A e at.js com AppMeasurement na página B.

O que você aprenderá com este tutorial

Antes de seguirmos as etapas de migração da sua implementação do Analytics, é importante que você entenda exatamente o que estará fazendo, ou seja, alterando/atualizando a implementação do Analytics. Ao final deste tutorial, quando você entra em seus relatórios e tudo é o mesmo, você pode se perguntar: "Por que fiz tudo isso?" Existem outros documentos para destacar os benefícios de usar o Web SDK para a implementação do Analytics, mas alguns são:

Suporte para ID de dispositivo próprio
Melhor desempenho
Prova de obsolescência de sua implementação à medida que você avança para o uso de aplicativos do Adobe Experience Platform (habilitando novos casos de uso)

Entre em contato com seu representante da Adobe Analytics para saber mais sobre como a Web SDK pode ajudar você. À medida que avançamos com este tutorial, nos concentraremos em como para fazer a migração.

IMPORTANT

É importante observar que um dos principais motivos pelos quais você está fazendo essa migração da sua implementação é para se preparar para usar os aplicativos da Adobe Experience Platform, como o Customer Journey Analytics, Real-Time CDP ou Journey Optimizer (conforme observado em #3 acima). Usar os dados do site para essa finalidade incluirá etapas adicionais que não estão incluídas neste tutorial, mas este tutorial certamente será um pré-requisito para esse avanço adicional da implementação. Portanto, siga este tutorial e execute as etapas necessárias para enviar esses mesmos dados do site para o Experience Platform.

Método de migração

Provavelmente, há muitas maneiras de fazer esse processo de migração, mas precisamos conversar sobre dois exatamente aqui:

Método 1: atualize sua propriedade Tags existente para o Web SDK, criando novos elementos de dados e fazendo alterações nas regras que já existem em sua propriedade.

Método 2: Você também pode criar uma nova propriedade (copiando a existente ou criando uma nova) e depois configurar essa nova propriedade com o Web SDK em vez da extensão do Adobe Analytics.

Neste tutorial de migração, vamos usar o Método 1. Dessa forma, os códigos incorporados associados à propriedade já estão incorporados aos seus sites de desenvolvimento, preparo e produção, portanto, não será necessário alterar nenhum código incorporado. Se você decidir seguir com o Método 2, não se esqueça de obter os novos códigos incorporados para cada ambiente da seção Ambientes da nova propriedade e colocá-los na seção de cabeçalho do site.

NOTE

Embora editemos nossa propriedade existente em Tags durante essa migração, ainda é uma boa ideia ter cuidado. Portanto, é altamente recomendável fazer uma cópia da propriedade atual antes de iniciar a migração. Dessa forma, você sempre pode acessar a cópia e ver como as coisas eram antes de alterá-las, extrair o código dela etc.
É bom ter cuidado, por via das dúvidas. Vá em frente e faça a cópia da propriedade. Vou esperar aqui até você voltar.

Etapas para migrar a implementação do Analytics para o Web SDK

À medida que você percorre as etapas, é importante compreender algumas limitações:

Primeiro, você pode ou não precisar de todas essas etapas. Por exemplo, há uma lição sobre a migração de código personalizado. Se você tiver uma implementação de Tags que não usa código personalizado (incluindo o uso de Plug-ins), não será necessária esta lição. Tentamos incluir as lições que seriam necessárias para a maioria das pessoas, portanto, leia pelo menos as lições para ver se você precisa fazer ajustes no site durante a migração.
Além disso, não há como criar um tutorial de migração que abrangerá 100% dos casos de uso que todos estão usando. Como dito no item anterior, tentamos incluir as lições que a maioria das pessoas precisará e que cobrirão a maioria dos principais casos de uso. No entanto, haverá, sem dúvida, casos de uso que não serão abordados neste tutorial. Nesse caso, veja se as lições incluídas fornecem uma boa ideia de como você deve migrar para o seu caso de uso. Você também pode solicitar que seus colegas da Comunidade Experience League coletem dados.

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

Crie um conjunto de relatórios de validação de migração.
Criar e configurar um fluxo de dados.
Adicione e configure a extensão Web SDK em Tags (antigo Adobe Launch).
Crie um novo elemento de dados para enviar dados pelo Web SDK.
Migre sua regra de carregamento de página padrão para usar o elemento de dados e as ações do Web SDK.
Migrar código personalizado em regras ou para plug-ins.
Publish suas alterações de implementação.
Entenda como depurar e validar suas alterações e como validar sua regra de carregamento de página padrão e as variáveis associadas a ela. Essa validação deve continuar durante toda a migração, à medida que você faz alterações.
Migrar regras de carregamento de página adicionais.
Migrar regras de links personalizados.
Após a validação completa, remova as referências à extensão do Analytics e remova a própria extensão.
Depois de fazer todas as alterações, envie a biblioteca para preparo e, em seguida, para produção.
Depois que tudo estiver concluído, teste novamente. Isso é necessário porque você fez alterações removendo as referências ao código antigo do Analytics e deseja garantir que tudo ainda funcione corretamente.

NOTE

Temos o compromisso de ajudar você a ter sucesso com a migração do Analytics para o Web SDK. Se você encontrar obstáculos com sua migração ou achar que há informações críticas ausentes neste guia, fale conosco ao postar em esta discussão da comunidade.

recommendation-more-help