Resumo do processo
O processo de configuração da coleta de dados para seu site pode ser resumido da seguinte maneira:
- Crie um esquema para determinar como seus dados serão estruturados ao serem enviados para a Edge Network.
- Crie uma sequência de dados para configurar para quais destinos você deseja que seus dados sejam enviados.
- 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.
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.
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.
A tela Esquema é exibida, mostrando uma estrutura de árvore do esquema XDM, incluindo os campos fornecidos pelo grupo de campos do Web SDK.
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.
Para adicionar mais campos ao esquema, selecione Adicionar na seção Grupos de campos no painel esquerdo.
Depois de adicionar os campos necessários, selecione Salvar para 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.
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.
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.
O processo pode ser resumido da seguinte forma:
- Instale o Adobe Experience Platform Web SDK em uma propriedade de marca para obter acesso a seus recursos.
- Crie um elemento de dados Objeto XDM para mapear variáveis no seu site para a estrutura do esquema XDM criado anteriormente.
- Crie uma regra para informar à SDK quando ela deve enviar dados para a Edge Network.
- 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.
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.
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.
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.
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.
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.
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.
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.
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.
cartAbandonsTotal
) para um campo XDM, referenciando seu nome no campo Valor, com sinais de porcentagem (%
) de ambos os lados.Após concluir o mapeamento dos dados para o esquema, forneça um nome para o elemento de dados antes de selecionar Salvar.