Show Menu
TÓPICOS×

Mapear um arquivo CSV para um schema XDM

Para assimilar dados CSV na Adobe Experience Platform, os dados devem ser mapeados para um schema do Experience Data Model (XDM). Este tutorial aborda como mapear um arquivo CSV para um schema XDM usando a interface do usuário da plataforma Experience.
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 prática dos seguintes componentes da Adobe Experience Platform:
Este tutorial também requer que você já tenha criado um conjunto de dados para assimilar seus dados CSV. Para obter etapas sobre como criar um conjunto de dados na interface do usuário, consulte o tutorial de assimilação de dados.

Adicionar dados

Na interface do usuário da plataforma de experiência, clique em Workflows no painel de navegação esquerdo e, em seguida, clique em Mapear o schema CSV para XDM. No painel direito exibido, clique em Iniciar .
O fluxo de trabalho Mapear CSV para schema XDM é exibido, começando na etapa Adicionar dados .
Arraste e solte o arquivo CSV no espaço fornecido ou clique em Procurar para selecionar um arquivo diretamente. Uma seção de dados de amostra é exibida depois que o arquivo é carregado, mostrando as primeiras dez linhas de dados. Depois de confirmar que os dados foram carregados como esperado, clique em Avançar .

Escolher um destino

A etapa Destino é exibida. Na lista fornecida, selecione o conjunto de dados no qual os dados CSV serão assimilados e clique em Avançar .

Mapear campos CSV para campos de schema XDM

A etapa Mapeamento é exibida. As colunas do arquivo CSV são listadas em Campo de origem, com seus campos de schema XDM correspondentes listados em Campo de Público alvo. Os campos de público alvo não selecionados são contornados em vermelho.
Para mapear uma coluna CSV para um campo XDM, clique no ícone de schema ao lado do campo de público alvo correspondente da coluna.
A janela Selecionar campo schema é exibida. Aqui, você pode navegar pela estrutura do schema XDM e localizar o campo para o qual deseja mapear a coluna CSV. Clique em um campo XDM para selecioná-lo e, em seguida, clique em Selecionar .
A tela Mapeamento é exibida novamente, com o campo XDM selecionado aparecendo agora em Campo de Público alvo.
Se você não desejar mapear uma coluna CSV específica, é possível remover o mapeamento clicando no ícone ​remover ao lado do campo público alvo. Se desejar adicionar um novo mapeamento, clique em Adicionar novo mapeamento na parte inferior da lista.
Ao mapear campos, também é possível incluir funções para calcular valores com base nos campos de origem de entrada. Consulte a seção de funções de mapeamento no apêndice para obter mais informações.
Repita as etapas acima para continuar mapeando colunas CSV para campos XDM. Quando terminar, clique em Avançar .

Dados de assimilação

A etapa Ingest é exibida, permitindo que você analise os detalhes do arquivo de origem e do conjunto de dados do público alvo. Clique em assimilar para que o start ingira os dados CSV. Dependendo do tamanho do arquivo CSV, esse processo pode levar vários minutos. A tela é atualizada quando a ingestão é concluída, indicando sucesso ou falha. Click Finish to complete the workflow.

Próximas etapas

Ao seguir este tutorial, você mapeou com êxito um arquivo CSV simples para um schema XDM e o assimilou na Plataforma. Esses dados agora podem ser usados por serviços de plataforma downstream, como o Perfil do cliente em tempo real. Consulte a visão geral do Perfil do cliente em tempo real para obter mais informações.

Apêndice

A seção a seguir fornece informações adicionais para mapear colunas CSV para campos XDM.

Funções de mapeamento

Determinadas funções de mapeamento podem ser usadas para calcular e calcular valores com base no que é inserido nos campos de origem. Para usar uma função, digite-a em Campo de origem com a sintaxe e as entradas apropriadas.
Por exemplo, para concatenar campos CSV de cidade e país e atribuí-los ao campo XDM de cidade , defina o campo de origem como concat(city, ", ", county) .
A tabela a seguir lista todas as funções de mapeamento suportadas, incluindo expressões de amostra e suas saídas resultantes.
Função
Descrição
expressão de amostra
Exemplo de saída
concat
Concatena determinadas cordas.
concat("Oi, ", "lá", "!")
"Hi, there!"
explosão
Divide a string com base em um regex e retorna uma matriz de partes.
explode("Oi, aqui!", " ")
["Hi,", "there"]
instr
Retorna o local/índice de uma substring.
instr("adobe .com", "com")
6
substituta
Substitui a string de pesquisa, se presente na string original.
replace("This is a string re test", "re", "replace")
"Este é um teste de substituição de string"
substr
Retorna uma substring de um determinado comprimento.
SAA("This is a substring test", 7, 8)
" a subst"
lower /
lcase
Converte uma string em minúsculas.
lower("EleLLo")
lcase("EleLLo")
"hello"
superior /
ucase
Converte uma string em maiúsculas.
upper("HeLLo")
ucase("EleLLo")
"OLÁ"
split
Divide uma string de entrada em um separador.
split("Hello world", " ")
["Hello", "world"]
join
Une uma lista de objetos usando o separador.
join(" ", ["Hello", "world"] )
"Olá mundo"
coalescência
Retorna o primeiro objeto não nulo em uma determinada lista.
coalesce(null, null, null, "first", null, "second")
"first"
decodificação
Considerando uma chave e uma lista de pares de valores chave nivelados como uma matriz, a função retornará o valor se a chave for encontrada ou retornará um valor padrão se estiver presente na matriz.
decode("k2", "k1", "v1", "k2", "v2", "default")
"v2"
iif
Avalia uma determinada expressão booleana e retorna o valor especificado com base no resultado.
iif("s".equalsIgnoreCase("S"), "True", "False")
"Verdadeiro"
min
Retorna o mínimo dos argumentos fornecidos. Usa ordenação natural.
min(3, 1, 4)
1
max
Retorna o máximo dos argumentos fornecidos. Usa ordenação natural.
max(3, 1, 4)
4
first
Recupera o primeiro argumento fornecido.
first("1", "2", "3")
"1"
last
Recupera o último argumento fornecido.
last("1", "2", "3")
"3"
uid /
guid
Gera uma ID pseudo-aleatória.
uuid()
guid()
now
Recupera a hora atual.
now()
2019-10-23T10:10:24.556-07:00[America/Los_Angeles]
carimbo de data e hora
Recupera o tempo Unix atual.
carimbo de data e hora()
1571850624571
format
Formata a data de entrada de acordo com um formato especificado.
format(, "aaaa-MM-dd HH:mm:ss")
"2019-10-23 11:24:35"
dformat
Converte um carimbo de data e hora em uma string de data de acordo com um formato especificado.
dformat(1571829875, "dd-MMM-yyyy hh:mm")
"23-out-2019 11:24"
date
Converte uma string de data em um objeto ZondedDateTime (formato ISO 8601).
date("23-out-2019 11:24")
"2019-10-23T11:24:00+00:00"
date_part
Recupera as partes da data. Os seguintes valores de componente são suportados:
"year"
"yyyy"
"yy"
"trimestre"
"qq"
"q"
"month"
"mm"
"m"
"dayofyear""""""dia""""semana""ww"w""dia da semana""dw""horas" hh""hh24""hh12""minuto"""""""""""""ms""
date_part(date("2019-10-17 11:55:12"), "MM")
10
set_date_part
Substitui um componente em uma determinada data. Os seguintes componentes são aceitos:
"year"
"yyyy"
"yy"
"month"
"mm"
"m"dia"
"dd"
"d"
"hora"""hora""""""""""s""s""""s"
"year"yyyy"y"yy"
"yy"yy"Money"Money"Money"m"mm"
"mm"mm"mm"mm"m"mm"""""s""""""
set_date_part("m", 4, date("2016-11-09T11:44:44.797")
"2016-04-09T11:44:44.797"
make_date_time /
make_timestamp
Cria uma data de partes.
make_date_time(2019, 10, 17, 11, 55, 12, 999, "América/Los_Angeles")
2019-10-17T11:55:12.0​00000999-07:00[America/Los_Angeles]
current_timestamp
Retorna o carimbo de data e hora atual.
current_timestamp()
1571850624571
current_date
Retorna a data atual sem um componente de hora.
current_date()
"18-nov-2019"