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.

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 (flujo continuo) a través de Destination SDK, además de configuración de un esquema de socio a los que los usuarios pueden asignar atributos e identidades de perfil, también debe definir al menos uno áreas de nombres de identidad admitidas por 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 se describe 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 atributos de perfil de destinatario. 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 las á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 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)
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 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 los hash automáticamente al activarlos.

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