Resumo do processo

O processo de configuração da coleta de dados para seu site pode ser resumido da seguinte maneira:

  1. Crie um esquema para determinar como seus dados serão estruturados ao serem enviados para a Edge Network.
  2. Crie uma sequência de dados para configurar para quais destinos você deseja que seus dados sejam enviados.
  3. Instale e configure o Web SDK para enviar dados para a sequência de dados quando determinados eventos ocorrerem no site.

Depois de enviar dados para a Edge Network, você também poderá configurar o encaminhamento de eventos, se sua organização tiver uma licença para isso.

Criar um esquema

O Experience Data Model (XDM) é uma especificação de código aberto que fornece estruturas e definições comuns para dados na forma de esquemas. Em outras palavras, o XDM é uma maneira de estruturar e formatar seus dados de uma maneira que pode ser acionada pelo Edge Network e outros aplicativos da Adobe Experience Cloud.

A primeira etapa na configuração das operações de coleta de dados é criar um esquema XDM para representar seus dados. Em uma etapa posterior deste tutorial, você mapeará os dados que deseja enviar para a estrutura deste esquema.

NOTE
Os esquemas XDM são muito personalizáveis. Em vez de serem excessivamente prescritivas, as etapas descritas abaixo se concentram especificamente nos requisitos de esquema do Web SDK. Fora desses parâmetros, você pode definir a estrutura restante dos dados da maneira que desejar.

Na interface, selecione Esquemas na navegação à esquerda. Aqui, você pode ver uma lista de esquemas criados anteriormente que pertencem à sua organização. Para continuar, selecione Criar esquema e XDM ExperienceEvent no menu suspenso.

Espaço de trabalho de esquemas

Uma caixa de diálogo é exibida solicitando que você comece a adicionar grupos de campos ao esquema. Para enviar eventos usando o Web SDK, é necessário adicionar o grupo de campos AEP Web SDK ExperienceEvent Mixin. Este grupo de campos contém definições para atributos de dados que são coletados automaticamente pela biblioteca do Web SDK.

Use a barra de pesquisa para restringir a lista e ajudar a encontrar este grupo de campos mais facilmente. Depois de encontrá-lo, selecione-o na lista antes de selecionar Adicionar grupos de campos.

Espaço de trabalho de esquemas

A tela Esquema é exibida, mostrando uma estrutura de árvore do esquema XDM, incluindo os campos fornecidos pelo grupo de campos do Web SDK.

Estrutura de schema

Selecione o campo raiz na árvore para abrir as Propriedades do esquema no painel direito, onde você pode fornecer um nome e uma descrição opcional para o esquema.

Nomear o esquema

Para adicionar mais campos ao esquema, selecione Adicionar na seção Grupos de campos no painel esquerdo.

Adicionar grupos de campos

NOTE
Consulte o manual sobre adição de grupos de campos na documentação do XDM para obter etapas detalhadas sobre como pesquisar por diferentes grupos de campos para atender aos seus casos de uso.
A prática recomendada é adicionar campos somente para dados que você planeja enviar por meio da Edge Network. Depois de adicionar campos a um esquema e salvá-lo, somente alterações aditivas poderão ser feitas no esquema após isso. Consulte a seção sobre as regras de evolução do esquema para obter mais informações.

Depois de adicionar os campos necessários, selecione Salvar para salvar o esquema.

Salvar o esquema

Criar um fluxo de dados

Uma sequência de dados é uma configuração que informa à Edge Network para onde você deseja que seus dados sejam enviados. Especificamente, um fluxo de dados especifica para quais produtos da Experience Cloud você deseja enviar os dados e como você deseja que os dados sejam manipulados e armazenados em cada produto.

NOTE
Se você quiser usar o encaminhamento de eventos (supondo que sua organização esteja licenciada para a funcionalidade), será necessário habilitá-lo para uma sequência de dados da mesma forma que habilita os produtos da Adobe. Detalhes sobre este processo são abordados em uma seção posterior.

Selecione Datastreams na navegação à esquerda. Aqui, você pode selecionar uma sequência de dados existente na lista para editar, ou criar uma nova configuração selecionando Nova sequência de dados.

Datastreams

Os requisitos de configuração para uma sequência de dados dependem dos produtos e recursos para os quais você está enviando dados. Para obter informações detalhadas sobre as opções de configuração de cada produto, consulte a visão geral dos fluxos de dados.

Instalar e configurar o Web SDK

Depois de criar um esquema e um fluxo de dados, a próxima etapa é instalar e configurar o Experience Platform Web SDK para começar a enviar dados para a Edge Network.

NOTE
Esta seção usa a interface da Coleção de dados para configurar a extensão de tag do Web SDK, mas você também pode instalá-la e configurá-la usando código bruto. Consulte os seguintes guias para obter mais informações:
Observe também que mesmo que você deseje usar apenas o encaminhamento de eventos, ainda será necessário instalar e configurar o SDK conforme descrito antes de configurar o encaminhamento de eventos em uma etapa posterior.

O processo pode ser resumido da seguinte forma:

  1. Instale o Adobe Experience Platform Web SDK em uma propriedade de marca para obter acesso a seus recursos.
  2. Crie um elemento de dados Objeto XDM para mapear variáveis no seu site para a estrutura do esquema XDM criado anteriormente.
  3. Crie uma regra para informar à SDK quando ela deve enviar dados para a Edge Network.
  4. Crie e instale uma biblioteca para implementar a regra no seu site.

Instalar a SDK em uma propriedade de tag

Selecione Tags na navegação à esquerda para mostrar uma lista de propriedades de tags. Você pode escolher uma propriedade existente para editar, se desejar, ou pode selecionar Nova propriedade.

Propriedades

Se estiver criando uma nova propriedade, forneça um nome descritivo e defina a Plataforma como Web. Forneça o domínio completo para a propriedade da Web e selecione Salvar.

Criar propriedade

A página de visão geral da propriedade é exibida. Aqui, selecione Extensões na navegação à esquerda e Catálogo. Localize a listagem do Experience Platform Web SDK (opcionalmente, use a barra de pesquisa para restringir os resultados) e selecione Instalar.

Instalar o Web SDK

A página de configuração da SDK é exibida. A maioria dos valores obrigatórios é preenchida automaticamente com padrões que você pode alterar se desejar.

Configurar o Web SDK

No entanto, antes de instalar o SDK, você deve selecionar um fluxo de dados para que ele saiba para onde enviar seus dados. Em Datastreams, use o menu suspenso para selecionar a sequência de dados configurada em uma etapa anterior. Depois de definir a sequência de dados, selecione Salvar para concluir a instalação do SDK na propriedade.

Definir sequência de dados e salvar

Criar um elemento de dados XDM

Para que o SDK envie dados para o Edge Network, esses dados devem ser mapeados para o esquema XDM criado em uma etapa anterior. Esse mapeamento é realizado por meio do uso de um elemento de dados.

Na interface, selecione Elementos de Dados e Criar Novo Elemento de Dados.

Criar novo elemento de dados

Na próxima tela, selecione Adobe Experience Platform Web SDK na lista suspensa Extensão e selecione objeto XDM para o tipo de elemento de dados.

Tipo de objeto XDM

A caixa de diálogo de configuração é exibida para o tipo de objeto XDM. A caixa de diálogo seleciona automaticamente a sandbox da Experience Platform e, aqui, é possível ver todos os esquemas criados nessa sandbox. Selecione na lista o esquema XDM criado anteriormente.

Tipo de objeto XDM

A estrutura do schema é exibida. Todos os campos com um asterisco (*) indicam campos que serão preenchidos automaticamente quando os eventos forem acionados. Para todos os outros campos, é possível explorar a estrutura do esquema e preencher o restante dos dados.

Mapear dados para campos XDM

NOTE
A captura de tela acima demonstra como mapear uma variável globalmente acessível do lado do cliente do seu site (cartAbandonsTotal) para um campo XDM, referenciando seu nome no campo Valor, com sinais de porcentagem (%) de ambos os lados.
Você também pode usar outros elementos de dados criados anteriormente para preencher esses campos. Consulte a referência em elementos de dados na documentação das tags para obter mais informações.

Após concluir o mapeamento dos dados para o esquema, forneça um nome para o elemento de dados antes de selecionar Salvar.

Nomeie e salve o elemento de dados