Activar audiencias para destinos de exportación de perfiles por lotes
- Para activar audiencias y habilitar el paso de asignación del flujo de trabajo, necesita los View Destinations, Activate Destinations, View Profiles y View Segments permisos de control de acceso.
- Para activar audiencias sin pasar por el paso de asignación del flujo de trabajo, necesita los View Destinations, Activate Segment without Mapping, View Profiles y View Segments permisos de control de acceso.
- Para exportar identidades, necesita el View Identity Graph permiso de control de acceso.
{width="100" modal="regular"}
Información general overview
En este artículo se explica el flujo de trabajo necesario para activar audiencias en Adobe Experience Platform en destinos basados en archivos de perfil por lotes, como el almacenamiento en la nube y los destinos de marketing por correo electrónico.
Requisitos previos prerequisites
Para activar audiencias en destinos, debes haber conectado correctamente a un destino. Si aún no lo ha hecho, vaya al catálogo de destinos, examine los destinos admitidos y configure el destino que desee utilizar.
Formatos de archivo admitidos para la exportación supported-file-formats-export
Se admiten los siguientes formatos de archivo al exportar audiencias:
- CSV
- JSON
- Parquet
Tenga en cuenta que la exportación de archivos CSV ofrece una mayor flexibilidad en cuanto a la estructura que desea aplicar a los archivos exportados. Obtenga más información acerca de la configuración de formato de archivo para archivos CSV.
Seleccione el formato de archivo que desee exportar al crear una conexión con el destino basado en archivos.
Seleccione su destino select-destination
-
Vaya a Connections > Destinations y seleccione la ficha Catalog.
-
Seleccione Activate audiences en la tarjeta correspondiente al destino donde desea activar sus audiencias, como se muestra en la siguiente imagen.
-
Seleccione la conexión de destino que desee usar para activar las audiencias y luego seleccione Next.
-
Pasa a la siguiente sección para seleccionar tus audiencias.
Selección de audiencias select-audiences
Para seleccionar las audiencias que desea activar en el destino, utilice las casillas de verificación a la izquierda de los nombres de audiencia y luego seleccione Next.
Puede seleccionar entre varios tipos de audiencias, según su origen:
- Segmentation Service: audiencias generadas en Experience Platform por el servicio de segmentación. Consulte la documentación de segmentación para obtener más información.
- Custom upload: audiencias generadas fuera de Experience Platform y cargadas en Experience Platform como archivos CSV. Para obtener más información sobre audiencias externas, consulte la documentación sobre importación de una audiencia. Al seleccionar audiencias que se originan en Custom uploads, se habilita automáticamente el paso Seleccionar atributos de enriquecimiento.
- Otros tipos de audiencias, originadas en otras soluciones de Adobe, como Audience Manager.
Programar exportación de público scheduling
Adobe Experience Platform exporta datos para destinos de marketing por correo electrónico y almacenamiento en la nube como diferentes tipos de archivos. En la página Scheduling, puede configurar la programación y los nombres de archivo para cada audiencia que esté exportando.
Experience Platform establece automáticamente una programación predeterminada para cada exportación de archivo. Puede modificar la programación predeterminada según sus necesidades seleccionando el icono de lápiz situado junto a cada programación y definiendo una programación personalizada.
Para editar varias programaciones al mismo tiempo, seleccione las audiencias mediante las casillas de verificación situadas en la parte izquierda de la pantalla y, a continuación, seleccione Edit schedule. La programación que configure se aplicará a todos los archivos exportados para las audiencias seleccionadas.
filename.csv, filename_2.csv, filename_3.csv.Exportación de archivos completos export-full-files
Seleccione Export full files para almacenar en déclencheur la exportación de un archivo que contenga una instantánea completa de todas las calificaciones de perfil para la audiencia seleccionada.
-
Utilice el selector Frequency para seleccionar la frecuencia de exportación:
- Once: programar una exportación de archivos completa bajo demanda única.
- Daily: programar exportaciones de archivos completas una vez al día, todos los días y a la hora especificada.
- Weekly: seleccione la fecha de inicio y las exportaciones posteriores se producirán ese día de la semana hasta la fecha de finalización seleccionada.
- Monthly: seleccione la fecha de inicio y las exportaciones posteriores se producirán en esa fecha del mes hasta la fecha de finalización seleccionada. En el caso de los meses con menos de 30 o 31 días, la exportación se realiza el último día del mes.
note note NOTE Actualmente, las opciones de programación semanales y mensuales solo se admiten para los siguientes destinos de almacenamiento en la nube basados en archivos y solo cuando se activan audiencias de personas y audiencias de clientes potenciales. Las opciones de programación semanales y mensuales no están disponibles para otros tipos de destino. -
Utilice el conmutador Time para seleccionar si la exportación debe realizarse inmediatamente después de la evaluación de la audiencia o de forma programada a una hora especificada. Al seleccionar la opción Scheduled, puede utilizar el selector para elegir la hora del día, en formato UTC, en la que debe realizarse la exportación.
Utilice la opción After segment evaluation para que el trabajo de activación se ejecute inmediatamente después de que se complete el trabajo diario de segmentación por lotes de Experience Platform. Esta opción garantiza que, cuando se ejecute el trabajo de activación, los perfiles más actualizados se exporten al destino. Esto puede hacer que la audiencia se exporte varias veces al día según las acciones que realice.
note important IMPORTANT Si ejecuta una evaluación de público flexible en públicos que ya están configuradas para activarse después de la evaluación de segmentos, los públicos se activarán en cuanto finalice el trabajo de evaluación de público flexible, independientemente de cualquier trabajo de activación diario anterior. Esto puede hacer que las audiencias se exporten varias veces al día, según las acciones que realice.
Utilice la opción Scheduled para que el trabajo de activación se ejecute a una hora fija. Esta opción garantiza que los datos de perfil de Experience Platform se exporten a la misma hora cada día. Sin embargo, es posible que los perfiles que exporte no estén los más actualizados, en función de si el trabajo de segmentación por lotes se ha completado antes de que se inicie el trabajo de activación.
note important IMPORTANT Al asignar una audiencia que se creó en las últimas 24 horas y evaluó mediante segmentación por lotes, establezca la programación diaria de exportación para que comience el día siguiente como muy pronto. Esto garantiza que el trabajo de evaluación por lotes diario se ejecute primero y que se exporten los datos de audiencia completos. -
Utilice el selector Date para elegir el día o el intervalo en el que debe realizarse la exportación. Para las exportaciones diarias, la práctica recomendada es establecer las fechas de inicio y finalización para que se alineen con la duración de las campañas en las plataformas de flujo descendente.
note important IMPORTANT Al seleccionar un intervalo de exportación, el último día del intervalo no se incluye en las exportaciones. Por ejemplo, si selecciona un intervalo del 4 al 11 de enero, la última exportación de archivos se realizará el 10 de enero. -
Seleccione Create para guardar la programación.
Exportación de archivos incrementales
Seleccione Export incremental files para almacenar en déclencheur una exportación en la que el primer archivo sea una instantánea completa de todas las cualificaciones de perfil para la audiencia seleccionada y los archivos siguientes sean cualificaciones de perfil incrementales desde la exportación anterior.
-
Utilice el selector Frequency para seleccionar la frecuencia de exportación:
- Daily: programar exportaciones de archivos incrementales una vez al día, todos los días y a la hora especificada.
- Hourly: programar exportaciones de archivos incrementales cada 3, 6, 8 o 12 horas.
-
Utilice el selector Time para elegir la hora del día, en formato UTC, en la que debe realizarse la exportación.
-
Utilice el selector Date para elegir el intervalo en el que debe realizarse la exportación. La práctica recomendada es establecer las fechas de inicio y finalización para que se alineen con la duración de las campañas en las plataformas de flujo descendente.
note important IMPORTANT El último día del intervalo no se incluye en las exportaciones. Por ejemplo, si selecciona un intervalo del 4 al 11 de enero, la última exportación de archivos se realizará el 10 de enero. -
Seleccione Create para guardar la programación.
Configuración de nombres de archivo configure-file-names
Para la mayoría de los destinos, los nombres de archivo predeterminados constan del nombre de destino, el ID de audiencia y un indicador de fecha y hora. Por ejemplo, puede editar los nombres de archivo exportados para distinguir entre diferentes campañas o para que el tiempo de exportación de datos se anexe a los archivos. Tenga en cuenta que algunos desarrolladores de destinos pueden elegir que se muestren opciones de adición de nombres de archivo predeterminadas diferentes para sus destinos.
Para abrir una ventana modal y editar los nombres de archivo, seleccione el icono de lápiz. Los nombres de archivo están limitados a 255 caracteres.
En el editor de nombres de archivo, puede seleccionar diferentes componentes para agregarlos al nombre del archivo.
El nombre de destino y el ID de audiencia no se pueden eliminar de los nombres de archivo. Además de estas opciones, puede agregar las siguientes opciones:
MMDDYYYY_HHMMSS o una marca de tiempo UNIX de 10 dígitos de la hora en que se generan los archivos. Elija una de estas opciones si desea que los archivos tengan un nombre de archivo dinámico generado con cada exportación incremental.Para editar varios nombres de archivo al mismo tiempo, seleccione las audiencias mediante las casillas de verificación de la izquierda de la pantalla y, a continuación, seleccione Edit file name. Las opciones de nombre de archivo que configure se aplicarán a todos los archivos exportados para las audiencias seleccionadas.
Seleccione Apply changes para confirmar su selección.
Una vez que haya terminado de configurar todas sus audiencias, seleccione Next para continuar.
Asignación mapping
En este paso, debe seleccionar los atributos de perfil que desea añadir a los archivos exportados al destino de destino. Para seleccionar atributos e identidades de perfil para la exportación:
-
En la página Mapping, seleccione Add new mapping.
-
Seleccione la flecha a la derecha de la entrada Source field.
-
En la página Select source field, seleccione los atributos e identidades de perfil que desee incluir en los archivos exportados al destino y, a continuación, elija Select.
note tip TIP Puede utilizar el campo de búsqueda para reducir la selección, como se muestra en la siguiente imagen. Utilice la opción Show only fields with data para mostrar solo los campos de esquema rellenados con valores. De forma predeterminada, solo se muestran los campos de esquema rellenados.
-
El campo seleccionado para la exportación ahora aparece en la vista de asignación. Si lo desea, puede editar el nombre del encabezado en el archivo exportado. Para ello, seleccione el icono en el campo de destinatario.
note note NOTE Los puntos ( .) no se admiten en los nombres de campo de los archivos exportados. Si el nombre de un campo incluye puntos (comoperson.name.firstName), cada punto se reemplazará con un guion bajo (_) en el nombre de columna exportado. Por ejemplo,person.name.firstNamepasará a serperson_name_firstNameen el archivo exportado.
-
En la página Select target field, escriba el nombre deseado del encabezado en el archivo exportado y, a continuación, elija Select.
-
El campo seleccionado para la exportación aparece ahora en la vista de asignación y muestra el encabezado editado en el archivo exportado.
-
(Opcional) El orden de los campos asignados en la interfaz de usuario se refleja en el orden de las columnas del archivo CSV exportado, de arriba a abajo, siendo la fila superior la columna situada más a la izquierda en el archivo CSV. Puede reordenar los campos asignados del modo que desee, arrastrando y soltando las filas de asignación, como se muestra a continuación.
note note NOTE Esta función está en versión beta y solo está disponible para clientes seleccionados. Para solicitar acceso a esta función, póngase en contacto con el representante del Adobe.
-
(Opcional) Puede seleccionar que su campo exportado sea una clave obligatoria o una clave de anulación de duplicación.
-
Para agregar más campos para exportar, repita los pasos anteriores.
Atributos obligatorios mandatory-attributes
Un atributo obligatorio es una casilla de verificación activada por el usuario que garantiza que todos los registros de perfil contengan el atributo seleccionado. Por ejemplo: todos los perfiles exportados contienen una dirección de correo electrónico
Puede marcar los atributos como obligatorios para asegurarse de que Experience Platform exporta únicamente los perfiles que incluyen el atributo específico. Como resultado, se puede utilizar como una forma adicional de filtrado. Marcar un atributo como obligatorio es no obligatorio.
Al no seleccionar un atributo obligatorio, se exportan todos los perfiles cualificados independientemente de sus atributos.
Se recomienda que uno de los atributos sea un identificador único de su esquema. Para obtener más información sobre los atributos obligatorios, consulte la sección de identidad en la documentación de destinos de marketing por correo electrónico.
Claves de anulación de duplicación deduplication-keys
Una clave de anulación de duplicación es una clave principal definida por el usuario que determina la identidad por la que los usuarios desean que se dedupliquen sus perfiles
Las claves de deduplicación eliminan la posibilidad de tener varios registros del mismo perfil en un archivo de exportación.
Hay tres formas de usar claves de anulación de duplicación en Experience Platform:
- Usando un área de nombres de identidad única como deduplication key
- Usando un único atributo de perfil de un perfil XDM como deduplication key
- Usando una combinación de dos atributos de perfil de un perfil XDM como clave compuesta
Ejemplo de deduplicación deduplication-example
Este ejemplo ilustra el funcionamiento de la deduplicación en función de las claves de deduplicación seleccionadas.
Consideremos los dos perfiles siguientes.
Perfil A
{
"identityMap": {
"Email": [
{
"id": "johndoe@example.com"
},
{
"id": "doejohn_1@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "realized",
"lastQualificationTime": "2021-03-10 10:03:08"
}
}
},
"person": {
"name": {
"lastName": "Doe",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
Perfil B
{
"identityMap": {
"Email": [
{
"id": "johndoe@example.com"
},
{
"id": "doejohn_2@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "realized",
"lastQualificationTime": "2021-04-10 11:33:28"
}
}
},
"person": {
"name": {
"lastName": "D",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
Caso de uso 1 de deduplicación: sin deduplicación deduplication-use-case-1
Sin anulación de duplicación, el archivo de exportación contendría las siguientes entradas.
Caso de uso de deduplicación 2: deduplicación basada en el área de nombres de identidad deduplication-use-case-2
Suponiendo la anulación de duplicación por el espacio de nombres Email, el archivo de exportación contendría las siguientes entradas. El perfil B es el más reciente que se clasifica para la audiencia, por lo que es el único que se exporta.
Caso de uso de deduplicación 3: deduplicación basada en un único atributo de perfil deduplication-use-case-3
Suponiendo la anulación de duplicación por el atributo personal Email, el archivo de exportación contendría la siguiente entrada. El perfil B es el más reciente que se clasifica para la audiencia, por lo que es el único que se exporta.
Caso de uso 4 de deduplicación: deduplicación basada en dos atributos de perfil deduplication-use-case-4
Suponiendo la anulación de duplicación por la clave compuesta personalEmail + lastName, el archivo de exportación contendría las siguientes entradas.
Adobe recomienda seleccionar un área de nombres de identidad como CRM ID o una dirección de correo electrónico como clave de anulación de duplicación para garantizar que todos los registros de perfil se identifiquen de forma exclusiva.
Comportamiento de deduplicación para perfiles con la misma marca de tiempo deduplication-same-timestamp
Al exportar perfiles a destinos basados en archivos, la deduplicación garantiza que solo se exporte un perfil cuando varios perfiles comparten la misma clave de deduplicación y la misma marca de tiempo de referencia. Esta marca de tiempo representa el momento en el que se actualizó por última vez el gráfico de identidad o la pertenencia a audiencias de un perfil. Para obtener más información sobre cómo se actualizan y exportan los perfiles, consulte el documento comportamiento de exportación de perfiles.
Consideraciones clave
-
Selección determinística: cuando varios perfiles tienen claves de anulación de duplicación idénticas y la misma marca de tiempo de referencia, la lógica de anulación de duplicación determina qué perfil se va a exportar ordenando los valores de otras columnas seleccionadas (excluyendo tipos complejos como matrices, mapas u objetos). Los valores ordenados se evalúan en orden lexicográfico y se selecciona el primer perfil.
-
Ejemplo de escenario
Considere los siguientes datos, donde la clave de anulación de duplicación es la columna Email:
test1@test.comtest1@test.comtest2@test.comDespués de la deduplicación, el archivo de exportación contiene:
test1@test.comtest2@test.comExplicación: Para test1@test.com, ambos perfiles comparten la misma clave de anulación de duplicación y la misma marca de tiempo. El algoritmo ordena lexicográficamente los valores de las columnas first_name y last_name. Dado que los nombres son idénticos, la hora se resuelve usando la columna last_name, donde "Doe" va antes que "Morris".
Confiabilidad mejorada: Este proceso de deduplicación actualizado garantiza que las ejecuciones sucesivas con las mismas coordenadas siempre produzcan los mismos resultados, lo que mejora la coherencia.
Realizar transformaciones de datos mediante campos calculados calculated-fields
Puede usar el control Campos calculados para realizar varias transformaciones de datos en los datos exportados a destinos basados en archivos.
Limitaciones conocidas known-limitations
La nueva página Mapping tiene las siguientes limitaciones conocidas:
El atributo de pertenencia a audiencia no se puede seleccionar mediante el flujo de trabajo de asignación
Debido a una limitación conocida, actualmente no puede usar la ventana Select field para agregar segmentMembership.seg_namespace.seg_id.status a sus exportaciones de archivos. En su lugar, debe pegar manualmente el valor xdm: segmentMembership.seg_namespace.seg_id.status en el campo de esquema, como se muestra a continuación.
segmentMembership.seg_namespace.seg_id.statussegmentMembership.seg_namespace.seg_id.lastQualificationTime
Las exportaciones de archivos variarán de las siguientes maneras, dependiendo de si segmentMembership.seg_namespace.seg_id.status está seleccionado o no:
- Si se selecciona el campo
segmentMembership.seg_namespace.seg_id.status, los archivos exportados incluyen Active miembros en la instantánea completa inicial y Active y Expired miembros nuevos en las exportaciones incrementales posteriores. - Si no se selecciona el campo
segmentMembership.seg_namespace.seg_id.status, los archivos exportados incluyen solo Active miembros en la instantánea completa inicial y en las exportaciones incrementales posteriores.
Obtenga más información sobre comportamiento de exportación de perfiles para destinos basados en archivos.
Actualmente no se pueden seleccionar áreas de nombres de identidad para las exportaciones
Actualmente no se admite la selección de áreas de nombres de identidad para exportar, como se muestra en la imagen siguiente. Si se seleccionan áreas de nombres de identidad para la exportación, se producirá un error en el paso Review.
Como solución temporal si necesita agregar áreas de nombres de identidad a los archivos exportados durante la versión beta, puede:
- Utilice los destinos de almacenamiento en la nube heredados para los flujos de datos donde desee incluir áreas de nombres de identidad en las exportaciones
- Cargue identidades como atributos en Experience Platform para luego exportarlas a sus destinos de almacenamiento en la nube.
Seleccionar atributos de perfil select-attributes
Para los destinos basados en perfiles, debe seleccionar los atributos de perfil que desea enviar al destino de destino.
-
En la página Select attributes, seleccione Add new field.
-
Seleccione la flecha a la derecha de la entrada Schema field.
-
En la página Select field, seleccione los atributos XDM o las áreas de nombres de identidad que desee enviar al destino y, a continuación, elija Select.
-
Para agregar más asignaciones, repita los pasos del uno al tres.
person.name.firstName, person.name.lastName, personalEmail.address, segmentMembership.seg_namespace.seg_id.status.
segmentMembership.seg_namespace.seg_id.status a sus exportaciones de archivos. En su lugar, debe pegar manualmente el valor xdm: segmentMembership.seg_namespace.seg_id.status en el campo de esquema, como se muestra a continuación.
Las exportaciones de archivos varían de las siguientes maneras, dependiendo de si segmentMembership.seg_namespace.seg_id.status está seleccionado o no:
- Si se selecciona el campo
segmentMembership.seg_namespace.seg_id.status, los archivos exportados incluyen Active miembros en la instantánea completa inicial y Active y Expired miembros en las exportaciones incrementales posteriores. - Si no se selecciona el campo
segmentMembership.seg_namespace.seg_id.status, los archivos exportados incluyen solo Active miembros en la instantánea completa inicial y en las exportaciones incrementales posteriores.
Seleccionar atributos de enriquecimiento select-enrichment-attributes
Los atributos de enriquecimiento corresponden a audiencias cargadas personalizadas introducidas en Experience Platform como Custom uploads. En este paso, puede seleccionar qué atributos desea exportar a su destino para cada audiencia externa seleccionada.
Siga los pasos a continuación para seleccionar atributos de enriquecimiento para cada audiencia externa:
- En la columna Enrichment attributes, seleccione el botón
(Editar).
- Seleccione Add enrichment attribute. Se muestra un nuevo campo de esquema vacío.
- Seleccione el botón a la derecha del campo vacío para abrir la pantalla de selección de campos.
- Seleccione los atributos que desee exportar para la audiencia.
- Después de agregar todos los atributos que desea exportar, seleccione Save and close.
- Repita estos pasos para cada audiencia externa.
Si desea activar audiencias externas en sus destinos sin exportar ningún atributo, habilite la opción Exclude enrichment attributes. Esta opción exporta los perfiles de las audiencias externas, pero ninguno de sus atributos correspondientes se envía al destino.
Seleccione Next para pasar al paso Revisar.
Revisar review
- Los campos se utilizan en la definición de audiencia.
- Los campos se configuran como atributos proyectados para el destino final.
person.name.firstName tiene ciertas etiquetas de uso de datos que entran en conflicto con la acción de marketing del destino, se le mostrará una infracción de directiva de uso de datos en el paso de revisión. Para obtener más información, consulte Administración de datos en Adobe Experience Platform.En la página Review, puede ver un resumen de su selección. Seleccione Cancel para dividir el flujo, Back para modificar la configuración o Finish para confirmar la selección y comenzar a enviar datos al destino.
Evaluación de directiva de consentimiento consent-policy-evaluation
Si su organización compró Adobe Healthcare Shield o Adobe Privacy & Security Shield, seleccione View applicable consent policies para ver qué políticas de consentimiento se aplican y cuántos perfiles se incluyen en la activación como resultado de ellas. Lea acerca de evaluación de directivas de consentimiento para obtener más información.
Comprobaciones de políticas de uso de datos data-usage-policy-checks
En el paso Review, Experience Platform también comprueba si hay alguna infracción de la directiva de uso de datos. A continuación se muestra un ejemplo de infracción de una directiva. No puede completar el flujo de trabajo de activación de audiencia hasta que haya resuelto la infracción. Para obtener información sobre cómo resolver infracciones de directivas, lea acerca de infracciones de directivas de uso de datos en la sección de documentación de control de datos.
Filtrado de audiencias filter-audiences
Además, en este paso puede utilizar los filtros disponibles en la página para mostrar solo las audiencias cuya programación o asignación se haya actualizado como parte de este flujo de trabajo. También puede alternar qué columnas de tabla desea ver.
Si está satisfecho con su selección y no se han detectado infracciones de directivas, seleccione Finish para confirmar su selección y comenzar a enviar datos al destino.
Verificar activación de audiencia verify
Al exportar audiencias a destinos de almacenamiento en la nube, Adobe Experience Platform crea un archivo de .csv, .json o .parquet en la ubicación de almacenamiento proporcionada. Es de esperar que se cree un nuevo archivo en su ubicación de almacenamiento según la programación establecida en el flujo de trabajo. El formato de archivo predeterminado se muestra a continuación, pero puede editar los componentes del nombre de archivo:<destinationName>_segment<segmentID>_<timestamp-yyyymmddhhmmss>.csv
Por ejemplo, si seleccionara una frecuencia de exportación diaria, los archivos que recibiría en tres días consecutivos podrían tener este aspecto:
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200408061804.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200409052200.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200410061130.csv
La presencia de estos archivos en su ubicación de almacenamiento es la confirmación de la activación correcta. Para comprender cómo están estructurados los archivos exportados, puede descargar un archivo .csv de ejemplo. Este archivo de muestra incluye los atributos de perfil person.firstname, person.lastname, person.gender, person.birthyear y personalEmail.address.