Assimilar dados por meio do SDK móvel do Adobe Experience Platform
Este guia de início rápido explica como você pode assimilar dados de rastreamento de aplicativos móveis diretamente na Adobe Experience Platform usando o SDK móvel da Adobe Experience Platform e a rede de borda. Em seguida, use 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 facilmente regras e elementos de dados em relação aos dados no aplicativo móvel. 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 defina quais dados 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 usando seu aplicativo móvel, por exemplo, nome da cena, identificação.
Primeiro, é necessário 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 ExperienceEvent do SDK do AEP Mobile grupo de campos na lista.
É possível selecionar o botão de visualização para visualizar os campos que fazem parte desse grupo de campos, como
application > name.
Selecione Voltar para fechar a visualização.
-
Selecione Adicionar grupos de campos.
-
-
Selecione + ao lado do nome do esquema no painel Estrutura.
-
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ê deseja identificar perfis usando seu aplicativo móvel com a ID de 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 você pode capturar de seu aplicativo móvel. 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 aplicativo móvel sejam adicionados ao Perfil do cliente em tempo real.
Além dos dados de comportamento, também é possível capturar dados de atributos de perfil do aplicativo móvel (por exemplo, detalhes de perfis que estão assinando um boletim informativo).
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 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.
Na configuração, você deseja que os dados coletados do aplicativo móvel sejam enviados para 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.
-
A sequência de dados agora está configurada para encaminhar os dados coletados do aplicativo móvel para o 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 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 o Adobe Experience Platform usando a extensão SDK móvel 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 e selecione Dispositivo móvel. Selecione Salvar para continuar.
Configurar sua tag
Depois de criar a tag, você precisa configurá-la com as extensões corretas e configurar os elementos de dados e as regras de acordo com a maneira como deseja rastrear seu site e enviar dados para a Adobe Experience Platform.
Para configurar, selecione a tag recém-criada na lista de Propriedades da tag.
Extensões
Adicione a extensão de Rede de borda da plataforma Adobe à sua tag para garantir que você possa enviar dados para a Adobe Experience Platform (por meio de sua sequência de dados).
Para criar e configurar a extensão SDK do Adobe Experience Platform Mobile:
-
Selecionar Extensões no painel esquerdo. As extensões Mobile Core e Perfil já estão disponíveis.
-
Selecione Catálogo na barra superior.
-
Pesquise ou role até o Rede de borda Adobe Experience Platform e selecione Instalar no painel direito para instalá-lo.
-
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.
-
Insira seu Domínio da rede de borda abaixo Configuração de domínio. Normalmente, use
<organizationName>.data.adobedc.net. -
Selecione Salvar.
Consulte Configurar a extensão da rede de borda do Adobe Experience Platform para obter mais informações.
Você também pode configurar as seguintes extensões adicionais no catálogo:
- Identidade.
- Garantia da AEP.
- Consentimento.
Consulte Configurar uma propriedade de tag no Tutorial do aplicativo móvel para a Experience Platform, para obter muito mais informações sobre extensões e suas configurações.
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 leem dados ou eventos de aplicativos móveis e podem ser usados para fornecer dados à Adobe Experience Platform.
Por exemplo, você deseja coletar o nome da operadora do aplicativo móvel.
Para definir um elemento de dados do nome da transportadora:
-
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
Carrier Name. -
Selecionar Núcleo móvel do Extensão lista.
-
Selecionar Nome da operadora do Tipo de elemento de dados lista.
-
Selecione Salvar.
-
Você pode criar quantos elementos de dados desejar e usá-los nas regras.
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 o Adobe Experience Platform usando a extensão Rede de borda da Adobe Experience Platform.
Por exemplo, você deseja enviar dados de evento quando o aplicativo móvel é usado (em primeiro plano) e quando o aplicativo móvel não é usado (enviado de volta para o segundo plano).
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
Application Status. -
Selecione + Adicionar abaixo de Eventos.
-
Na caixa de diálogo Configuração de evento:
-
Selecionar Núcleo móvel do Extensão lista.
-
Selecionar Primeiro plano do Tipo de evento lista.
-
Selecione Manter alterações.
-
-
Clique em
-
Selecionar Núcleo móvel do Extensão lista.
-
Selecionar Histórico do Tipo de evento lista.
-
Selecione Manter alterações.
-
-
Clique em
-
Selecionar Rede de borda Adobe Experience Platform do Extensão lista.
-
Selecionar Encaminhar evento para a rede de borda do Tipo de ação lista.
-
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 o status do aplicativo, para a Rede do Adobe Edge e 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
Após definir elementos de dados e regras, é necessário 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 do Adobe Experience Platform são compatíveis com fluxos de trabalho de publicação simples a complexos que devem acomodar a implantação da rede de borda da Adobe Experience Platform.
Consulte Visão geral de publicação para obter mais informações.
Recuperar o código da tag
Por fim, é necessário usar a tag no aplicativo móvel que você deseja rastrear.
Para obter instruções de código que explicam como configurar seu aplicativo móvel e usar sua tag no aplicativo:
-
Selecione Ambientes no painel esquerdo.
-
Na lista de ambientes, selecione a instalação correta
No Instruções de instalação em dispositivos móveis , selecione a plataforma apropriada (iOS, Android). Em seguida, use a cópia
-
Selecione Fechar.
Em vez do código do ambiente de desenvolvimento, você poderia ter selecionado outro ambiente (preparo, produção) com base no local em que está implantando o SDK do Adobe Experience Platform Mobile.
Consulte Ambientes para obter mais informações.
Implantar e validar
Agora você pode implantar o código no aplicativo móvel. Quando implantado, o aplicativo móvel 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.
Consulte Tutorial Implementar o Adobe Experience Cloud em aplicativos para dispositivos móveis para obter informações muito mais detalhadas.
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 (por exemplo, dados de eventos de experiência de rastreamento de push e dados de perfil de push do Adobe Journey Optimizer)
-
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 . Como exemplo, arraste
Eventscomo métricas ePush Titlecomo dimensão, detalhado porEvent Typepara obter uma visão geral das notificações por push para seu aplicativo móvel e o que aconteceu com elas.
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.