Assimilar dados por meio do SDK da Web da Adobe Experience Platform
Este guia de início rápido explica como você pode assimilar dados de rastreamento de site diretamente na Adobe Experience Platform usando o SDK da Web da Adobe Experience Platform e a Rede de borda e, em seguida, usar esses dados no Customer Journey Analytics.
Para isso, é necessário:
-
Configurar um esquema e um conjunto de dados na Adobe Experience Platform para definir o modelo (esquema) dos dados que você deseja coletar e onde realmente coletar os dados (conjunto de dados).
-
Configurar um armazenamento de dados para configurar a Rede de borda da Adobe Experience Platform para direcionar seus dados coletados para o conjunto de dados configurado na Adobe Experience Platform.
-
Usar tags para configurar regras e elementos de dados facilmente em relação aos dados na camada de dados do seu site. Em seguida, verifique se os dados são enviados para a sequência de dados configurada na Rede de borda da Adobe Experience Platform.
-
Implantar e validar. Tenha um ambiente em que possa interagir com o desenvolvimento de tags e, uma vez que tudo esteja validado, publique-o ao vivo no ambiente de produção.
-
Configurar uma conexão no Customer Journey Analytics. Essa conexão deve (pelo menos) incluir o conjunto de dados da Adobe Experience Platform.
-
Configurar uma visualização de dados no Customer Journey Analytics para definir métricas e dimensões que você deseja usar no Analysis Workspace.
-
Configurar um projeto no Customer Journey Analytics para criar relatórios e visualizações.
Configurar um esquema e um conjunto de dados
Para assimilar dados na Adobe Experience Platform, primeiro é necessário definir quais dados você deseja coletar. Todos os dados assimilados na Adobe Experience Platform devem estar em conformidade com uma estrutura padrão e desnormalizada para que sejam reconhecidos e utilizados pelos recursos e capacidades downstream. O Experience Data Model (XDM) é a estrutura padrão que fornece essa estrutura no formato de esquemas.
Após definir um esquema, use um ou mais conjuntos de dados para armazenar e gerenciar a coleta de dados. Um conjunto de dados é uma construção de armazenamento e gerenciamento para uma coleção de dados (normalmente uma tabela) que contém um esquema (colunas) e campos (linhas).
Todos os dados assimilados na Adobe Experience Platform devem estar em conformidade com um esquema predefinido antes que possam ser mantidos como um conjunto de dados.
Configurar um esquema
Você deseja rastrear o mínimo de dados de perfis que visitam seu site, por exemplo, nome de página e identificação.
Primeiro, você deve definir um esquema que modele esses dados.
Para configurar o esquema:
-
Na interface do usuário da Adobe Experience Platform, no painel esquerdo, selecione Esquemas no GERENCIAMENTO DE DADOS.
-
Selecione Criar esquema.
. -
Na etapa Selecionar uma classe do assistente Criar esquema:
-
Selecione Evento de experiência.
note info INFO Um esquema de Evento de Experiência é usado para modelar o comportamento de um perfil (como nome da cena, botão de push para adicionar ao carrinho). Um esquema de Perfil individual é usado para modelar os atributos de perfil (como nome, email, gênero). -
Selecione Próximo.
-
-
No Nome e na etapa de revisão do assistente Criar esquema:
-
Insira um nome para exibição do esquema para seu esquema e (opcional) uma Descrição.
-
Selecione Concluir.
-
-
Na guia Estrutura de Esquema de Exemplo:
-
Selecione + Adicionar em Grupos de campos.
Grupos de campos são coleções reutilizáveis de objetos e atributos que permitem estender facilmente o esquema.
-
Na caixa de diálogo Adicionar grupos de campos, selecione o grupo de campos SDK da Web ExperienceEvent da AEP na lista.
É possível selecionar o botão de visualização para visualizar os campos que fazem parte desse grupo de campos, como
web > webPageDetails > name
.Selecione Voltar para fechar a visualização.
-
Selecione Adicionar grupos de campos.
-
-
Selecione + ao lado do nome do esquema no painel Estrutura.
-
No painel Propriedades do campo, digite
Identification
como nome, Identificação como Nome de exibição, selecione Objeto como Tipo e selecione ExperienceEvent Core v2.1 como Grupo de campos.note note NOTE Se esse grupo de campos não estiver disponível, procure outro grupo de campos que contenha campos de identidade. Ou crie um novo grupo de campos e adicione novos campos de identidade (como ecid
,crmId
e outros que você precise) ao grupo de campos e selecione esse novo grupo de campos.O objeto de identificação adiciona recursos de identificação ao esquema. No seu caso, você deseja identificar os perfis que visitam seu site usando a ID do Experience Cloud e o endereço de email. Há muitos outros atributos disponíveis para rastrear a identificação da pessoa (por exemplo, ID do cliente, ID de fidelidade).
Selecione Aplicar para adicionar esse objeto ao esquema.
-
Selecione o campo ecid no objeto de identificação que você acabou de adicionar e selecione Identidade e Identidade principal e ECID do Namespace de identidade no painel direito.
Você está especificando a Experience Cloud Identity como a identidade principal que o serviço Adobe Experience Platform Identity pode usar para combinar (compilar) o comportamento dos perfis com a mesma ECID.
Selecione Aplicar. Você verá um ícone de impressão digital no atributo ecid.
-
Selecione o email no objeto de identificação que você acabou de adicionar e selecione Identidade e Email na lista Namespace de identidade no painel Propriedades do campo.
Você está especificando o endereço de email como outra identidade que o serviço Adobe Experience Platform Identity pode usar para combinar (compilar) o comportamento dos perfis.
Selecione Aplicar. Você vê que um ícone de impressão digital aparece no atributo de email.
Selecione Salvar.
-
Selecione o elemento raiz do esquema que exibe o nome dele e selecione a opção Perfil.
Você deve habilitar o esquema para o perfil. Depois de ativados, quando os dados são assimilados em conjuntos de dados com base nesse esquema, esses dados são mesclados ao Perfil do cliente em tempo real.
Consulte Ativar o esquema para usar no Perfil do cliente em tempo real para obter mais informações.
note important IMPORTANT Depois de salvar um esquema ativado para perfil, ele não pode mais ser desativado para perfil. -
Selecione Salvar para salvar o esquema.
Você criou um esquema mínimo que modela os dados que pode capturar de seu site. O esquema permite que os perfis sejam identificados usando a Experience Cloud Identity e o endereço de email. Ao ativar o esquema para o perfil, você garante que os dados capturados de seu site sejam adicionados ao Perfil do cliente em tempo real.
Ao lado dos dados de comportamento, você também pode capturar os dados do atributo de perfil do site (por exemplo, detalhes de perfis que assinam um boletim informativo).
Para capturar esses dados de perfil, você deve:
-
Criar um esquema com base na classe Perfil individual XDM.
-
Adicionar o grupo de campos Profile Core v2 ao esquema.
-
Adicionar um objeto de identificação com base no grupo de campos Profile Core v2.
-
Defina a ID do Experience Cloud como identificador principal e o email como identificador.
-
Ativar o esquema do perfil
Consulte Criar e editar esquemas na interface do usuário para obter mais informações sobre a adição e remoção de grupos de campos e campos individuais a um esquema.
Configurar um conjunto de dados
Com seu esquema, você definiu seu modelo de dados. Agora é necessário definir a construção para armazenar e gerenciar esses dados, o que é feito por meio de conjuntos de dados.
Para configurar seu conjunto de dados:
-
Na interface do usuário da Adobe Experience Platform, no painel esquerdo, selecione Conjuntos de dados no GERENCIAMENTO DE DADOS.
-
Selecione Criar conjunto de dados.
-
Selecione Criar conjunto de dados a partir do esquema.
-
Selecione o esquema criado anteriormente e selecione Próximo.
-
Nomeie seu conjunto de dados e (opcional) forneça uma descrição.
-
Selecione Concluir.
-
Selecione a opção Perfil.
Você deve habilitar o conjunto de dados para perfil. Depois de habilitado, o conjunto de dados enriquece os perfis do cliente em tempo real com seus dados assimilados.
note important IMPORTANT Você só pode habilitar um conjunto de dados para perfil quando o esquema, ao qual o conjunto de dados corresponde, também estiver habilitado para perfil.
Consulte Guia da interface do usuário de conjuntos de dados para obter muito mais informações sobre como visualizar, visualizar, criar, excluir um conjunto de dados. E como ativar um conjunto de dados para o Perfil do cliente em tempo real.
Configurar um fluxo de dados
Uma sequência de dados representa a configuração do lado do servidor ao implementar os SDKs móveis e da Web da Adobe Experience Platform. Ao coletar dados com os SDKs da Adobe Experience Platform, os dados são enviados para a Rede de borda da Adobe Experience Platform. É o fluxo de dados que determina para quais serviços esses dados são encaminhados.
Em sua configuração, você deseja que os dados coletados do site sejam enviados para seu conjunto de dados na Adobe Experience Platform.
Para configurar seu armazenamento de dados:
-
Na interface do usuário da Adobe Experience Platform, selecione Sequências de dados em COLEÇÃO DE DADOS no painel esquerdo.
-
Selecione Novo fluxo de dados.
-
Nomeie e descreva o armazenamento de dados. Selecione o esquema na lista Esquema do evento.
-
Selecione Salvar.
-
Selecione Adicionar serviço.
-
Na tela Adicionar serviço:
-
Selecione Adobe Experience Platform na lista Serviço.
-
Verifique se a opção Ativado está selecionada.
-
Selecione o conjunto de dados na lista Conjunto de dados do evento.
-
Deixe as outras configurações e selecione Salvar para salvar a sequência de dados.
-
O conjunto de dados agora está configurado para encaminhar os dados coletados de seu site para seu conjunto de dados na Adobe Experience Platform.
Consulte Visão geral dos conjuntos de dados para obter mais informações sobre como configurar um conjunto de dados e como lidar com dados confidenciais.
Usar tags
Para implementar o código em seu site para realmente coletar dados, use o recurso de Tags no Adobe Experience Platform. Esta solução de gerenciamento de tags permite implantar o código do junto com outros requisitos de marcação. As tags oferecem integração perfeita com a Adobe Experience Platform usando a extensão do SDK da Web da Adobe Experience Platform.
Criar sua tag
-
Na interface do usuário da Adobe Experience Platform, no painel esquerdo, selecione Tags em COLEÇÃO DE DADOS.
-
Selecione Nova propriedade.
Nomeie a tag, selecione Web e insira um nome de domínio. Selecione Salvar para continuar.
Configurar sua tag
Depois de criar a tag, você deve configurá-la com as extensões corretas e configurar os elementos de dados e as regras de acordo com como deseja rastrear seu site e enviar dados para a Adobe Experience Platform.
Selecione a tag criada recentemente na lista de Propriedades da tag para abri-la.
Extensões
Para garantir que você possa enviar dados para a Adobe Experience Platform (por meio de sua sequência de dados), adicione a extensão SDK da Web da Plataforma Adobe à sua tag.
Para criar e configurar a extensão do SDK da Web da Adobe Experience Platform:
-
Selecione Extensões no painel esquerdo.
-
Selecione Catálogo na barra superior.
-
Procure ou role a tela até a extensão do SDK da Web da Adobe Experience Platform e selecione Instalar para instalá-la.
{width="35%"}
-
Selecione a sandbox e a sequência de dados criadas anteriormente para o Ambiente de produção, o Ambiente de preparo (opcional) e o Ambiente de desenvolvimento.
Selecione Salvar.
Consulte Configurar a extensão do SDK da Web da Adobe Experience Platform para obter mais informações.
O SDK da Web inclui o Serviço da Adobe Experience Cloud ID nativamente, portanto, não é necessário adicionar a extensão do serviço de ID à sua marca.
Elementos de dados
Os elementos de dados são os blocos fundamentais do seu dicionário de dados (ou mapa de dados). Use elementos de dados para coletar, organizar e entregar dados em toda a tecnologia de marketing e anúncios. Você configura elementos de dados na tag que são lidos a partir da camada de dados e podem ser usados para fornecer dados à Adobe Experience Platform.
Há diferentes tipos de elementos de dados. Primeiro, configure um elemento de dados para capturar o nome da página que as pessoas estão visualizando no site.
Para definir um elemento de dados de nome de página:
-
Selecione Elementos de dados no painel esquerdo.
-
Selecione Adicionar elemento de dados.
-
Na caixa de diálogo Criar elemento de dados:
-
Nomeie seu elemento de dados, por exemplo
Page Name
. -
Selecione Núcleo na lista Extensão.
-
Selecione Informações da página na lista Tipo de elemento de dados.
-
Selecione Título na lista Atributo.
Como alternativa, você pode usar o valor de uma variável da camada de dados, por exemplo
pageName
e o tipo de elemento de dados da Variável JavaScript para definir o elemento de dados. -
Selecione Salvar.
-
Agora você deseja configurar um elemento de dados que faça referência à ID da Experience Cloud, fornecida automaticamente pelo SDK da Web da Adobe Experience Platform e disponível por meio da extensão do Serviço da Experience Cloud ID.
Para definir um elemento de dados da ECID:
-
Selecione Elementos de dados no painel esquerdo.
-
Selecione Adicionar elemento de dados.
-
Na caixa de diálogo Criar elemento de dados:
-
Nomeie seu elemento de dados, por exemplo
ECID
. -
Selecione Serviço da Experience Cloud ID da lista Extensão.
-
Selecione ECID na lista Tipo de elemento de dados.
-
Selecione Salvar.
-
Por fim, agora é possível mapear qualquer um dos elementos de dados específicos para o esquema definido anteriormente. Você define outro elemento de dados que fornece uma representação do esquema XDM.
Para definir um elemento de dados de objeto XDM:
-
Selecione Elementos de dados no painel esquerdo.
-
Selecione Adicionar elemento de dados.
-
Na caixa de diálogo Criar elemento de dados:
-
Nomeie seu elemento de dados, por exemplo
XDM - Page View
. -
Selecione SDK da Web da Adobe Experience Platform na lista Extensão.
-
Selecione Objeto XDM na lista Tipo de elemento de dados.
-
Selecione a sandbox na lista Sandbox.
-
Selecione o esquema na lista Esquema.
-
Mapeie o atributo
identification > core > ecid
, definido no esquema, no elemento de dados da ECID. Selecione o ícone de cilindro para escolher facilmente o elemento de dados da ECID na lista de elementos de dados. -
Mapeie o atributo
web > webPageDetails > name
, definido no esquema, para o elemento de dados Nome da página. -
Selecione Salvar.
-
Regras
As tags na Adobe Experience Platform seguem um sistema baseado em regras. Elas buscam a interação do usuário e dados associados. Quando os critérios definidos nas regras são cumpridos, a regra aciona a extensão, o script ou o código do lado do cliente identificado. Você pode usar regras para enviar dados (como um objeto XDM) para a Adobe Experience Platform usando a extensão do SDK da Web da Adobe Experience Platform.
Para definir uma regra:
-
Selecione Regras no painel esquerdo.
-
Selecione Criar nova regra.
-
Na caixa de diálogo Criar regra:
-
Nomeie a regra, por exemplo
Page View
. -
Selecione + Adicionar abaixo de Eventos.
-
Na caixa de diálogo Configuração de evento:
-
Selecione Núcleo na lista Extensão.
-
Selecione Janela carregada na lista Tipo de evento.
-
Selecione Manter alterações.
-
-
Selecione + Adicionar abaixo de Ações.
-
Na caixa de diálogo Configuração de ação:
-
Selecione SDK da Web da Adobe Experience Platform na lista Extensão.
-
Selecione Enviar evento na lista Tipo de ação.
-
Selecione web.webpagedetails.pageViews na lista Tipo.
-
Selecione o ícone do cilindro ao lado de Dados XDM e Selecione XDM - Exibição de página na lista de elementos de dados.
- Selecione Manter alterações.
-
-
Sua regra deve ter a seguinte aparência:
-
Selecione Salvar.
-
O exposto acima é apenas um exemplo de definição de uma regra que envia dados XDM, contendo valores de outros elementos de dados, para o Adobe Experience Platform.
Você pode usar as regras de várias maneiras na tag para manipular variáveis (usando os elementos de dados).
Consulte Regras de para obter mais informações.
Criar e publicar a tag
Depois de definir elementos de dados e regras, você deve criar e publicar sua tag. Ao criar um build de biblioteca, você deve atribuí-lo a um ambiente. As extensões, regras e elementos de dados da build são compilados e colocados no ambiente atribuído. Cada ambiente fornece um código integrado exclusivo que permite integrar a build atribuída ao site.
Para criar e publicar a tag:
-
Selecione Fluxo de publicação no painel esquerdo.
-
Selecione Selecionar uma biblioteca de trabalho, seguida de Adicionar biblioteca….
-
Na caixa de diálogo Criar biblioteca:
-
Dê um nome para a biblioteca.
-
Selecione Desenvolvimento na lista suspensa Ambiente.
-
Clique em + Adicionar todos os recursos alterados.
-
Selecione Salvar e criar no desenvolvimento.
A tag é salva e é criada para o ambiente de desenvolvimento. Um ponto verde indica uma criação bem-sucedida da tag no ambiente de desenvolvimento.
-
-
Você pode selecionar … para recriar a biblioteca ou mover a biblioteca para um ambiente de preparo ou produção.
As tags da Adobe Experience Platform são compatíveis com fluxos de trabalho de publicação simples e complexos, que devem acomodar a implantação do SDK da Web da Adobe Experience Platform.
Consulte Visão geral de publicação para obter mais informações.
Recuperar o código da tag
Por fim, você deve instalar sua tag no site que deseja rastrear, o que implica colocar o código na tag de cabeçalho do modelo do site.
Para obter o código que faz referência à sua tag:
-
Selecione Ambientes no painel esquerdo.
-
Na lista de ambientes, selecione o botão de instalação correto (caixa).
Na caixa de diálogo Instruções de instalação da Web clique no botão copiar ao lado do código de script que deve ser lido como:
code language-none <script src="https://assets.adobedtm.com/2a518741ab24/.../launch-...-development.min.js" async></script>>
-
Selecione Fechar.
Em vez do código para o ambiente de desenvolvimento, você pode ter selecionado outro ambiente (armazenamento temporário, produção) com base em onde você está no processo de implantação do SDK da Web da Adobe Experience Platform.
Consulte Ambientes para obter mais informações.
Implantar e validar
Agora você pode implantar o código na versão de desenvolvimento do seu site dentro da tag <head>
. Quando implantado, seu site começa a coletar dados na Adobe Experience Platform.
Valide a implementação, corrija-a sempre que necessário e, uma vez correto, implante-a no ambiente de preparo e produção usando o recurso de fluxo de trabalho de publicação Tags.
Configurar uma conexão
Para usar os dados da Adobe Experience Platform no Customer Journey Analytics, crie uma conexão que inclua os dados resultantes da configuração do esquema, do conjunto de dados e do fluxo de trabalho.
Uma conexão permite integrar conjuntos de dados da Adobe Experience Platform ao Espaço de trabalho. Para criar relatórios sobre esses conjuntos de dados, primeiro é necessário estabelecer uma conexão entre os conjuntos de dados na Adobe Experience Platform e no Workspace.
Para criar sua conexão:
-
Na interface do usuário do Customer Journey Analytics, selecione Conexões na navegação superior.
-
Selecione Criar nova conexão.
-
Na tela Conexão sem título:
Nomeie e descreva sua conexão em Configurações de conexão.
Selecione a sandbox correta na lista Sandbox em Configurações de dados e selecione o número de eventos diários na lista Número médio de eventos diários.
Selecione Adicionar conjuntos de dados.
Na etapa Selecionar conjuntos de dados em Adicionar conjuntos de dados:
-
Selecione o conjunto de dados criado anteriormente (
Example dataset
) e qualquer outro conjunto de dados que você deseja incluir em sua conexão. -
Selecione Próximo.
Na etapa Configurações de conjuntos de dados em Adicionar conjuntos de dados:
-
Para cada conjunto de dados:
-
Selecione uma ID de pessoa a partir das identidades disponíveis definidas nos esquemas de conjunto de dados da Adobe Experience Platform.
-
Selecione a fonte de dados correta na lista Tipo de fonte de dados. Se você especificar Outros, em seguida, adicione uma descrição para a fonte de dados.
-
Definir Importar todos os novos dados e Preenchimento retroativo de conjunto de dados com dados existentes de acordo com suas preferências.
-
-
Selecione Adicionar conjuntos de dados.
Selecione Salvar.
-
Consulte Visão geral das conexões para obter mais informações sobre como criar e gerenciar uma conexão e como selecionar e combinar conjuntos de dados.
Configurar uma visualização de dados
Uma visualização de dados é um container específico do Customer Journey Analytics que permite determinar como interpretar dados de uma conexão. Ele especifica todas as dimensões e métricas disponíveis no Analysis Workspace e de quais colunas elas obtêm seus dados. As visualizações de dados são definidas na preparação de relatórios no Analysis Workspace.
Para criar a visualização de dados:
-
Na interface do usuário do Customer Journey Analytics, selecione Visualizações de dados na navegação superior.
-
Selecione Criar nova visualização de dados.
-
Na etapa Configurar:
Selecione a conexão na lista Conexão.
Nomeie e (opcionalmente) descreva a conexão.
Selecione Salvar e continuar.
-
Na etapa Componentes:
Adicione qualquer campo de esquema e/ou componente padrão que deseja incluir às caixas de componentes MÉTRICAS ou DIMENSÃO.
Selecione Salvar e continuar.
-
Na etapa Configurações:
Configurações de
Deixe as configurações como estão e selecione Salvar e concluir.
Consulte Visão geral das visualizações de dados para obter mais informações sobre como criar e editar uma visualização de dados, quais componentes estão disponíveis para você usar na visualização de dados e como usar configurações de filtro e sessões.
Configurar um projeto
O Analysis Workspace é uma ferramenta de navegador flexível que permite criar análises e compartilhar insights rapidamente com base em dados. Os projetos do Espaço de trabalho permitem combinar componentes de dados, tabelas e visualizações para criar a análise e compartilhar com qualquer pessoa na organização.
Para criar o projeto:
-
Na interface do usuário do Customer Journey Analytics, selecione Projetos na navegação superior.
-
Selecione Projetos no painel de navegação esquerdo.
-
Selecione Criar projeto.
Selecione Projeto em branco.
-
Selecione a visualização de dados na lista.
.
-
Para criar seu primeiro relatório, comece a arrastar e soltar dimensões e métricas na Tabela de forma livre do Painel. Como exemplo, arraste
Program Points Balance
ePage View
como métricas eemail
como dimensão para obter uma visão geral rápida dos perfis que visitaram seu site e fazem parte do programa de fidelidade que coleta pontos.
Consulte Visão geral do Analysis Workspace para obter mais informações sobre como criar projetos e sua análise usando componentes, visualizações e painéis.