Guia da interface do usuário de preparação de dados

Este documento fornece instruções sobre como usar funções de preparação de dados na interface do usuário do Adobe Experience Platform para mapear arquivos CSV para um esquema XDM.

Introdução

Este tutorial requer uma compreensão funcional dos seguintes componentes da plataforma:

  • Experience Data Model (XDM) Sistema: A estrutura padronizada pela qual a Platform organiza os dados de experiência do cliente.
  • Serviço de identidade: Obtenha uma melhor visão de clientes individuais e seu comportamento ao unir identidades em dispositivos e sistemas.
  • Real-time Customer Profile: Fornece um perfil de consumidor unificado e em tempo real com base em dados agregados de várias fontes.
  • Fontes: O Experience Platform permite que os dados sejam assimilados de várias fontes, fornecendo a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços da plataforma.

Detalhes do fluxo de dados

DICA

Você pode acessar os detalhes do fluxo de dados selecionando qualquer origem no catálogo de fontes. Para obter mais informações, consulte o visão geral das fontes.

Antes de mapear seus dados CSV para um esquema XDM, primeiro você deve estabelecer os detalhes do seu fluxo de dados.

O Detalhes do fluxo de dados permite selecionar se deseja assimilar seus dados CSV em um conjunto de dados de destino existente ou em um novo conjunto de dados de destino. Um conjunto de dados existente vem com um esquema de destino pré-criado para mapear seus dados, enquanto um novo conjunto de dados requer que você selecione um esquema existente ou crie um novo schema para mapear seus dados.

Usar um conjunto de dados de destino existente

Para assimilar seus dados CSV em um conjunto de dados existente, selecione Conjunto de dados existente. Você pode recuperar um conjunto de dados existente usando o Pesquisa avançada ou percorrendo a lista de conjuntos de dados existentes no menu suspenso.

Com um conjunto de dados selecionado, forneça um nome para o seu fluxo de dados e uma descrição opcional.

Durante esse processo, também é possível ativar Diagnóstico de erros e Ingestão parcial. Diagnóstico de erros permite a geração detalhada de mensagens de erro para qualquer registro incorreto que ocorra no seu fluxo de dados, enquanto Ingestão parcial O permite assimilar dados contendo erros, até um determinado limite definido manualmente. Consulte a visão geral da ingestão parcial de lote para obter mais informações.

conjunto de dados existente

Usar um novo conjunto de dados de destino

Para assimilar seus dados CSV em um novo conjunto de dados, selecione Novo conjunto de dados e, em seguida, forneça um nome de conjunto de dados de saída e uma descrição opcional. Em seguida, selecione um esquema para mapear usando o Pesquisa avançada ou rolando pela lista de schemas existentes no menu suspenso.

Com um esquema selecionado, forneça um nome para o seu fluxo de dados e uma descrição opcional e, em seguida, aplique a variável Diagnóstico de erros e Ingestão parcial configurações desejadas para o fluxo de dados. Quando terminar, selecione Próximo.

novo conjunto de dados

Selecionar dados

O Selecionar dados será exibida, fornecendo uma interface para carregar seus arquivos locais e visualizar sua estrutura e conteúdo. Selecionar Escolher arquivos para fazer upload de um arquivo CSV em seu sistema local. Como alternativa, você pode arrastar e soltar o arquivo CSV que deseja fazer upload no Arrastar e soltar arquivos painel.

DICA

Atualmente, apenas os arquivos CSV são compatíveis com o upload de arquivo local. O tamanho máximo de arquivo para cada arquivo é de 1 GB.

choice-files

Depois que o arquivo é carregado, a interface de visualização é atualizada para exibir o conteúdo e a estrutura do arquivo.

preview-sample-data

Dependendo do arquivo, é possível selecionar um delimitador de coluna, como guias, vírgulas, barra vertical ou um delimitador de coluna personalizado para os dados de origem. Selecione o Delimitador seta suspensa e selecione o delimitador apropriado no menu.

Quando terminar, selecione Próximo.

delimiter

Mapeamento

O mapeamento A interface fornece uma ferramenta abrangente para mapear campos de origem do esquema de origem para os campos XDM de destino apropriados no esquema de destino.

map-csv-to-xdm

Noções básicas da interface de mapeamento

A interface de mapeamento inclui um painel que fornece informações sobre a integridade dos campos de mapeamento no contexto do fluxo de trabalho de assimilação. O painel exibe os seguintes detalhes sobre os campos de mapeamento:

Propriedade Descrição
Campos mapeados Exibe o número total de campos de origem que foram mapeados para um campo XDM de destino, independentemente dos erros.
Campos obrigatórios Exibe o número de campos de mapeamento necessários.
Campos de identidade Exibe o número total de campos de mapeamento definidos como identidade. Esses campos de mapeamento são representados por um ícone de impressão digital.
Erros Exibe o número de campos de mapeamento incorretos.

painel superior

A interface de mapeamento também fornece um painel de opções que você pode escolher para interagir ou filtrar melhor por meio dos campos de mapeamento.

segundo painel

Para pesquisar um conjunto de mapeamentos específico, selecione Pesquisar campos de origem e insira o nome dos dados de origem que deseja isolar.

pesquisa

Selecionar Todos os campos de origem para ver um menu suspenso de opções de filtragem para restringir melhor sua visualização da interface de mapeamento.

As opções de filtragem são:

Campos de origem Descrição
Todos os campos de origem Essa opção exibe todos os campos de origem do esquema de origem. Essa opção é exibida por padrão.
Campos obrigatórios Essa opção filtra o schema de origem para exibir apenas os campos necessários para concluir o mapeamento.
Campos de identidade Essa opção filtra o schema de origem para exibir somente os campos marcados para Identidade.
Campos mapeados Essa opção filtra o schema de origem para exibir apenas os campos que já foram mapeados.
Campos não mapeados Essa opção filtra o schema de origem para exibir apenas os campos que ainda precisam ser mapeados.
Campos com recomendação Essa opção filtra o schema de origem para exibir apenas os campos que contêm recomendações de mapeamento.

Selecionar Campos com erros para ver todos os campos de mapeamento com erros.

filtro

Uma exibição isolada de campos de mapeamento incorretos é exibida, permitindo corrigir erros por meio de recomendações de mapeamento inteligente ou pela árvore de mapeamento manual.

fields-with-errors

Adicionar um novo tipo de campo

Você pode adicionar um novo campo de mapeamento ou um campo calculado selecionando Novo tipo de campo.

Novo campo de mapeamento

Para adicionar um novo campo de mapeamento, selecione Novo tipo de campo e depois selecione Adicionar novo campo no menu suspenso exibido.

add-new-field

Em seguida, selecione o campo de origem que deseja adicionar da árvore de esquema de origem que é exibida e selecione Selecionar.

select-new-field

A interface de mapeamento é atualizada com o campo de origem selecionado e um campo de destino vazio. Selecionar Mapear campo de destino para começar a mapear o novo campo de origem para o campo XDM de destino apropriado.

map-target-field

Uma árvore de esquema de destino interativa é exibida, permitindo percorrer manualmente pelo esquema de destino e localizar o campo XDM de destino apropriado para seu campo de origem.

mapeamento manual

Quando terminar, selecione o ícone de schema para fechar a interface do schema de destino.

árvore de esquema

Campos calculados

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. Os campos calculados têm um comprimento máximo de 4096 caracteres.

Para criar um campo calculado, selecione Novo tipo de campo e depois selecione Adicionar campo calculado

adicionar campo calculado

O Criar campo calculado será 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
Função 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 funções de Preparação de dados (Mapeador).
Campo A guia fields lista campos e atributos disponíveis no schema de origem.
Operador A guia operadores lista os operadores disponíveis para transformar os dados.

guias

É 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. Depois de concluir, selecione Salvar para continuar.

create-calculated-field

Importar mapeamento

Você pode reutilizar o mapeamento de um fluxo de dados existente para reduzir o tempo de configuração manual da assimilação de dados e limitar os erros. Selecionar Importar mapeamento para reutilizar um mapeamento existente.

import-mapping

O Importar mapeamento for exibida, fornecendo uma lista de fluxos de dados para escolha.

Selecione o ícone de visualização para visualizar o mapeamento do fluxo de dados selecionado.

mapeamento de lista

A janela de pré-visualização permite inspecionar o mapeamento existente antes de importar para o fluxo de dados. Depois de verificar o mapeamento, você pode selecionar Voltar para retornar à lista de fluxos de dados e inspecionar outro conjunto de mapeamento, ou você pode selecionar Selecionar para continuar.

mapeamento de visualização

Como alternativa, você pode selecionar o mapeamento que deseja importar da janela de lista de fluxos de dados. Selecione o fluxo de dados que contém o mapeamento que deseja importar e selecione Selecionar para continuar.

select-mapping

A interface é atualizada com o mapeamento importado.

OBSERVAÇÃO

Qualquer conjunto de mapeamento existente que você estabeleça ou para as recomendações de mapeamento do ML será substituído pelo mapeamento importado de um fluxo de dados existente.

mapeamento importado

Selecionar Visualizar dados para ver os resultados de mapeamento de até 100 linhas de dados de amostra do conjunto de dados selecionado.

preview-data

Durante a visualização, a coluna de identidade é priorizada como o primeiro campo, pois são as informações principais necessárias ao validar resultados de mapeamento. Quando terminar, selecione Fechar.

tela de visualização

Para remover todos os campos de mapeamento, selecione Limpar todos os mapeamentos.

limpar tudo

Usar a interface de mapeamento

A Platform fornece automaticamente recomendações inteligentes para campos mapeados automaticamente com base no esquema de destino ou conjunto de dados selecionado. É possível ajustar manualmente as regras de mapeamento para atender aos casos de uso ou corrigir quaisquer campos de mapeamento duplicados para apagar erros.

interface de mapeamento

Selecione o ícone da lâmpada no campo de destino que deseja ajustar.

mapping-recc

O Recomendações de mapeamento painel pop-up é exibido, exibindo uma lista de campos de destino recomendados que podem ser mapeados para um campo de origem específico. Por padrão, a primeira recomendação é aplicada automaticamente.

À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 ícone 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.

Aqui, você pode alterar o campo de destino selecionado para corrigir um erro ou corresponder ao seu caso de uso.

Como alternativa, você pode selecionar Selecionar manualmente para usar manualmente a árvore interativa de mapeamento do esquema de destino.

recc-panel

A interface de mapeamento do esquema de destino aparece na mesma exibição dos campos de mapeamento, permitindo modificar pares de mapeamento na mesma tela. Selecione o campo de destino que se ajusta ao caso de uso ou que corrige seus erros.

select-target-field

Quando terminar, selecione Concluir para continuar.

concluir

Próximas etapas

Ao ler este documento, você mapeou com êxito um arquivo CSV em um esquema XDM de destino usando a interface de mapeamento na interface do usuário da plataforma. Consulte os seguintes documentos para obter mais informações:

Nesta página