Adobe Experience Platform admite la capacidad de importar audiencias externas, que posteriormente pueden utilizarse como componentes para una nueva definición de segmento. Este documento proporciona un tutorial para configurar Experience Platform para importar y utilizar audiencias externas.
Este tutorial requiere una comprensión práctica de los distintos Adobe Experience Platform servicios implicados en la creación de segmentos de audiencia. Antes de comenzar este tutorial, revise la documentación de los siguientes servicios:
Antes de empezar a importar y usar audiencias externas, es importante comprender la diferencia entre los datos de los segmentos y los metadatos de los segmentos.
Los datos de segmentos hacen referencia a los perfiles que cumplen los criterios de calificación de segmentos y, por lo tanto, forman parte de la audiencia.
Los metadatos del segmento son información sobre el propio segmento, que incluye el nombre, la descripción, la expresión (si corresponde), la fecha de creación, la última fecha de modificación y un ID. El ID vincula los metadatos del segmento con los perfiles individuales que cumplen con la calificación del segmento y forman parte de la audiencia resultante.
Datos de segmentos | Metadatos de segmentos |
---|---|
Perfiles que cumplen los requisitos de calificación de segmentos | Información sobre el propio segmento |
El primer paso para utilizar audiencias externas es crear un área de nombres de identidad. Las áreas de nombres de identidad permiten que Platform asocie el lugar desde el que se origina un segmento.
Para crear un área de nombres de identidad, siga las instrucciones de la guía del área de nombres de identidad. Al crear el área de nombres de identidad, agregue los detalles de origen al área de nombres de identidad y marque su Tipo as a Identificador de no personas.
Después de crear un área de nombres de identidad, debe crear un nuevo esquema para el segmento que va a crear.
Para empezar a maquetar un esquema, seleccione primero Esquemas en la barra de navegación izquierda, seguido de Crear esquema en la esquina superior derecha del espacio de trabajo Esquemas. Desde aquí, seleccione Examinar para ver una selección completa de los tipos de esquema disponibles.
Dado que está creando una definición de segmento, que es una clase predefinida, seleccione Utilizar clase existente. Ahora, seleccione la Definición del segmento clase, seguida de Asignar clase.
Ahora que se ha creado el esquema, debe especificar qué campo contendrá el ID del segmento. Este campo debe marcarse como identidad principal y asignarse a las áreas de nombres creadas anteriormente.
Después de marcar la variable _id
como identidad principal, seleccione el título del esquema, seguido de la opción denominada Perfil. Seleccionar Activar para habilitar el esquema para Real-Time Customer Profile.
Ahora, este esquema está habilitado para el perfil, con la identificación principal asignada al área de nombres de identidad de no persona que ha creado. Como resultado, esto significa que los metadatos de segmento importados en Platform mediante este esquema se incorporarán en el perfil sin combinarse con otros datos de perfil relacionados con personas.
Después de configurar el esquema, deberá crear un conjunto de datos para los metadatos del segmento.
Para crear un conjunto de datos, siga las instrucciones de la guía del usuario del conjunto de datos. Debe seguir las Crear conjunto de datos a partir de esquema , utilizando el esquema creado anteriormente.
Después de crear el conjunto de datos, siga las instrucciones del guía del usuario del conjunto de datos para habilitar este conjunto de datos para el perfil del cliente en tiempo real.
Con el conjunto de datos habilitado, ahora los datos se pueden enviar a Platform a través de la interfaz de usuario o mediante las API de Experience Platform. Puede introducir estos datos mediante una conexión por lotes o de flujo continuo.
Para crear una conexión por lotes, puede seguir las instrucciones del genérico guía de IU de carga de archivos locales. Para obtener una lista completa de las fuentes disponibles con las que puede utilizar la ingesta de datos, lea la información general de orígenes.
Para crear una conexión de flujo continuo, puede seguir las instrucciones de la Tutorial de API o el Tutorial de IU.
Una vez que haya creado su conexión de flujo continuo, tendrá acceso a su punto final de flujo único al que puede enviar sus datos. Para obtener información sobre cómo enviar datos a estos extremos, lea la tutorial sobre streaming de datos de registro.
Después de crear una conexión, ahora puede introducir los datos en Platform.
A continuación se muestra una muestra de los metadatos de la carga útil de audiencia externa:
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{SEGMENT_ID}",
"description": "Sample description",
"identityMap": {
"{IDENTITY_NAMESPACE}": [{
"id": "{}"
}]
},
"segmentName" : "{SEGMENT_NAME}",
"segmentStatus": "ACTIVE",
"version": "1.0"
}
}
}
Propiedad | Descripción |
---|---|
schemaRef |
El esquema debe consulte el esquema creado anteriormente para los metadatos del segmento. |
datasetId |
ID del conjunto de datos debe consulte el conjunto de datos creado anteriormente para el esquema que acaba de crear. |
xdmEntity._id |
El ID debe consulte el mismo ID de segmento que utiliza como audiencia externa. |
xdmEntity.identityMap |
Esta sección debe contienen la etiqueta de identidad utilizada al crear el área de nombres creada anteriormente. |
{IDENTITY_NAMESPACE} |
Esta es la etiqueta del área de nombres de identidad creada anteriormente. Por lo tanto, si llamara al área de nombres de identidad "externalAudience", la usaría como clave de la matriz. |
segmentName |
El nombre del segmento por el que desea segmentar la audiencia externa. |
Una vez configuradas las audiencias importadas, pueden utilizarse como parte del proceso de segmentación. Para buscar audiencias externas, vaya al Generador de segmentos y seleccione Audiencias en la pestaña Campos sección.
Ahora que puede usar audiencias externas en los segmentos, puede usar el Generador de segmentos para crear segmentos. Para aprender a crear segmentos, lea la tutorial sobre creación de segmentos.
Además de utilizar metadatos de audiencia externos importados y utilizarlos para crear segmentos, también puede importar suscripciones a segmentos externos a Platform.
Para empezar a maquetar un esquema, seleccione primero Esquemas en la barra de navegación izquierda, seguido de Crear esquema en la esquina superior derecha del espacio de trabajo Esquemas. Desde aquí, seleccione Perfil individual de XDM.
Ahora que se ha creado el esquema, deberá agregar el grupo de campos de pertenencia al segmento como parte del esquema. Para ello, seleccione Detalles de abono de segmento, seguido de Adición de grupos de campos.
Además, asegúrese de que el esquema esté marcado para Perfil. Para ello, debe marcar un campo como la identidad principal.
Después de crear el esquema, deberá crear un conjunto de datos.
Para crear un conjunto de datos, siga las instrucciones de la guía del usuario del conjunto de datos. Debe seguir las Crear conjunto de datos a partir de esquema , utilizando el esquema creado anteriormente.
Después de crear el conjunto de datos, siga las instrucciones del guía del usuario del conjunto de datos para habilitar este conjunto de datos para el perfil del cliente en tiempo real.
Con el conjunto de datos habilitado, ahora los datos se pueden enviar a Platform a través de la interfaz de usuario o mediante las API de Experience Platform. Puede introducir estos datos mediante una conexión por lotes o de flujo continuo.
Para crear una conexión por lotes, puede seguir las instrucciones del genérico guía de IU de carga de archivos locales. Para obtener una lista completa de las fuentes disponibles con las que puede utilizar la ingesta de datos, lea la información general de orígenes.
Para crear una conexión de flujo continuo, puede seguir las instrucciones de la Tutorial de API o el Tutorial de IU.
Una vez que haya creado su conexión de flujo continuo, tendrá acceso a su punto final de flujo único al que puede enviar sus datos. Para obtener información sobre cómo enviar datos a estos extremos, lea la tutorial sobre streaming de datos de registro.
Después de crear una conexión, ahora puede introducir los datos en Platform.
A continuación se puede ver una muestra de la carga útil de pertenencia a audiencia externa:
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience Membership"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{UNIQUE_ID}",
"description": "Sample description",
"{TENANT_NAME}": {
"identities": {
"{SCHEMA_IDENTITY}": "sample-id"
}
},
"personId" : "sample-name",
"segmentMembership": {
"{IDENTITY_NAMESPACE}": {
"{EXTERNAL_IDENTITY}": {
"status": "realized",
"lastQualificationTime": "2022-03-14T:00:00:00Z"
}
}
}
}
}
}
Propiedad | Descripción |
---|---|
schemaRef |
El esquema debe consulte el esquema creado anteriormente para los datos de abono del segmento. |
datasetId |
ID del conjunto de datos debe consulte el conjunto de datos creado anteriormente para el esquema de pertenencia que acaba de crear. |
xdmEntity._id |
Un ID adecuado que se utiliza para identificar de forma exclusiva el registro dentro del conjunto de datos. |
{TENANT_NAME}.identities |
Esta sección se utiliza para conectar el grupo de campos de las identidades personalizadas con los usuarios importados anteriormente. |
segmentMembership.{IDENTITY_NAMESPACE} |
Esta es la etiqueta del área de nombres de identidad personalizada creada anteriormente. Por lo tanto, si llamara al área de nombres de identidad "externalAudience", la usaría como clave de la matriz. |
De forma predeterminada, las suscripciones a audiencias externas solo se conservan durante 30 días. Para conservarlos durante más de 30 días, utilice el validUntil
al introducir los datos de audiencia. Para obtener más información sobre este campo, lea la guía de Grupos de campos de esquema Detalles de abono de segmento.