Configuración del área de nombres de identidad

El Experience Platform utiliza áreas de nombres de identidad para describir el tipo de identidades específicas. Por ejemplo, un área de nombres de identidad llamada Email identifica un valor como name@email.com como dirección de correo electrónico.

Al crear un destino mediante Destination SDK, además de lo siguiente configuración de un esquema de socio Para que los usuarios puedan asignar atributos de perfil e identidades a, también puede definir áreas de nombres de identidad compatibles con la plataforma de destino.

Al hacerlo, los usuarios tienen la opción añadida de seleccionar identidades de destino, además de atributos de perfil de destino.

Para obtener más información sobre Áreas de nombres de identidad en Experience Platform, consulte la documentación de áreas de nombres de identidad.

Al configurar áreas de nombres de identidad para su destino, puede ajustar la asignación de identidad de destino admitida por su destino, como:

Para saber dónde encaja este componente en una integración creada con Destination SDK, consulte el diagrama en la opciones de configuración o consulte la guía sobre cómo usar Destination SDK para configurar un destino basado en archivos.

Puede configurar las áreas de nombres de identidad admitidas mediante el /authoring/destinations punto final. Consulte las siguientes páginas de referencia de la API para ver ejemplos detallados de llamadas de la API donde puede configurar los componentes que se muestran en esta página.

Este artículo describe todas las opciones de configuración de áreas de nombres de identidad admitidas que puede utilizar para su destino y muestra lo que los clientes verán en la interfaz de usuario de Platform.

IMPORTANT
Todos los nombres y valores de parámetro admitidos por el Destination SDK son distingue mayúsculas de minúsculas. Para evitar errores de distinción entre mayúsculas y minúsculas, utilice los nombres y valores de los parámetros exactamente como se muestra en la documentación.

Tipos de integración admitidos supported-integration-types

Consulte la tabla siguiente para obtener detalles sobre qué tipos de integraciones admiten la funcionalidad descrita en esta página.

Tipo de integración
Admite funcionalidad
Integraciones en tiempo real (streaming)
Integraciones basadas en archivos (por lotes)

Parámetros admitidos supported-parameters

Al definir las identidades de destino que admite su destino, puede utilizar los parámetros descritos en la tabla siguiente para configurar su comportamiento.

Parámetro
Tipo
Obligatorio/Opcional
Descripción
acceptsAttributes
Booleano
Opcional
Indica si los clientes pueden asignar atributos de perfil estándar a la identidad que está configurando.
acceptsCustomNamespaces
Booleano
Opcional
Indica si los clientes pueden asignar áreas de nombres de identidad personalizadas al área de nombres de identidad que está configurando.
acceptedGlobalNamespaces
-
Opcional
Indica cuál áreas de nombres de identidad estándar (por ejemplo, IDFA) los clientes pueden asignar a la identidad que está configurando.
transformation
Cadena
Opcional
Muestra el Aplicar transformación de la IU de Platform, cuando el campo de origen es un atributo XDM o un área de nombres de identidad personalizada. Utilice esta opción para dar a los usuarios la capacidad de hash los atributos de origen en la exportación. Para habilitar esta opción, establezca el valor en sha256(lower($)).
requiredTransformation
Cadena
Opcional
Cuando los clientes seleccionan este área de nombres de identidad de origen, la variable Aplicar transformación La casilla de verificación de se aplica automáticamente a la asignación y los clientes no pueden deshabilitarla. Para habilitar esta opción, establezca el valor en sha256(lower($)).
"identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   }

Debe indicar qué Platform identidades que los clientes pueden exportar a su destino. Algunos ejemplos son Experience Cloud ID, correo electrónico con hash, ID de dispositivo (IDFA, GAID). Estos valores son Platform áreas de nombres de identidad que los clientes pueden asignar a áreas de nombres de identidad desde el destino.

Las áreas de nombres de identidad no requieren una correspondencia de 1 a 1 entre Platform y su destino.
Por ejemplo, los clientes podrían asignar un Platform IDFA área de nombres a IDFA Área de nombres de su destino o pueden asignar lo mismo Platform IDFA área de nombres a Customer ID área de nombres en su destino.

Obtenga más información sobre las identidades en información general del área de nombres de identidad.

Consideraciones de asignación

Si los clientes seleccionan un área de nombres de identidad de origen y no seleccionan una asignación de destino, Platform rellena automáticamente la asignación de destino con un atributo con el mismo nombre.

Configuración del hashing de campos de origen opcional

Los clientes de Experience Platform pueden elegir ingerir datos en Platform en formato hash o en texto sin formato. Si la plataforma de destino acepta datos con y sin hash, puede dar a los clientes la opción de elegir si Platform debe tener un hash de los valores del campo de origen cuando se exporten al destino.

La siguiente configuración habilita la opción Aplicar transformación en la IU de Platform, en el paso Asignación.

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

Marque esta opción cuando utilice campos de origen sin hash, para que Adobe Experience Platform aplique un algoritmo hash en ellos automáticamente en la activación.

Cuando asigne atributos de origen sin hash a atributos de destino que el destino espera que tengan hash (por ejemplo: email_lc_sha256 o phone_sha256), marque la Aplicar transformación para que Adobe Experience Platform agregue automáticamente los atributos de origen al activarlos.

Configuración del hashing obligatorio de campos de origen

Si el destino solo acepta datos con hash, puede configurar los atributos exportados para que Platform los aplique automáticamente. La siguiente configuración comprueba automáticamente la Aplicar transformación cuando la opción Email y Phone Las identidades están asignadas.

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

Pasos siguientes next-steps

Después de leer este artículo, debería comprender mejor cómo configurar las áreas de nombres de identidad para los destinos creados con Destination SDK.

Para obtener más información acerca de los demás componentes de destino, consulte los siguientes artículos:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6