Documentação Customer Journey Analytics Guia do Customer Journey Analytics

Assimilar dados por meio da API do servidor Edge Network

Última atualização: 4 de outubro de 2024

Tópicos:
Conceitos básicos

Criado para:

Administrador

Este guia de início rápido explica como você pode assimilar dados de rastreamento de dispositivos como dispositivos IoT, decodificadores de sinais, consoles de jogos, aplicativos de desktop diretamente no Adobe Experience Platform usando a API e Edge Network do servidor Edge Network da Adobe Experience Platform. Em seguida, use esses dados no Customer Journey Analytics.

Para isso, você deve:

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.
Use a API do Servidor para enviar dados diretamente do seu aplicativo ou jogo em execução em uma área de trabalho, console de jogos, dispositivo IoT ou decodificador de sinais para sua sequência de dados.
Implantar e validar. Tenha um ambiente em que possa interagir com o desenvolvimento e, uma vez tudo validado, publique-o em tempo real 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.

NOTE

Este guia de início rápido é um guia simplificado sobre como assimilar dados coletados de um aplicativo ou jogo em execução em um dispositivo IoT, decodificador de sinais, console de jogos ou desktop no Adobe Experience Platform e usar no Customer Journey Analytics. É altamente recomendável estudar as informações adicionais quando referidas.

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 uma 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 alguns dados mínimos de perfis que estão jogando seu jogo em um console, por exemplo, identificação, pontuações, progresso e outras informações.
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:
1. Selecione Evento de experiência.
  
  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).
2. Selecione Próximo.
No Nome e na etapa de revisão do assistente Criar esquema:
1. Insira um nome para exibição do esquema para seu esquema e (opcional) uma Descrição.
2. Selecione Concluir.
Na guia Estrutura de Esquema de Exemplo:
1. 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.
2. Na caixa de diálogo Adicionar grupos de campos, selecione o grupo de campos Luz oculta na lista. Este grupo de campo é criado para rastrear o progresso do usuário jogando um jogo fictício intitulado Blinding Light em um console.
  
  É possível selecionar o botão de visualização para visualizar os campos que fazem parte desse grupo de campos, como scores > afterMatch.
  
  Selecione Voltar para fechar a visualização.
3. Selecione Adicionar grupos de campos.
Selecione + próximo ao nome do esquema.
No painel Propriedades do Campo, digite identification como o Nome do Campo, Identificação como o Nome de exibição, selecione Objeto como o Tipo e selecione Núcleo do ExperienceEvent v2.1 como o Grupo de Campos.

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ê quer identificar os perfis que estão jogando usando a ID de Experience Cloud e o endereço de email que eles usam para fazer login no console de jogos deles. Há muitos outros atributos disponíveis para rastrear a identificação da sua pessoa.

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.

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 você pode capturar do seu jogo. O esquema permite que os perfis sejam identificados usando a Experience Cloud Identity e o endereço de email. Ao ativar o esquema para perfil, você garante que os dados capturados do seu jogo de console sejam adicionados ao Perfil do cliente em tempo real.

Ao lado dos dados de comportamento, você também pode capturar dados de atributos de perfil do seu console (por exemplo, detalhes de perfis conectados ao console).

Para capturar dados do 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 usando 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.

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 da Web e móvel da Adobe Experience Platform e a API do servidor Edge Network da Adobe Experience Platform. Ao coletar dados com os SDKs da Adobe Experience Platform e as APIs do servidor do Edge Network, os dados são enviados para o Edge Network da Adobe Experience Platform. É o fluxo de dados que determina para quais serviços esses dados são encaminhados.

Na configuração, você deseja que os dados coletados do jogo sejam enviados para o seu conjunto de dados no 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:
1. Selecione Adobe Experience Platform na lista Serviço.
2. Verifique se a opção Ativado está selecionada.
3. Selecione o conjunto de dados na lista Conjunto de dados do evento.
4. Deixe as outras configurações e selecione Salvar para salvar a sequência de dados.

Sua sequência de dados agora está configurada para encaminhar os dados coletados do jogo para seu conjunto de dados no 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 API do servidor Edge Network

No desenvolvimento do seu jogo, você pode adicionar chamadas relevantes à API do Adobe Experience Platform Edge Network Server, quando apropriado.

Por exemplo, para atualizar a pontuação do player, você usaria:

curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
   "event": {
      "xdm": {
         "identityMap": {
            "Email_LC_SHA256": [
               {
                  "id": "0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b",
                  "primary": true
               }
            ]
         },
         "eventType": "game.scoreUpdate",
         "{sandbox}": {
            "scores": {
               "afterMatch": 132391",
            }
         },
         "timestamp": "2021-08-09T14:09:20.859Z"
      }
   }
}'

No exemplo de solicitação POST, {DATASTREAM_ID} aponta para o identificador do exemplo de sequência de dados que você configurou anteriormente. {sandbox} é o nome exclusivo da sua sandbox, identificando o caminho para o grupo de campos Luz oculta personalizada.

Consulte Coleta de dados interativa e Coleta de dados não interativa para obter mais informações sobre como usar a API do servidor Edge Network.

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 conjuntos de dados criados anteriormente e/ou outros conjuntos de dados relevantes que 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.

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.

SUCCESS

Você concluiu todas as etapas. Começando por definir quais dados você deseja coletar (esquema) e onde armazená-los (conjunto de dados) no Adobe Experience Platform. Você configurou um fluxo de dados no Edge Network para garantir que os dados possam ser encaminhados para esse conjunto de dados. Em seguida, você usou a API do servidor Edge Network para enviar esses dados para o fluxo de dados. Você definiu uma conexão no Customer Journey Analytics para usar seus dados de jogos e outros dados. Sua definição de visualização de dados permitiu especificar quais dimensões e métricas usar e, finalmente, você criou seu primeiro projeto visualizando e analisando seus dados de jogo.

recommendation-more-help