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

IMPORTANT
Sempre configure uma chave de desduplicação para exportações agendadas. Sem a desduplicação, você pode ver linhas duplicadas ou associação de segmento conflitante para o mesmo perfil, pois as exportações programadas processam dados instantâneos e incrementais.

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
IMPORTANT
É possível exportar um único namespace de identidade para um destino, e o namespace é automaticamente definido como chave de desduplicação. Não há suporte para enviar vários namespaces para um destino.
Não é possível usar uma combinação de namespaces de identidade e atributos de perfil como chaves de desduplicação.

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.

personalEmail
firstName
lastName
johndoe@example.com
John
Doe
johndoe@example.com
John
D

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.

E-mail*
personalEmail
firstName
lastName
johndoe@example.com
johndoe@example.com
John
D
doejohn_2@example.com
johndoe@example.com
John
D

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.

personalEmail*
firstName
lastName
johndoe@example.com
John
D

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.

personalEmail*
lastName*
firstName
johndoe@example.com
D
John
johndoe@example.com
Doe
John

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:

E-mail*
first_name
last_name
carimbo de data e hora
test1@test.com
John
Morris
2024-10-12T09:50
test1@test.com
John
Doe
2024-10-12T09:50
test2@test.com
Frank
Smith
2024-10-12T09:50

Após a desduplicação, o arquivo de exportação conterá:

E-mail*
first_name
last_name
carimbo de data e hora
test1@test.com
John
Doe
2024-10-12T09:50
test2@test.com
Frank
Smith
2024-10-12T09:50

Explicaçã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.

Gravação de tela mostrando a solução alternativa de associação de público na etapa de mapeamento do fluxo de trabalho de ativação. {modal="regular"}

NOTE
Para destinos de armazenamento em nuvem, os seguintes atributos são adicionados ao mapeamento por padrão:
  • segmentMembership.seg_namespace.seg_id.status
  • segmentMembership.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.status estiver 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.status nã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.

Mapeamento sem suporte mostrando exportações de identidade. {modal="regular"}

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.
recommendation-more-help
experience-platform-help-destinations