Guia da interface de preparação de dados

Este documento fornece instruções sobre como usar as 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 Platform:

  • 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 visualização dos clientes individuais e do comportamento deles ao unir as identidades de vários dispositivos e sistemas.

  • Real-Time Customer Profile: fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.

  • Origens: o Experience Platform permite que os dados sejam assimilados de várias fontes e, ao mesmo tempo, fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços da plataforma.

Detalhes do fluxo de dados

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

Antes de mapear os dados CSV para um esquema XDM, primeiro estabeleça os detalhes do fluxo de dados.

A variável Detalhes do fluxo de dados permite selecionar se você deseja assimilar os 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 exige que você selecione um esquema existente ou crie um novo esquema para mapear seus dados.

Usar um conjunto de dados de destino existente

Para assimilar dados CSV em um conjunto de dados existente, selecione Conjunto de dados existente. É possível recuperar um conjunto de dados existente usando o Pesquisa avançada ou rolando pela lista de conjuntos de dados existentes no menu suspenso.

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

Durante esse processo, você também pode ativar Diagnóstico de erro e Assimilação parcial. Diagnóstico de erro permite a geração de mensagens de erro detalhadas para qualquer registro incorreto que ocorra em seu fluxo de dados, enquanto Assimilação parcial O permite assimilar dados que contêm erros, até um determinado limite definido manualmente. Consulte a visão geral da assimilação parcial de lotes 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 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 esquemas existentes no menu suspenso.

Com um esquema selecionado, forneça um nome para o fluxo de dados e uma descrição opcional e aplique a Diagnóstico de erro e Assimilação parcial as configurações desejadas para o seu fluxo de dados. Quando terminar, selecione Próxima.

novo conjunto de dados

Selecionar dados

A variável Selecionar dados é exibida, fornecendo uma interface para fazer upload dos arquivos locais e visualizar sua estrutura e conteúdo. Selecionar Escolher arquivos para carregar um arquivo CSV do seu sistema local. Como alternativa, você pode arrastar e soltar o arquivo CSV que deseja fazer upload na Arrastar e soltar arquivos painel.

TIP
No momento, somente arquivos CSV são compatíveis com o upload de arquivo local. O tamanho máximo para cada arquivo é de 1 GB.

choose-files

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

preview-sample-data

Dependendo do arquivo, você pode selecionar um delimitador de coluna, como guias, vírgulas, barras verticais ou um delimitador de coluna personalizado para seus dados de origem. Selecione o Delimitador e selecione o delimitador apropriado no menu.

Quando terminar, selecione Próxima.

delimitador

Mapeamento

A variável mapeamento A interface do 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 sobre a interface de mapeamento mapping-interface

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 em relação aos 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 de 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 pelos campos de mapeamento.

segundo painel

Para pesquisar um conjunto de mapeamento específico, selecione Pesquisar campos de origem e digite 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 filtro 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 esquema de origem para exibir apenas os campos necessários para concluir o mapeamento.
Campos de identidade
Essa opção filtra o esquema de origem para exibir apenas os campos marcados para Identidade.
Campos mapeados
Essa opção filtra o esquema de origem para exibir apenas os campos que já foram mapeados.
Campos não mapeados
Essa opção filtra o esquema de origem para exibir apenas os campos que ainda não foram mapeados.
Campos com recomendação
Essa opção filtra o esquema 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 que você solucione erros por meio de recomendações de mapeamento inteligentes ou pela árvore de mapeamento manual.

campos com erros

Adicionar um novo tipo de campo

É possível 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 selecione Adicionar novo campo no menu suspenso exibido.

adicionar-novo-campo

Em seguida, selecione o campo de origem que deseja adicionar da árvore de esquema de origem 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 seu campo XDM de destino apropriado.

map-target-field

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

mapeamento manual

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

árvore de esquema

Campos calculados calculated-fields

Os campos calculados permitem que valores sejam criados com base nos atributos no esquema de entrada. Esses valores podem ser atribuídos a atributos no esquema de destino e receber um nome e uma descrição para facilitar a referência. Os campos calculados têm um comprimento máximo de 4096 caracteres.

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

adicionar campo calculado

A variável Criar campo calculado é exibido. A caixa de diálogo à esquerda contém os campos, funções e operadores compatíveis com os 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 functions lista as funções disponíveis para transformar os dados. Para saber mais sobre as funções que você pode usar em campos calculados, leia o guia em uso das funções de Preparo de dados (Mapeador).
Campo
A guia fields lista campos e atributos disponíveis no schema de origem.
Operador
A guia operators lista os operadores disponíveis para transformar os dados.

guias

Você pode 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. Quando terminar, selecione Salvar para continuar.

create-calculated-field

Importar mapeamento import

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

import-mapping

A variável Importar mapeamento é exibida, fornecendo uma lista de fluxos de dados para escolher.

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

list-mapping

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

preview-mapping

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

select-mapping

A interface é atualizada com o mapeamento importado.

NOTE
Todos os conjuntos de mapeamento existentes que você estabelecer ou as recomendações de mapeamento de ML serão substituídos pelo mapeamento que você importou de um fluxo de dados existente.

mapeamento-importado

Selecionar Visualizar dados para ver 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 os resultados do mapeamento. Quando terminar, selecione Fechar.

preview-screen

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

clear-all

Uso da interface de mapeamento

A Platform fornece recomendações inteligentes automaticamente para campos mapeados automaticamente com base no esquema ou conjunto de dados de destino selecionado. Você pode ajustar manualmente as regras de mapeamento para atender aos seus casos de uso ou corrigir campos de mapeamento duplicados para eliminar erros.

mapping-interface

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

mapping-recc

A variável Recomendações de mapeamento pop-up será 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 esquema de origem. Quando isso acontece, o cartão de mapeamento exibe a recomendação mais proeminente, seguida por um ícone que contém o número de recomendações adicionais disponíveis. Selecionar o ícone de 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 de mapeamento do schema de destino interativo.

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 seu caso de uso ou que corrige seus erros.

select-target-field

Quando terminar, selecione Concluir para continuar.

finish

Próximas etapas

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

recommendation-more-help
461cc884-c234-4a0c-ac75-6efbaafc1394