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 denominada Email identifica un valor como name@email.com como dirección de correo electrónico.

Según el tipo de destino que cree (de flujo continuo o basado en archivos), tenga en cuenta los siguientes requisitos del área de nombres de identidad:

  • Al crear destinos en tiempo real (streaming) a través de Destination SDK, además de configurar un esquema de socio al que los usuarios pueden asignar atributos e identidades de perfil, también debe definir al menos una área de nombres de identidad que sea compatible con su plataforma de destino. Por ejemplo, si su plataforma de destino acepta correos electrónicos con hash y IDFA, debe definir estas dos identidades como descritas más adelante en este documento.

    note important
    IMPORTANT
    Al activar audiencias en destinos de flujo continuo, los usuarios también deben asignar al menos una identidad de destino, además de los atributos de perfil de destino. De lo contrario, las audiencias no se activarán en la plataforma de destino.
  • Al crear destinos basados en archivos mediante Destination SDK, la configuración de áreas de nombres de identidad es opcional.

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 documentación de 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 a través del extremo /authoring/destinations. 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 distinguen entre mayúsculas y minúsculas 1}. 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)
Sí (obligatorio)
Integraciones basadas en archivos (por lotes)
Sí (opcional)

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 qué áreas de nombres de identidad estándar (por ejemplo, IDFA) los clientes pueden asignar a la identidad que está configurando.
transformation
Cadena
Opcional
Muestra la casilla de verificación Aplicar transformación en la interfaz de usuario 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 casilla de verificación Aplicar transformación 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é identidades de Platform pueden exportar los clientes 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 su 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 área de nombres Platform IDFA a un área de nombres IDFA desde su destino, o pueden asignar el mismo área de nombres Platform IDFA a un área de nombres Customer ID en su destino.

Obtenga más información sobre identidades en la descripció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 configuración siguiente habilita la opción Aplicar transformación opcional en la interfaz de usuario 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 opción Aplicar transformación para que Adobe Experience Platform aplique automáticamente hash a 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 configuración siguiente comprueba automáticamente la opción Aplicar transformación cuando se asignan las identidades Email y Phone.

"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