Mapear um arquivo CSV para um esquema XDM

Para assimilar dados CSV em Adobe Experience Platform, os dados devem ser mapeados para um esquema Experience Data Model (XDM). Este tutorial aborda como mapear um arquivo CSV para um esquema XDM usando a interface do usuário Platform.

Além disso, o apêndice deste tutorial fornece mais informações sobre o uso de funções de mapeamento.

Introdução

Este tutorial requer uma compreensão funcional dos seguintes componentes de Platform:

Este tutorial também requer que você já tenha criado um conjunto de dados para assimilar seus dados CSV no. Para obter etapas sobre como criar um conjunto de dados na interface do usuário, consulte o tutorial de assimilação de dados.

Escolha um destino

Faça logon em Adobe Experience Platform e selecione Workflows na barra de navegação esquerda para acessar o espaço de trabalho Workflows.

Na tela Workflows, selecione Map CSV to XDM schema na seção Data ingestion e selecione Launch.

O workflow Map CSV to XDM schema é exibido, começando na etapa Destination. Escolha um conjunto de dados para os dados de entrada que serão assimilados. Você pode usar um conjunto de dados existente ou criar um novo.

Usar um conjunto de dados existente

Para assimilar seus dados CSV em um conjunto de dados existente, selecione Use existing dataset. Você pode recuperar um conjunto de dados existente usando a função de pesquisa ou rolando pela lista de conjuntos de dados existentes no painel.

Para assimilar seus dados CSV em um novo conjunto de dados, selecione Create new dataset e insira um nome e uma descrição para o conjunto de dados nos campos fornecidos. Selecione um schema usando a função de pesquisa ou rolando pela lista de schemas fornecidos. Selecione Next para continuar.

Adicionar dados

A etapa Add data é exibida. Arraste e solte seu arquivo CSV no espaço fornecido ou selecione Choose files para inserir manualmente seu arquivo CSV.

A seção Sample data aparece assim que o arquivo é carregado, mostrando as primeiras dez linhas de dados. Depois de confirmar que os dados foram carregados conforme esperado, selecione Next.

Mapear campos CSV para campos de esquema XDM

A etapa Mapping é exibida. As colunas do arquivo CSV são listadas em Source Field, com seus campos de esquema XDM correspondentes listados em Target Field.

Platform O fornece automaticamente recomendações inteligentes para campos mapeados automaticamente com base no esquema de destino ou conjunto de dados selecionado. Você pode ajustar manualmente as regras de mapeamento de acordo com seus casos de uso.

Para aceitar todos os valores de mapeamento de geração automática, marque a caixa de seleção "Accept all target fields".

Às vezes, mais de uma recomendação está disponível para o schema de origem. Quando isso acontece, o cartão de mapeamento exibe a recomendação mais importante, seguida por um círculo azul que contém o número de recomendações adicionais disponíveis. Selecionar o ícone da lâmpada mostrará uma lista das recomendações adicionais. Você pode escolher uma das recomendações alternativas marcando a caixa de seleção ao lado da recomendação para a qual deseja mapear.

Como alternativa, você pode optar por mapear manualmente o esquema de origem para o esquema de destino. Passe o mouse sobre o schema de origem que deseja mapear, em seguida, selecione o ícone de adição.

A janela Map source to target field é exibida. Aqui, você pode selecionar qual campo deseja mapear, seguido por Save para adicionar seu novo mapeamento.

Se desejar remover um dos mapeamentos, passe o mouse sobre esse mapeamento e selecione o ícone de menos.

Adicionar campo calculado

Os campos calculados permitem que os valores sejam criados com base nos atributos no schema de entrada. Esses valores podem ser atribuídos aos atributos no schema de destino e receber um nome e uma descrição para permitir uma referência mais fácil.

Selecione o botão Add calculated field para continuar.

O painel Create calculated field é exibido. A caixa de diálogo à esquerda contém os campos, as funções e os operadores suportados nos campos calculados. Selecione uma das guias para começar a adicionar funções, campos ou operadores ao editor de expressão.

Tabulação Descrição
Campos A guia fields lista campos e atributos disponíveis no schema de origem.
Funções A guia funções lista as funções disponíveis para transformar os dados. Para saber mais sobre as funções que você pode usar nos campos calculados, leia o guia em usando as funções de Preparação de Dados (Mapeador).
Operadores A guia operadores lista os operadores disponíveis para transformar os dados.

É possível adicionar campos, funções e operadores manualmente usando o editor de expressão no centro. Selecione o editor para começar a criar uma expressão.

Selecione Save para continuar.

A tela de mapeamento é exibida novamente com o campo de origem recém-criado. Aplique o campo de destino correspondente apropriado e selecione Finish para concluir o mapeamento.

Monitorar assimilação de dados

Depois que o arquivo CSV for mapeado e criado, você poderá monitorar os dados que estão sendo assimilados por meio dele. Para obter mais informações sobre como monitorar a assimilação de dados, consulte o tutorial em monitorando a assimilação de dados.

Próximas etapas

Ao seguir este tutorial, você mapeou com sucesso um arquivo CSV simples para um esquema XDM e o assimilou em Platform. Esses dados agora podem ser usados por serviços Platform downstream, como Real-time Customer Profile. Consulte a visão geral de Real-time Customer Profile para obter mais informações.

Nesta página