Mapear um arquivo CSV para um esquema XDM usando recomendações geradas por IA

NOTE
Para obter informações sobre recursos de mapeamento de CSV geralmente disponíveis na Platform, consulte o documento em mapeando um arquivo CSV para um esquema existente.

Para assimilar dados CSV em Adobe Experience Platform, os dados devem ser mapeados para um esquema Experience Data Model (XDM). Você pode optar por mapear para um esquema existente, mas se não souber exatamente qual esquema usar ou como ele deve ser estruturado, você poderá usar recomendações dinâmicas com base em modelos de aprendizado de máquina (ML) na interface do usuário da plataforma.

Introdução

Este tutorial requer entendimento prático dos seguintes componentes do Platform:

  • Experience Data Model (XDM System): a estrutura padronizada pela qual o Platform organiza os dados de experiência do cliente.
    • No mínimo, você deve entender o conceito de comportamentos no XDM, para que possa decidir se deseja mapear seus dados para uma classe de Perfil (comportamento de registro) ou de ExperienceEvent (comportamento de série temporal).
  • Assimilação em lote: o método pelo qual Platform assimila dados de arquivos de dados fornecidos pelo usuário.
  • Preparo de dados do Adobe Experience Platform: um conjunto de recursos que permitem mapear e transformar dados assimilados para estarem em conformidade com esquemas XDM. A documentação sobre funções de Preparo de Dados é especificamente relevante para o mapeamento de esquema.

Fornecer detalhes do fluxo de dados

Na interface do usuário do Experience Platform, selecione Fontes na navegação à esquerda. Na exibição Catálogo, navegue até a categoria Sistema local. Em Carregamento de arquivo local, selecione Adicionar dados.

O catálogo Fontes na interface do usuário da plataforma, com Adicionar dados em Carregamento de arquivo local sendo selecionado.

O fluxo de trabalho Mapear esquema XDM do CSV é exibido, iniciando na etapa Detalhes do fluxo de dados.

Selecione Criar um novo esquema usando recomendações de ML, fazendo com que novos controles apareçam. Escolha a classe apropriada para os dados CSV que você deseja mapear (Perfil ou ExperienceEvent). Opcionalmente, é possível usar o menu suspenso para selecionar o setor relevante para sua empresa, ou deixá-lo em branco se as categorias fornecidas não se aplicarem a você. Se sua organização opera sob um modelo B2B (B2B), marque a caixa de seleção Dados B2B.

A etapa Detalhes do fluxo de dados com a opção de recomendação ML selecionada. O perfil está selecionado para a classe e Telecomunicações está selecionado para o setor

Aqui, forneça um nome para o esquema que será criado a partir dos dados CSV e um nome para o conjunto de dados de saída que conterá os dados assimilados sob esse esquema.

Opcionalmente, é possível configurar os seguintes recursos adicionais para o fluxo de dados antes de continuar:

Nome de entrada
Descrição
Descrição
Uma descrição para o fluxo de dados.
Diagnóstico de erro
Quando habilitadas, mensagens de erro são geradas para lotes recém-assimilados, que podem ser visualizadas ao buscar o lote correspondente na API.
Assimilação parcial
Quando ativados, os registros válidos para novos dados em lote serão assimilados dentro de um limite de erro especificado. Esse limite permite configurar a porcentagem de erros aceitáveis antes que todo o lote falhe.
Detalhes do fluxo de dados
Forneça um nome e uma descrição opcional para o fluxo de dados que trará os dados CSV para a plataforma. O fluxo de dados recebe automaticamente um nome padrão ao iniciar esse fluxo de trabalho. A alteração do nome é opcional.
Alertas
Selecione de uma lista de alertas no produto que você deseja receber sobre o status do fluxo de dados depois de ele ter sido iniciado.

Quando terminar de configurar o fluxo de dados, selecione Avançar.

A seção Detalhes do fluxo de dados foi concluída.

Selecionar dados

Na etapa Selecionar dados, use a coluna da esquerda para carregar seu arquivo CSV. Você pode selecionar Escolher arquivos para abrir uma caixa de diálogo do explorador de arquivos para selecionar o arquivo, ou pode arrastar e soltar o arquivo diretamente na coluna.

O botão Escolher arquivos e a área de arrastar e soltar destacados na etapa Selecionar dados.

Após o upload do arquivo, é exibida uma seção de dados de amostra que mostra as dez primeiras linhas dos dados recebidos para que você possa verificar se o upload foi feito corretamente. Clique em Avançar para continuar.

Linhas de dados de exemplo são populadas dentro do espaço de trabalho

Configurar mapeamentos de esquema

Os modelos ML são executados para gerar um novo esquema com base na configuração do fluxo de dados e no arquivo CSV carregado. Quando o processo for concluído, a etapa Mapping será preenchida para mostrar os mapeamentos para cada campo individual ao lado da exibição totalmente navegável da estrutura de esquema gerada.

A etapa Mapeamento na interface do usuário, mostrando todos os campos CSV mapeados e a estrutura de esquema resultante.

NOTE
Você pode filtrar todos os campos no esquema com base em vários critérios durante o fluxo de trabalho de mapeamento de campos da origem para o destino. O comportamento padrão é exibir todos os campos mapeados. Para alterar os campos exibidos, selecione o ícone de filtro ao lado do campo de entrada de pesquisa e escolha entre as opções suspensas.
O estágio de mapeamento do fluxo de trabalho de criação do esquema CSV para XDM com o ícone de filtro e o menu suspenso realçados. {width="100" modal="regular"}

Aqui, você pode, opcionalmente, editar os mapeamentos de campo ou alterar os grupos de campos aos quais estão associados de acordo com as suas necessidades. Quando satisfeito, selecione Concluir para concluir o mapeamento e iniciar o fluxo de dados configurado anteriormente. Os dados do CSV são assimilados no sistema e preenchem um conjunto de dados com base na estrutura de esquema gerada, pronta para ser consumida pelos serviços downstream da plataforma.

O botão Concluir sendo selecionado, concluindo o processo de mapeamento de CSV.

Editar mapeamentos de campo edit-mappings

Use a visualização de mapeamento de campo para editar os mapeamentos existentes ou removê-los totalmente. Para obter mais informações sobre como gerenciar um conjunto de mapeamento na interface, consulte o manual da interface para mapeamento de Preparo de Dados.

Editar grupos de campos edit-field-groups

Os campos CSV são mapeados automaticamente para grupos de campos XDM existentes usando modelos ML. Se quiser alterar o grupo de campos para qualquer campo CSV específico, selecione Editar ao lado da árvore de esquema.

O botão Editar que está sendo selecionado ao lado da árvore de esquemas.

Uma caixa de diálogo é exibida, permitindo editar o nome de exibição, o tipo de dados e o grupo de campos de qualquer campo no mapeamento. Selecione o ícone de edição ( Ícone de edição ) ao lado de um campo de origem para editar seus detalhes na coluna direita antes de selecionar Aplicar.

O grupo de campos recomendado para um campo de origem que está sendo alterado.

Quando você terminar de ajustar as recomendações de esquema para seus campos de origem, selecione Salvar para aplicar as alterações.

Próximas etapas

Este guia abordou como mapear um arquivo CSV para um esquema XDM usando recomendações geradas por IA, permitindo que você traga esses dados para a Platform por meio da assimilação em lote.

Para obter etapas sobre como mapear um arquivo CSV para um esquema existente, consulte o fluxo de trabalho de mapeamento de esquema existente. Para obter informações sobre dados de transmissão para a Platform em tempo real por meio de conexões de origem pré-criadas, consulte a visão geral das fontes.

recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a