DocumentaçãoAnalyticsGuia de Implementação

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

Last update: Thu Apr 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário
  • Administrador

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

  • Extensão de tag do SDK da Web: uma instalação nova do SDK da Web usando a extensão de tag do SDK da Web. Semelhante à abordagem da biblioteca JavaScript do SDK da Web (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 SDK da Web: adote uma abordagem suave e metódica para mover a extensão de tag da Adobe Analytics para a extensão de tag do SDK da Web. 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 data em vez do xdm objeto para enviar dados ao Adobe.
  • AppMeasurement para a biblioteca JavaScript do SDK da Web: uma abordagem suave e metódica para migrar para o SDK da Web, exceto pelo fato de que não usa tags. Em vez disso, você pode remover manualmente a biblioteca de coleta de dados do Adobe Analytics (AppMeasurement.js) e substitua-a pela biblioteca JavaScript do SDK da Web (alloy.js).

Vantagens e desvantagens desse caminho de implementação

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

Benefícios
Desvantagens
  • Abordagem direta: esse caminho de implementação é mais simples que as abordagens que movem as 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 do SDK da Web aplicáveis.
  • Esquema predefinido: se sua organização não tiver necessidade de ter seu próprio esquema, você pode simplesmente usar o esquema direcionado para o 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.
  • Alterações de implementação exigem intervenção do desenvolvedor: se quiser fazer alterações na implementação do SDK da Web, você deve trabalhar com a equipe de desenvolvimento para editar o código no site. A abordagem que utiliza a Extensão de tag do SDK da Web evita essa desvantagem.
  • Bloqueado no usando um schema específico: quando sua organização muda 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 mudar para o Customer Journey Analytics, o Adobe recomenda um dos dois métodos a seguir:
    • Use o data object: o 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 data campos de objeto para XDM. Ambos os Extensão do Analytics para a extensão SDK da Web e AppMeasurement para a biblioteca JavaScript do SDK da Web usar este data objeto.
    • Ignorar totalmente o Adobe Analytics: se estiver implementando o SDK da Web, você pode 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 planeja usar seu próprio esquema com o Customer Journey Analytics no futuro, o uso do esquema do Adobe Analytics pode 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 SDK da Web

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

Como implementar o Adobe Analytics usando o fluxo de trabalho do SDK da Web, 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 do fluxo de dados (anteriormente conhecida como ID de configuração de borda (edgeConfigId)), id da organização (orgId) e outras opções disponíveis. Garanta o mapeamento adequado das variáveis.
Configurar o SDK da Web
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