Configuración del área de nombres de identidad

Experience Platform usa á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 se pueden asignar atributos e identidades de perfil, también debe definir al menos un área de nombres de identidad compatible con la 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, también debe asignar al menos una identidad de destino, además de los atributos de perfil de destino. De lo contrario, las audiencias no se activan 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 acerca de las á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 vea 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 usar para el destino y muestra lo que ve en la interfaz de usuario de Experience Platform.

IMPORTANT
Todos los nombres y valores de parámetro admitidos por Destination SDK distinguen entre mayúsculas y minúsculas. Para evitar errores de distinción entre mayúsculas y minúsculas, utilice los nombres y valores de 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 se pueden asignar atributos de perfil estándar a la identidad que se está configurando.
acceptsCustomNamespaces
Booleano
Opcional
Indica si puede asignar áreas de nombres de identidad personalizadas al área de nombres de identidad que está configurando.
acceptedGlobalNamespaces
-
Opcional
Indica las áreas de nombres de identidad estándar (por ejemplo, IDFA) que puede 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 Experience Platform, cuando el campo de origen es un atributo XDM o un área de nombres de identidad personalizada. Utilice esta opción para hash los atributos de origen en la exportación. Para habilitar esta opción, establezca el valor en sha256(lower($)).
requiredTransformation
Cadena
Opcional
Al seleccionar 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 no puede 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é Experience Platform identidades puede exportar a su destino. Algunos ejemplos son Experience Cloud ID, correo electrónico con hash, ID de dispositivo (IDFA, GAID). Estos valores son Experience Platform áreas de nombres de identidad que puede 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 Experience Platform y su destino. Por ejemplo, puede asignar un área de nombres Experience Platform IDFA a un área de nombres IDFA desde su destino, o puede asignar el mismo área de nombres Experience 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 mapping-considerations

Si selecciona un área de nombres de identidad de origen y no selecciona una asignación de destino, Experience 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 configure-optional-hashing

En Experience Platform, puede elegir ingerir datos en formato hash o en texto sin formato. Si la plataforma de destino acepta datos con hash y sin hash, puede elegir si Experience Platform almacena en hash los valores de los campos de origen cuando se exportan al destino.

La configuración siguiente habilita la opción Aplicar transformación opcional en la interfaz de usuario de Experience 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 los genere automáticamente al activarse.

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 hash automáticamente a los atributos de origen durante la activación.

Configuración del hashing obligatorio de campos de origen configure-mandatory-hashing

Si el destino solo acepta datos con hash, puede configurar los atributos exportados para que Experience 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($))"
            }
         }
      }
   }

Próximos pasos next-steps

Ahora sabe cómo configurar áreas de nombres de identidad para destinos generados con Destination SDK, incluyendo cómo permitir asignaciones de atributos y áreas de nombres y cómo aplicar hashing opcional u obligatorio en la exportación.

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

recommendation-more-help
experience-platform-help-destinations