DocumentaçãoAnalyticsGuia de Implementação

Enviar dados para a Adobe Analytics usando a biblioteca JavaScript da Web SDK

Last update: Fri Sep 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário
  • Administrador

Esse caminho de implementação envolve uma instalação nova do Web SDK usando a biblioteca JavaScript do Web SDK. Outros caminhos de implementação são abordados em páginas separadas:

  • Extensão de marca do Web SDK: uma nova instalação do Web SDK usando a extensão de marca do Web SDK. Semelhante à abordagem da biblioteca JavaScript do Web SDK (esta página), exceto que você gerencia a implementação usando tags na Coleção de dados da Adobe Experience Platform. Ele requer o grupo de campos Adobe Analytics ExperienceEvent, que inclui variáveis típicas do Analytics para serem incluídas no esquema XDM.
  • Extensão do Analytics para a extensão do Web SDK: adote uma abordagem suave e metódica para mover da extensão de marcas da Adobe Analytics para a extensão de marcas do Web SDK. Essa abordagem elimina a necessidade de usar o XDM até que sua organização esteja pronta para usar os serviços da Adobe Experience Platform, como o Customer Journey Analytics. Use o objeto data em vez do objeto xdm para enviar dados ao Adobe.
  • Biblioteca JavaScript do AppMeasurement para Web SDK: uma abordagem suave e metódica para migrar para o Web SDK, exceto por não usar marcas. Em vez disso, você pode remover manualmente a biblioteca de coleta de dados do Adobe Analytics (AppMeasurement.js) e substituí-la pela biblioteca JavaScript do Web SDK (alloy.js).

Vantagens e desvantagens desse caminho de implementação

O uso da biblioteca JavaScript do Web SDK para enviar dados para o Adobe Analytics tem vantagens e desvantagens. Avalie cuidadosamente cada opção para decidir qual abordagem é a melhor para sua organização.

Vantagens
Desvantagens
  • Abordagem direta: esse caminho de implementação é mais simples do que as abordagens que movem implementações existentes do Adobe Analytics. Se você não tiver uma implementação atual do Adobe Analytics com a qual se preocupar, preencha os campos XDM aplicáveis do Web SDK.
  • Esquema predefinido: se sua organização não tiver uma necessidade para seu próprio esquema, você pode simplesmente usar o esquema direcionado para a Adobe Analytics. Esse conceito se aplica mesmo quando você avança em direção ao Customer Journey Analytics; o conceito de props e eVars não se aplica ao Customer Journey Analytics, mas você pode continuar usando props e eVars como dimensões personalizadas simples.
  • As alterações na implementação exigem intervenção do desenvolvedor: se você quiser fazer alterações na implementação do Web SDK, deverá trabalhar com a equipe de desenvolvimento para editar o código no site. A abordagem que usa a extensão de tag do Web SDK evita essa desvantagem.
  • Bloqueado para usar um esquema específico: quando sua organização mudar para o Customer Journey Analytics, você deve optar por continuar usando o esquema do Adobe Analytics ou migrar para o esquema de sua própria organização (que seria um conjunto de dados separado). Se a sua organização quiser evitar o esquema do Adobe Analytics e a migração para um conjunto de dados separado ao migrar para o Customer Journey Analytics, a Adobe recomenda um dos dois métodos a seguir:
    • Usar o objeto data: o objeto data permite enviar dados para a Adobe Analytics sem estar em conformidade com um esquema XDM. Depois que o esquema da sua organização for criado, você poderá usar o mapeamento de sequência de dados para mapear campos de objeto data para o XDM. A extensão do Analytics para a extensão do Web SDK e a biblioteca JavaScript do AppMeasurement para o Web SDK usam este objeto data.
    • Ignorar totalmente o Adobe Analytics: se estiver implementando a Web SDK, você poderá enviar esses dados para um conjunto de dados na Adobe Experience Platform para uso no Customer Journey Analytics. Você pode usar qualquer esquema que desejar; a Adobe Analytics não está envolvida nesse fluxo de trabalho e, portanto, não requer o grupo de campos Adobe Analytics ExperienceEvent. Este método incorre no menor montante de dívida técnica, mas também deixa a Adobe Analytics totalmente fora de contexto.
IMPORTANT
Esse método de implementação exige que você use um esquema configurado para o Adobe Analytics. Se sua organização planejar usar seu próprio esquema com a Customer Journey Analytics no futuro, o uso do esquema da Adobe Analytics poderá criar confusão para administradores de dados ou arquitetos. Há várias opções para atenuar esse obstáculo:
  • Você pode usar o esquema do Adobe Analytics no CJA. Observe que o CJA não tem um conceito de props ou eVars; eles são tratados como qualquer outro campo de esquema. Observe também que o uso do esquema do Adobe Analytics no CJA pode dificultar o uso de outros serviços de plataforma, como o Adobe Journey Optimizer ou o Real-Time Customer Data Platform.
  • Você pode usar o objeto de dados, de modo semelhante a um fluxo de trabalho de migração. Observe que o uso do objeto de dados exige o mapeamento de cada campo de objeto de dados para um campo de esquema XDM.
  • Você pode ignorar completamente a implementação do Adobe Analytics e enviar dados para o Adobe Experience Platform usando seu próprio esquema. Essa abordagem é ideal a longo prazo e permite que sua organização comece a usar o Customer Journey Analytics.

Etapas necessárias para implementar a biblioteca JavaScript do Web SDK

Uma visão geral de alto nível das tarefas de implementação:

Como implementar o Adobe Analytics usando o fluxo de trabalho do Web SDK, conforme descrito nesta seção.

Tarefa
Mais informações
1
Certifique-se de que você definiu um conjunto de relatórios.
Gerenciador do conjunto de relatórios
2
Configurar esquemas. Para padronizar a coleta de dados para uso em aplicativos que utilizam a Adobe Experience Platform, a Adobe criou o padrão aberto e documentado publicamente, o Experience Data Model (XDM).
Visão geral da interface de esquemas
3
Criar uma camada de dados para gerenciar o rastreamento dos dados no seu site.
Criar uma camada de dados
4
Instalar a versão independente pré-criada. Você pode fazer referência à biblioteca (alloy.js) na CDN diretamente na sua página ou baixá-la e hospedá-la na sua própria infraestrutura. Como alternativa, você pode usar o pacote NPM.
Instalar a versão independente pré-criada e Usar o pacote NPM
5
Configurar uma sequência de dados. Uma sequência de dados representa a configuração do lado do servidor ao implementar o SDK da Web da Adobe Experience Platform.
Configurar uma sequência de dados
6
Adicionar um serviço do Adobe Analytics à sua sequência de dados. Esse serviço controla se e como os dados são enviados para o Adobe Analytics e para quais conjuntos de relatórios especificamente.
Adicionar o serviço Adobe Analytics a uma sequência de dados
7
Configurar o SDK da Web. Verifique se a biblioteca instalada na etapa 4 está configurada corretamente com a ID da sequência de dados (anteriormente conhecida como id de configuração de borda (datastreamId)), id da organização (orgId) e outras opções disponíveis. Garanta o mapeamento adequado das variáveis.
Configurar o Web SDK
mapeamento de variável de objeto XDM
8
Executar comandos e/ou rastrear eventos. Depois que o código base tiver sido implementado em sua página da Web, você poderá começar a executar comandos e rastrear eventos com o SDK.
Enviar eventos
9
Estender e validar sua implementação antes de empurrá-lo para a produção.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690