Configuração do namespace de identidade

Experience Platform usa namespaces de identidade para descrever o tipo de identidades específicas. Por exemplo, um namespace de identidade chamado Email identifica um valor como name@email.com como um endereço de email.

Dependendo do tipo de destino que você criar (streaming ou baseado em arquivo), lembre-se dos seguintes requisitos de namespace de identidade:

Para saber mais sobre namespaces de identidade em Experience Platform, consulte a documentação de namespaces de identidade.

Ao configurar namespaces de identidade para seu destino, você pode ajustar o mapeamento de identidade de destino compatível com seu destino, como:

Para entender onde esse componente se encaixa em uma integração criada com o Destination SDK, consulte o diagrama na documentação de opções de configuração ou consulte o guia sobre como usar o Destination SDK para configurar um destino baseado em arquivo.

Você pode configurar seus namespaces de identidade compatíveis por meio do ponto de extremidade /authoring/destinations. Consulte as seguintes páginas de referência de API para obter exemplos detalhados de chamadas de API, onde é possível configurar os componentes mostrados nesta página.

Este artigo descreve todas as opções de configuração de namespaces de identidade com suporte que você pode usar para o seu destino e mostra o que você vê na interface do usuário do Experience Platform.

Tipos de integração compatíveis supported-integration-types

Consulte a tabela abaixo para obter detalhes sobre quais tipos de integrações suportam a funcionalidade descrita nesta página.

Parâmetros compatíveis supported-parameters

Ao definir as identidades de público-alvo compatíveis com seu destino, você pode usar os parâmetros descritos na tabela abaixo para configurar seu comportamento.

"identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   }

Você deve indicar quais Experience Platform identidades você pode exportar para seu destino. Alguns exemplos são Experience Cloud ID, email com hash, ID de dispositivo (IDFA, GAID). Esses valores são Experience Platform namespaces de identidade que você pode mapear para namespaces de identidade de seu destino.

Os namespaces de identidade não exigem uma correspondência de 1 para 1 entre Experience Platform e seu destino. Por exemplo, você pode mapear um namespace Experience Platform IDFA para um namespace IDFA de seu destino ou mapear o mesmo namespace Experience Platform IDFA para um namespace Customer ID de seu destino.

Leia mais sobre identidades na visão geral do namespace de identidade.

Considerações de mapeamento mapping-considerations

Se você selecionar um namespace de identidade de origem e não selecionar um target mapping, o Experience Platform preencherá automaticamente o target mapping com um atributo com o mesmo nome.

Configurar hash de campo de origem opcional configure-optional-hashing

No Experience Platform, você pode optar por assimilar dados em formato com hash ou em texto sem formatação. Se a plataforma de destino aceitar dados com hash e sem hash, você poderá escolher se Experience Platform aplicará hash aos valores do campo de origem quando eles forem exportados para o seu destino.

A configuração abaixo habilita a opção Aplicar transformação opcional na interface do usuário Experience Platform, na etapa Mapeamento.

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
            },
            "Phone":{
            }
         }
      }
   }

Marque essa opção ao usar campos de origem sem hash, para que a Adobe Experience Platform faça o hash automaticamente na ativação.

Ao mapear atributos de origem com hash não atribuídos para atributos de destino que o destino espera que tenham hash (por exemplo: email_lc_sha256 ou phone_sha256), marque a opção Aplicar transformação para que Adobe Experience Platform coloque os atributos de origem em hash automaticamente na ativação.

Configurar hash de campo de origem obrigatório configure-mandatory-hashing

Se o seu destino aceitar apenas dados com hash, você poderá configurar os atributos exportados para serem automaticamente transformados em hash pelo Experience Platform. A configuração abaixo verifica automaticamente a opção Aplicar transformação quando as identidades Email e Phone são mapeadas.

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
               "requiredTransformation": "sha256(lower($))"
            },
            "Phone":{
               "requiredTransformation": "sha256(lower($))"
            }
         }
      }
   }

Próximas etapas next-steps

Agora você entende como configurar namespaces de identidade para destinos criados com o Destination SDK, incluindo como permitir mapeamentos de atributos e namespaces e como aplicar hash opcional ou obrigatório na exportação.

Para saber mais sobre os outros componentes de destino, consulte os seguintes artigos: