Assimilar dados por meio da API do servidor de rede de borda da Adobe Experience Platform
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 na Adobe Experience Platform usando a API do servidor de rede de borda da Adobe Experience Platform e a rede de borda. 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.
-
Usar API do servidor para enviar dados diretamente de seu aplicativo ou jogo em execução em um desktop, 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.
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.
-
Selecionar Criar esquema. .
-
Na etapa Selecionar uma classe do assistente Criar esquema:
-
Selecionar 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 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 Nomear e revisar a etapa do Criar esquema assistente:
-
Insira um Nome de exibição do esquema para o 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.
-
No Adicionar grupos de campos , selecione a Luz oculta grupo de campos 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.
-
Selecione Adicionar grupos de campos.
-
-
Selecionar + ao lado do nome do esquema.
-
No Propriedades do campo , insira
identificationcomo o Nome do campo, Identificação como o Nome de exibição, selecione Objeto como o Tipo e selecione ExperienceEvent Core v2.1 como o 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 criar um novo grupo de campos e adicionar novos campos de identidade (como ecid,crmId, e outras necessárias) 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.
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 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.
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 da Web e móvel da Adobe Experience Platform e a API do servidor da rede de borda da Adobe Experience Platform. Ao coletar dados com os SDKs da Adobe Experience Platform e as APIs do servidor da rede de borda, 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.
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:
-
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.
-
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 de Rede de Borda
No desenvolvimento do jogo, você pode adicionar chamadas relevantes à API do servidor da rede de borda da Adobe Experience Platform, 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 fluxo de dados de exemplo configurado anteriormente. {sandbox} é o nome exclusivo da sandbox que identifica o caminho para o grupo de campos Luz de ocultação personalizada.
Consulte Coleta de dados interativa e Coleção de dados não interativa para obter mais informações sobre como usar a API do Servidor de Rede de Borda.
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 no Tabela de forma livre no 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.