Referência de mapeamento de destinos em lote
Este artigo descreve atributos obrigatórios, chaves de desduplicação, campos calculados e limitações conhecidas da etapa Mapeamento quando você ativa públicos para destinos de exportação de perfil em lote.
Atributos obrigatórios mandatory-attributes
Um atributo obrigatório é uma caixa de seleção ativada pelo usuário que garante que todos os registros de perfil contenham o atributo selecionado. Por exemplo: todos os perfis exportados contêm um endereço de email.
Você pode marcar atributos como obrigatórios para garantir que o Experience Platform exporte apenas os perfis que incluem o atributo específico. Como resultado, pode ser usado como uma forma adicional de filtragem. É necessário marcar um atributo como obrigatório não.
Não selecionar um atributo obrigatório exporta todos os perfis qualificados, independentemente dos atributos.
Recomenda-se que um dos atributos seja um identificador exclusivo do esquema. Para obter mais informações sobre atributos obrigatórios, consulte a seção identidade na documentação de Destinos de marketing por email.
Chaves de desduplicação deduplication-keys
Uma chave de desduplicação é uma chave primária definida pelo usuário que determina como os perfis são desduplicados. Quando existem vários registros para o mesmo indivíduo, a desduplicação garante que somente o registro mais recente seja exportado.
As chaves de desduplicação eliminam a possibilidade de ter vários registros do mesmo perfil em um arquivo de exportação.
Há três maneiras de usar chaves de desduplicação em Experience Platform:
- Usando um único namespace de identidade como uma chave de desduplicação
- Usando um único atributo de perfil de um perfil XDM como uma chave de desduplicação
- Usando uma combinação de dois atributos de perfil de um perfil XDM como uma chave composta
Exemplo de desduplicação deduplication-example
Este exemplo ilustra como a desduplicação funciona, dependendo das chaves de desduplicação selecionadas.
Vamos considerar os dois perfis a seguir.
Perfil A
{
"identityMap": {
"Email": [
{
"id": "johndoe@example.com"
},
{
"id": "doejohn_1@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "realized",
"lastQualificationTime": "2021-03-10 10:03:08"
}
}
},
"person": {
"name": {
"lastName": "Doe",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
Perfil B
{
"identityMap": {
"Email": [
{
"id": "johndoe@example.com"
},
{
"id": "doejohn_2@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "realized",
"lastQualificationTime": "2021-04-10 11:33:28"
}
}
},
"person": {
"name": {
"lastName": "D",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
Caso de uso de desduplicação 1: sem desduplicação deduplication-use-case-1
Sem a desduplicação, o arquivo de exportação conteria as seguintes entradas.
Caso de uso de desduplicação 2: desduplicação com base no namespace de identidade deduplication-use-case-2
Considerando a desduplicação pelo namespace Email, o arquivo de exportação conteria as entradas a seguir. O Perfil B é o mais recente qualificado para o público-alvo, portanto, é o único que está sendo exportado.
Caso de uso de desduplicação 3: desduplicação com base em um único atributo de perfil deduplication-use-case-3
Considerando a desduplicação pelo atributo personal Email, o arquivo de exportação conteria a seguinte entrada. O Perfil B é o mais recente qualificado para o público-alvo, portanto, é o único que está sendo exportado.
Caso de uso de desduplicação 4: desduplicação com base em dois atributos de perfil deduplication-use-case-4
Considerando a desduplicação pela chave composta personalEmail + lastName, o arquivo de exportação conteria as entradas a seguir.
A Adobe recomenda selecionar um namespace de identidade, como um CRM ID ou endereço de email, como uma chave de desduplicação, para garantir que todos os registros de perfil sejam identificados exclusivamente.
Comportamento de desduplicação para perfis com o mesmo carimbo de data e hora deduplication-same-timestamp
Ao exportar perfis para destinos baseados em arquivo, a desduplicação garante que apenas um perfil seja exportado quando vários perfis compartilharem a mesma chave de desduplicação e o mesmo carimbo de data e hora de referência. Esse carimbo de data e hora representa o momento em que a associação de público-alvo ou o gráfico de identidade de um perfil foi atualizado pela última vez. Para obter mais informações sobre como os perfis são atualizados e exportados, consulte o documento comportamento de exportação do perfil.
Principais considerações key-considerations
-
Seleção determinística: quando vários perfis têm chaves de desduplicação idênticas e o mesmo carimbo de data/hora de referência, a lógica de desduplicação determina qual perfil deve ser exportado ao classificar os valores de outras colunas selecionadas (excluindo tipos complexos, como matrizes, mapas ou objetos). Os valores classificados são avaliados em ordem lexicográfica e o primeiro perfil é selecionado.
-
Exemplo de cenário
Considere os seguintes dados, em que a chave de desduplicação é a coluna Email:
test1@test.comtest1@test.comtest2@test.comApós a desduplicação, o arquivo de exportação conterá:
test1@test.comtest2@test.comExplicação: para test1@test.com, ambos os perfis compartilham a mesma chave de desduplicação e carimbo de data/hora. O algoritmo classifica os valores de coluna first_name e last_name lexicograficamente. Como os nomes são idênticos, o vínculo é resolvido usando a coluna last_name, em que “Doe” vem antes de “Morris”.
Confiabilidade aprimorada: esse processo de desduplicação atualizado garante que execuções sucessivas com as mesmas coordenadas sempre produzirão os mesmos resultados, melhorando a consistência.
Executar transformações de dados por meio de campos calculados calculated-fields
Você pode usar o controle Campos calculados para executar várias transformações de dados nos dados exportados para destinos baseados em arquivo.
Limitações conhecidas known-limitations
A nova página Mapeamento tem as seguintes limitações conhecidas:
O atributo de associação de público não pode ser selecionado por meio do fluxo de trabalho de mapeamento audience-membership-attribute-mapping
Devido a uma limitação conhecida, no momento, você não pode usar a janela Selecionar campo para adicionar segmentMembership.seg_namespace.seg_id.status às suas exportações de arquivo. Em vez disso, você precisa colar manualmente o valor xdm: segmentMembership.seg_namespace.seg_id.status no campo de esquema, como mostrado abaixo.
segmentMembership.seg_namespace.seg_id.statussegmentMembership.seg_namespace.seg_id.lastQualificationTime
As exportações de arquivos variam das seguintes maneiras, dependendo se segmentMembership.seg_namespace.seg_id.status está ou não selecionado:
- Se o campo
segmentMembership.seg_namespace.seg_id.statusestiver selecionado, os arquivos exportados incluirão membros Ativos no instantâneo completo inicial e membros recém-Ativos e Expirados em exportações incrementais subsequentes. - Se o campo
segmentMembership.seg_namespace.seg_id.statusnão estiver selecionado, os arquivos exportados incluirão apenas membros Ativos no instantâneo completo inicial e em exportações incrementais subsequentes.
Leia mais sobre comportamento de exportação de perfil para destinos baseados em arquivo.
Os namespaces de identidade não podem ser selecionados atualmente para exportações identity-namespaces-export-limitation
No momento, não há suporte para a seleção de namespaces de identidade para exportação, como mostrado na imagem abaixo. Selecionar qualquer namespace de identidade para exportação resultará em um erro na etapa Revisão.
Como solução temporária, se você precisar adicionar namespaces de identidade aos arquivos exportados durante a versão beta, será possível:
- Use os destinos de armazenamento na nuvem herdados para os fluxos de dados em que deseja incluir namespaces de identidade nas exportações
- Faça upload de identidades como atributos na Experience Platform e, em seguida, exporte-as para seus destinos de armazenamento na nuvem.