Ingressar dados no Adobe Experience Platform

A Adobe Experience Platform permite importar dados facilmente para Platform como arquivos em lote. Exemplos de dados a serem ingeridos podem incluir dados de perfil de um arquivo simples em um sistema CRM (como um arquivo parquet) ou dados que estejam em conformidade com um schema conhecido Experience Data Model (XDM) no Registro do Schema.

Introdução

Para concluir este tutorial, é necessário ter acesso a Experience Platform. Se você não tiver acesso a uma Organização IMS em Experience Platform, fale com o administrador do sistema antes de prosseguir.

Se preferir assimilar dados usando as APIs de ingestão de dados, comece lendo o guia do desenvolvedor de ingestão delote.

Área de trabalho de conjuntos de dados

A área de trabalho de conjuntos de dados dentro Experience Platform permite que você visualização e gerencie todos os conjuntos de dados criados pela organização IMS, bem como criar novos conjuntos.

Visualização a área de trabalho Conjuntos de dados clicando em Conjuntos de dados na navegação à esquerda. A área de trabalho Conjuntos de dados contém uma lista de conjuntos de dados, incluindo colunas que mostram o nome, a data e a hora, a origem, o schema e o status do último lote, bem como a data e a hora em que o conjunto de dados foi atualizado pela última vez.

Observação

Clique no ícone de filtro ao lado da barra Pesquisar para usar os recursos de filtragem para visualização somente dos conjuntos de dados habilitados para Profile.

Visualização de todos os conjuntos de dados

Criar um conjunto de dados

Para criar um conjunto de dados, clique em Criar conjunto de dados no canto superior direito da área de trabalho Conjuntos de dados.

Na tela Criar conjunto de dados , selecione se deseja "Criar conjunto de dados a partir do Schema" ou "Criar conjunto de dados a partir do arquivoCSV".

Para este tutorial, um schema será usado para criar o conjunto de dados. Clique em Criar conjunto de dados do Schema para continuar.

Selecionar fonte de dados

Selecionar schema de conjunto de dados

Na tela Selecionar Schema , escolha um schema clicando no botão de opção ao lado do schema que você deseja usar. Para este tutorial, o conjunto de dados será feito usando o schema Membros de Fidelidade. Usar a barra de pesquisa para filtrar schemas é uma maneira útil de encontrar o schema exato que você está procurando.

Depois de selecionar o botão de opção ao lado do schema que deseja usar, clique em Avançar.

Selecionar schema

Configurar conjunto de dados

Na tela Configurar conjunto de dados , será necessário fornecer um nome ao conjunto de dados e também fornecer uma descrição do conjunto de dados.

Notas sobre os nomes dos conjuntos de dados:

  • Os nomes dos conjuntos de dados devem ser curtos e descritivos para que o conjunto de dados possa ser facilmente encontrado na biblioteca posteriormente.
  • Os nomes dos conjuntos de dados devem ser exclusivos, o que significa que também devem ser específicos o suficiente para que não sejam reutilizados no futuro.
  • É prática recomendada fornecer informações adicionais sobre o conjunto de dados usando o campo de descrição, pois pode ajudar outros usuários a diferenciarem entre conjuntos de dados no futuro.

Depois que o conjunto de dados tiver um nome e uma descrição, clique em Concluir.

Configurar conjunto de dados

Atividade do conjunto de dados

Um conjunto de dados vazio foi criado e você foi retornado para a guia Atividade ​Conjunto de dados na área de trabalho Conjuntos de dados. Você deve ver o nome do conjunto de dados no canto superior esquerdo do espaço de trabalho, juntamente com uma notificação de que "Nenhum lote foi adicionado." Isso é esperado, pois você ainda não adicionou nenhum lote a esse conjunto de dados.

No lado direito da área de trabalho dos conjuntos de dados, você verá a guia Informações contendo informações relacionadas ao novo conjunto de dados, como ID do conjunto de dados, nome, descrição, nome da tabela, schema, transmissão e origem. A guia Informações também inclui informações sobre quando o conjunto de dados foi criado e sua última data de modificação.

Também na guia Informações há uma alternância de Perfil usada para habilitar seu conjunto de dados para uso com Real-time Customer Profile. O uso dessa alternância e Real-time Customer Profileserá explicado com mais detalhes na seção a seguir.

Atividade do conjunto de dados

Ativar conjunto de dados para Real-time Customer Profile

Os conjuntos de dados são usados para assimilar dados Experience Platform, e esses dados são usados para identificar indivíduos e unir informações provenientes de várias fontes. Essa informação costurada é chamada de Real-Time Customer Profile. Para Platform saber quais informações devem ser incluídas no Real-Time Profile, os conjuntos de dados podem ser marcados para inclusão usando a alternância de Perfil .

Por padrão, essa alternância está desativada. Se você optar por alternar Profile, todos os dados ingeridos no conjunto de dados serão usados para ajudar a identificar um indivíduo e unir seus dados Real-Time Profile.

Para saber mais sobre Real-time Customer Profile e trabalhar com identidades, consulte a documentação do Serviço de Identidade .

Para ativar o conjunto de dados para Real-time Customer Profile, clique na alternância de Perfil na guia Informações .

Alternar perfil

Será exibida uma caixa de diálogo solicitando que você confirme que deseja ativar o conjunto de dados para Real-time Customer Profile.

Habilitar caixa de diálogo Perfil

Clique em Ativar e a alternância ficará azul, indicando que está ativada.

Ativado para Perfil

Adicionar dados ao conjunto de dados

Os dados podem ser adicionados a um conjunto de dados de várias maneiras diferentes. Você poderia optar por usar Data Ingestion APIs ou um parceiro ETL, como Unifi ou Informatica. Para este tutorial, os dados serão adicionados ao conjunto de dados usando a guia Adicionar dados na interface do usuário.

Para começar a adicionar dados ao conjunto de dados, clique na guia Adicionar dados . Agora você pode arrastar e soltar arquivos ou procurar no computador os arquivos que deseja adicionar.

Observação

A plataforma oferece suporte a dois tipos de arquivos para ingestão de dados, parquet ou JSON. Você pode adicionar até cinco arquivos de cada vez, com o tamanho máximo de cada arquivo de 10 GB.

Guia Adicionar dados

Carregar um arquivo

Depois de arrastar e soltar (ou navegar e selecionar) um parquet ou arquivo JSON que você deseja carregar, Platform começará imediatamente a processar o arquivo e uma caixa de diálogo Carregar aparecerá na guia Adicionar dados mostrando o progresso do upload do arquivo.

Caixa de diálogo de upload

Métricas do conjunto de dados

Após a conclusão do upload do arquivo, a guia Atividade do conjunto de dados não mostra mais que "Nenhum lote foi adicionado." Em vez disso, a guia Atividade ​do conjunto de dados agora mostra as métricas do conjunto de dados. Todas as métricas mostrarão "0" neste estágio, pois o lote ainda não foi carregado.

Na parte inferior da guia, há uma lista que mostra a ID do lote dos dados que foram ingeridos pelo processo "Adicionar dados ao conjunto de dados" . Também estão incluídas as informações relacionadas ao lote, incluindo a data de assimilação, o número de registros ingeridos e o status atual do lote.

Métricas do conjunto de dados

Detalhes do lote

Clique na ID do lote para visualização de uma visão geral do lote, mostrando detalhes adicionais sobre o lote. Depois que o lote terminar de carregar, as informações sobre o lote serão atualizadas para mostrar o número de registros ingeridos e o tamanho do arquivo. O status também será alterado para "Êxito" ou "Falha". Se o lote falhar, a seção Código de erro conterá detalhes sobre quaisquer erros durante a ingestão.

Para obter mais informações e perguntas frequentes sobre a ingestão em lote, consulte o guia de solução de problemas de ingestão emlote.

Para retornar à tela Atividade do Conjunto de Dados, clique no nome do conjunto de dados (Detalhes da Fidelidade) na navegação estrutural.

Visão geral do lote

Conjunto de dados de pré-visualização

Quando o conjunto de dados estiver pronto, uma opção para Pré-visualização do conjunto de dados será exibida na parte superior da guia Atividade do conjunto de dados.

Clique em Conjunto de dados de Pré-visualização para abrir uma caixa de diálogo mostrando dados de amostra do conjunto de dados. Se o conjunto de dados tiver sido criado usando um schema, os detalhes do schema do conjunto de dados aparecerão no lado esquerdo da pré-visualização. Você pode expandir o schema usando as setas para ver a estrutura do schema. Cada cabeçalho de coluna nos dados de pré-visualização representa um campo no conjunto de dados.

Detalhes do conjunto de dados

Próximos passos e recursos adicionais

Agora que você criou um conjunto de dados e assimilou com êxito os dados, Experience Platformpode repetir essas etapas para criar um novo conjunto de dados ou assimilar mais dados no conjunto de dados existente.

Para saber mais sobre a ingestão em lote, leia a visão geral da Ingestão em lote e complemente a sua aprendizagem assistindo ao vídeo abaixo.

AVISO

A Platform interface do usuário exibida no vídeo a seguir está desatualizada. Consulte a documentação acima para obter as capturas de tela e a funcionalidade mais recentes da interface do usuário.

Nesta página