[Disponibilidad limitada]{class="badge informative"}
Audiencias de Source desde el almacenamiento de Azure
Conecte Azure Blob Storage o Azure Data Lake Storage (ADLS) Gen2 a Adobe Real-Time CDP Collaboration para obtener datos de audiencia de origen para la activación y el análisis de superposición.
Use esta guía para crear una conexión de datos Azure reutilizable y ejecutar una importación única desde la ubicación de almacenamiento configurada. Antes de empezar, confirme que los archivos de audiencia cumplen con la especificación de fuentes de audiencias. Concederá acceso de lectura a Adobe a su almacenamiento de Azure durante el proceso de configuración.
Elija su tipo de origen Azure choose-source-type
Collaboration admite dos opciones de ingesta de Azure. Utilice la tabla siguiente para elegir la ruta de la guía que coincida con la ubicación de los archivos de audiencia.
Solo puede configurar un tipo de origen por conexión de datos. Para crear el origen de Blob y ADLS, cree conexiones de datos independientes.
Requisitos previos prerequisites
Antes de seguir esta guía, complete la incorporación y configuración de la cuenta. A continuación, complete los requisitos previos en esta sección antes de iniciar el flujo de trabajo de configuración.
Algunos pasos requieren la acción de un administrador de Azure. Si usted no es el administrador de Azure de su organización, identifique a la persona adecuada antes de comenzar.
Acceso y permisos de Azure azure-access-and-permissions
Antes de configurar la conexión en Collaboration, usted o el administrador de Azure deben otorgar acceso de lectura a Adobe al contenedor de almacenamiento o al sistema de archivos ADLS Gen2 que contiene los archivos de audiencia. Una vez completada la configuración de permisos, el flujo de trabajo de configuración de Collaboration valida el acceso durante el paso Consentimiento.
Preparación de los datos de audiencia prepare-audience-data
Los archivos de audiencia deben cumplir con la Especificación de fuentes de audiencia (v1.2) antes de que comience el abastecimiento.
Los requisitos clave incluyen:
- Formato de archivo: CSV, con comas como delimitadores de campo y barras verticales (
|) como separadores de varios valores dentro de un solo campo. - Campos obligatorios: Cada registro debe incluir una columna
AUDIENCE_IDy al menos una columna de clave de coincidencia admitida. - Claves de coincidencia admitidas:
HASHED_EMAIL_SHA_256,HASHED_PHONE_SHA_256,HASHED_IPV4_SHA_256,CRM_ID,LOYALTY_ID,ADFIXUS_ID. - Requisitos de hash: Todos los valores de clave de coincidencia deben estar recortados, en minúsculas y con hash SHA256 antes de la carga. Collaboration no hash ni normaliza los datos antes de la ingesta.
- Coherencia de columna: Todos los archivos de la ruta de acceso configurada deben utilizar estructuras de columna idénticas.
Todas las claves de coincidencia presentes en los archivos de audiencia también deben habilitarse para la cuenta de Collaboration. Consulte Configurar claves de coincidencia para obtener instrucciones.
Valores necesarios antes de comenzar values-required
Tenga preparados los siguientes valores antes de iniciar el flujo de trabajo de configuración.
customerdatastoredatalake-prodaudience-ingestaudiencessourcing/audiences/path1/sourcing/inbound/00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000Configurar permisos de Azure set-up-azure-permissions
Complete los pasos de esta sección para preparar su entorno de Azure. Adobe requiere acceso de lectura al contenedor de almacenamiento para que el flujo de trabajo de configuración de Collaboration pueda establecer una conexión. Este trabajo se realiza en el portal Azure y es posible que el administrador Azure deba completarlo.
Después de completar esta sección, procede a Configurar tu Azure conexión.
Obtener el identificador principal de servicio Azure de Adobe obtain-principal-identifier
Antes de completar los pasos de asignación de funciones que se indican a continuación, póngase en contacto con el equipo de su cuenta de Adobe para obtener el identificador principal de servicio Azure para su región (Norteamérica, EMEA o Australia y Nueva Zelanda). Utilizará este identificador para otorgar acceso de lectura a Adobe a su almacenamiento.
Configurar permisos de Azure Blob Storage set-up-azure-blob-storage-permissions
- En el Azure portal, abra la cuenta de almacenamiento, vaya a Contenedores y seleccione el contenedor que contiene los archivos de audiencia.
- Seleccione Access control (IAM) y luego seleccione Add role assignment.
- Asigne el rol Storage Blob Data Reader al principal de Adobe en el ámbito del contenedor.
- Seleccione Guardar.
Configuración de permisos de ADLS Gen2 set-up-adls-gen2-permissions
Para conexiones ADLS Gen2, el campo Container en Collaboration corresponde al sistema de archivos ADLS Gen2 en Azure. Utilice el sistema de archivos que contiene los archivos de audiencia.
Antes de asignar permisos, confirme que la cuenta de almacenamiento tiene área de nombres jerárquica habilitada y que las reglas de firewall o de extremo privado permiten el acceso a Adobe.
- En el Azure portal, abra la cuenta de almacenamiento que contiene su sistema de archivos ADLS Gen2.
- Abra el sistema de archivos que contiene los archivos de audiencia.
- Seleccione Control de acceso (IAM) y, a continuación, seleccione Agregar asignación de rol.
- Asigne el rol Storage Blob Data Reader al principal de Adobe en el ámbito del sistema de archivos o directorio.
- Seleccione Guardar.
Después de completar la configuración de permisos para tu tipo de origen, continúa con Configurar tu Azure conexión.
Configurar su conexión de Azure configure-your-azure-connection
Use el flujo de trabajo de configuración de Collaboration para validar los detalles de almacenamiento de Azure, confirmar el acceso a Adobe, revisar los campos de identidad asignados automáticamente y crear la conexión de datos.
Añadir una nueva conexión de datos add-new-data-connection
Vaya a Configuración > Mis audiencias y, a continuación, seleccione el icono Agregar (
Aparece el flujo de trabajo Agregar audiencia. Seleccione Agregar una nueva conexión de datos y, a continuación, seleccione Siguiente.
Seleccione su origen de datos Azure select-azure-data-source
Seleccione Azure Blob Storage o Azure Data Lake Storage Gen2 y, a continuación, seleccione Siguiente.
Continúe con los pasos restantes para validar la conexión de Azure, confirmar el acceso de Adobe, revisar las asignaciones de campos y crear la conexión de datos.
Introducir credenciales de conexión enter-connection-credentials
En el paso Credenciales, proporcione la información necesaria para tener acceso a la ubicación de almacenamiento Azure.
Después de especificar los valores requeridos, selecciona Conectarse a Azure.
Un mensaje de confirmación indica que la conexión se ha establecido correctamente. Haga clic en Siguiente para continuar.
Conceder acceso a Adobe a su almacenamiento de Azure grant-adobe-access
En el paso Consentimiento, Collaboration valida los permisos de Azure que configuró anteriormente.
Seleccione el icono de inicio junto a URL de consentimiento para abrir el flujo de trabajo de autorización en Azure. Inicie sesión con una cuenta que tenga permiso para conceder consentimiento para la ubicación de almacenamiento y, a continuación, complete las solicitudes de autorización de Azure que conceden a Adobe acceso a la ubicación de almacenamiento configurada. Una vez completada la autorización, vuelva a Collaboration y seleccione Confirmar consentimiento para validar el acceso de Adobe.
Cuando la validación del consentimiento se realiza correctamente, aparece el mensaje de confirmación Consentimiento concedido. Haga clic en Siguiente para continuar.
Revisar asignaciones de campo review-field-mappings
En el paso Asignación de campos, Collaboration asigna automáticamente los campos de identidad admitidos de los archivos de origen.
No se requiere ninguna configuración manual.
Revise las asignaciones mostradas y confirme que los campos de origen coinciden con las columnas de identidad de los archivos de audiencia. Haga clic en Siguiente para continuar.
Revisión y finalización de la conexión review-and-complete
En el paso Revisar, compruebe la cuenta de almacenamiento, el contenedor, la ruta de origen, el identificador de inquilino y las asignaciones de campos.
La página de revisión también indica que el flujo de trabajo actual Azure realiza una única ejecución de abastecimiento y no configura una programación recurrente.
Cuando la configuración sea correcta, seleccione Completar.
Confirmar la conexión y monitorizar las audiencias de origen confirm-connection-and-monitor-audiences
Después de seleccionar Completar, Collaboration crea la conexión de datos y lo desplaza a Configuración > Mis conexiones de datos.
Confirme que la conexión se ha creado. confirm-connection-created
La tarjeta de conexión de Mis conexiones de datos confirma que la conexión se creó correctamente. La tarjeta muestra el tipo de origen (Azure Blob Storage o Azure Data Lake Storage Gen2), la fecha de creación, las claves de coincidencia, el recuento de público y el estado de conexión actual.
Ver audiencias de origen view-sourced-audiences
Una vez creada la conexión, Collaboration empieza a obtener audiencias automáticamente desde la ubicación Azure configurada. Vaya a Configuración > Mis audiencias para supervisar el progreso de abastecimiento y revisar las audiencias de origen.
Las audiencias de origen aparecen en la tabla Mis audiencias. Utilice el estado de la audiencia, el recuento de identidades, el origen, la conexión de datos y la fecha de la última actualización para confirmar que las audiencias esperadas provienen de su conexión de Azure.
Limitaciones conocidas known-limitations
Revise las siguientes limitaciones antes de crear o administrar una conexión de datos de Azure.
- Restricciones de clave de coincidencia: Las claves de coincidencia no se pueden quitar de una conexión existente. Para cambiar las claves de coincidencia activas, elimine la conexión y cree una nueva.
- Una conexión activa por tipo de origen de Azure: Puede tener una conexión Blob activa y una conexión ADLS Gen2 activa por cuenta. Para cambiar la ubicación de almacenamiento, elimine la conexión existente y cree una nueva.
- Compatibilidad con subcarpetas: Collaboration solo ingiere archivos directamente bajo la ruta de acceso configurada. No ingiere archivos de subcarpetas anidadas.
- Tipos de origen independientes: Blob y ADLS Gen2 son conexiones distintas; no mezcle la configuración entre ellos en una sola ejecución del asistente.
Resolución de problemas troubleshooting
Las audiencias no aparecen o el abastecimiento es lento audiences-not-appearing
Si las audiencias de origen no aparecen después de crear la conexión, complete las siguientes acciones.
- Confirme que los archivos de audiencia existen directamente en la ruta configurada y cumplen con la Especificación del Abastecimiento de audiencias.
- Compruebe si hay errores en Mis conexiones de datos.
- Póngase en contacto con el servicio de asistencia de Adobe e indique el nombre de la conexión, la cuenta de almacenamiento y los detalles del contenedor si los problemas persisten pasadas 24 horas.
Las audiencias se originan, pero muestran cero o identidades inesperadas zero-identities
Si las audiencias aparecen después del origen, pero los recuentos de identidad son cero o inferiores a lo esperado, complete las siguientes acciones.
- Compruebe que todos los valores clave de coincidencia de los archivos de audiencia estén recortados, en minúsculas y con hash SHA256 antes de la carga. Collaboration no hash ni normaliza los datos de ingesta.
- Confirme que las claves de coincidencia presentes en los archivos estén habilitadas para su cuenta de Collaboration. Ver Configurar claves de coincidencia.
Error de conexión después del éxito inicial connection-failed
Utilice estas comprobaciones cuando una conexión se haya creado correctamente pero más tarde introduzca un estado de error.
- Compruebe que la asignación de rol RBAC Azure del principal de Adobe no se quitó ni se estrechó.
- Confirme que los archivos siguen existiendo en la ruta y que coinciden con la especificación.
Errores de importación o formato format-errors
Utilice estas comprobaciones cuando falle el abastecimiento debido a problemas de estructura de archivos, hash o formato de columna.
- Asegúrese de que todos los archivos mantienen la misma estructura de columnas y reglas de hash que la ingesta inicial.
Próximos pasos next-steps
Una vez finalizado el abastecimiento, las audiencias estarán disponibles en Mis audiencias para los flujos de trabajo de activación, análisis de superposición y medición. Para activar audiencias de origen con colaboradores, consulte Activar audiencias.
Otros métodos de abastecimiento disponibles incluyen Experience Platform, Amazon S3, Google Cloud Storage, Snowflake y la carga de archivos CSV. Para ver otros métodos de obtención de audiencias, consulte:
- Configuración de Google Cloud Storage para el abastecimiento de audiencias
- Configuración de Snowflake para el abastecimiento de audiencias
- Configuración de AWS S3 para el abastecimiento de audiencias
- Audiencias de Source de Experience Platform
- Cargar un archivo CSV para el abastecimiento de audiencias