Importación y uso de audiencias externas

Adobe Experience Platform admite la capacidad de importar audiencias externas, que posteriormente pueden utilizarse como componentes para una nueva audiencia. Este documento proporciona un tutorial para configurar Experience Platform para importar y utilizar audiencias externas.

Introducción

Este tutorial requiere una comprensión práctica de los distintos servicios de Adobe Experience Platform implicados en la creación de audiencias. Antes de comenzar este tutorial, revise la documentación de los siguientes servicios:

Audiencias o definiciones de segmentos

Antes de empezar a importar y usar audiencias externas, es importante comprender la diferencia entre las audiencias y las definiciones de segmentos.

Las audiencias se refieren al grupo de perfiles por el que intenta filtrar. Al utilizar definiciones de segmentos, puede crear una audiencia creando una definición de segmento que filtre los perfiles al subconjunto que cumpla los criterios de calificación de segmentos.

Las definiciones de segmentos incluyen información como 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.

Crear un área de nombres de identidad para la audiencia externa

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 una audiencia.

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 como Identificador de no personas.

Creación de un esquema para los metadatos del segmento

Después de crear un área de nombres de identidad, debe crear un nuevo esquema para el segmento que va a crear.

Para comenzar a maquetar un esquema, primero seleccione Esquemas en la barra de navegación izquierda, seguido de Crear esquema en la esquina superior derecha del área de trabajo Esquemas. Desde aquí, seleccione Examinar para ver una selección completa de los tipos de esquemas disponibles.

Dado que está creando una definición de segmento, que es una clase predefinida, seleccione Usar clase existente. Ahora, seleccione la clase Segment definition, seguida de Assign class.

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 el campo _id como identidad principal, seleccione el título del esquema, seguido de la opción denominada Perfil. Seleccione Habilitar 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.

Crear un conjunto de datos para el esquema

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 la opción Crear conjunto de datos a partir del esquema con el esquema que creó anteriormente.

Después de crear el conjunto de datos, siga siguiendo las instrucciones de la guía del usuario del conjunto de datos para habilitar este conjunto de datos para el perfil del cliente en tiempo real.

Configuración e importación de datos de audiencia

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.

Ingesta de datos mediante una conexión por lotes

Para crear una conexión por lotes, puede seguir las instrucciones de la guía de la interfaz de usuario de carga de archivos locales genérica. Para obtener una lista completa de los orígenes disponibles con los que puede utilizar la ingesta de datos, lea información general de orígenes.

Ingesta de datos mediante una conexión de flujo continuo

Para crear una conexión de flujo continuo, puede seguir las instrucciones del tutorial de la API o del tutorial de la interfaz de usuario.

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 aprender a enviar datos a estos extremos, lea el tutorial sobre datos de registros de flujo continuo.

Estructura de metadatos de audiencia

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"
        }
    }
}

Generación de segmentos con audiencias importadas

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 la pestaña Audiencias en la sección Campos.

Pasos siguientes

Ahora que puede usar audiencias externas en los segmentos, puede usar el Generador de segmentos para crear segmentos. Para aprender a crear segmentos, lea el tutorial sobre la creación de segmentos.

Apéndice

Además de utilizar metadatos de audiencia externos importados y utilizarlos para crear segmentos, también puede importar suscripciones a segmentos externos a Platform.

Configurar un esquema de destino de pertenencia a segmento externo

Para comenzar a maquetar un esquema, primero seleccione Esquemas en la barra de navegación izquierda, seguido de Crear esquema en la esquina superior derecha del área de trabajo Esquemas. 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 pertenencia a segmentos, seguido de Agregar grupos de campos.

Además, asegúrese de que el esquema esté marcado para Profile. Para ello, debe marcar un campo como la identidad principal.

Configurar el conjunto de datos

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 la opción Crear conjunto de datos a partir del esquema con el esquema que creó anteriormente.

Después de crear el conjunto de datos, siga siguiendo las instrucciones de la guía del usuario del conjunto de datos para habilitar este conjunto de datos para el perfil del cliente en tiempo real.

Configuración e importación de datos de pertenencia a audiencias externas

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.

Ingesta de datos mediante una conexión por lotes

Para crear una conexión por lotes, puede seguir las instrucciones de la guía de la interfaz de usuario de carga de archivos locales genérica. Para obtener una lista completa de los orígenes disponibles con los que puede utilizar la ingesta de datos, lea información general de orígenes.

Ingesta de datos mediante una conexión de flujo continuo

Para crear una conexión de flujo continuo, puede seguir las instrucciones del tutorial de la API o del tutorial de la interfaz de usuario.

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 aprender a enviar datos a estos extremos, lea el tutorial sobre datos de registros de flujo continuo.

Estructura del abono de segmentos

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"
                    }
                }
            }
        }
    }
}