Activar audiencias en destinos basados en archivos mediante la API de Flow Service
Utilice las funciones mejoradas de exportación de archivos para acceder a la funcionalidad de personalización mejorada al exportar archivos fuera del Experience Platform:
- Opciones de nomenclatura de archivos adicionales.
- Posibilidad de establecer encabezados de archivo personalizados en los archivos exportados a través del paso de asignación mejorado.
- Capacidad para seleccionar tipo de archivo del archivo exportado.
- Capacidad para personalizar el formato de los archivos de datos CSV exportados.
Esta funcionalidad es compatible con las seis tarjetas de almacenamiento en la nube que se enumeran a continuación:
En este artículo se explica el flujo de trabajo necesario para usar la API de Flow Service para exportar perfiles calificados de Adobe Experience Platform a una de las ubicaciones de almacenamiento en la nube vinculadas anteriormente.
Introducción get-started
Esta guía requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:
- Experience Data Model (XDM) System: El marco estandarizado mediante el cual Experience Platform organiza los datos de experiencia del cliente.
- Segmentation Service: Adobe Experience Platform Segmentation Service le permite generar audiencias en Adobe Experience Platform a partir de sus datos de Real-Time Customer Profile.
- Sandboxes: Experience Platform proporciona zonas protegidas virtuales que dividen una sola instancia de Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.
Las secciones siguientes proporcionan información adicional que necesita conocer para activar datos en destinos basados en archivos en Platform.
Permisos necesarios permissions
Para exportar perfiles, necesita los permisos de control de acceso, Activar destinos, Ver perfiles y Ver segmentos para. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.
Para exportar identidades, necesita el permiso de control de acceso de] Ver gráfico de identidad[.
{width="100" modal="regular"}
Lectura de llamadas de API de muestra reading-sample-api-calls
Este tutorial proporciona llamadas de API de ejemplo para demostrar cómo dar formato a las solicitudes. Estas incluyen rutas, encabezados obligatorios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de la API. Para obtener información sobre las convenciones utilizadas en la documentación de las llamadas de API de ejemplo, consulte la sección sobre cómo leer las llamadas de API de ejemplo en la guía de solución de problemas de Experience Platform.
Recopilar valores para encabezados obligatorios y opcionales gather-values-headers
Para realizar llamadas a las API de Platform, primero debe completar el tutorial de autenticación de Experience Platform 2}.Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados obligatorios en todas las llamadas de API de Experience Platform, como se muestra a continuación:
- Autorización: Portador
{ACCESS_TOKEN}
- x-api-key:
{API_KEY}
- x-gw-ims-org-id:
{ORG_ID}
Los recursos de Experience Platform se pueden aislar en zonas protegidas virtuales específicas. En las solicitudes a las API de Platform, puede especificar el nombre y el ID de la zona protegida en la que se realizará la operación. Son parámetros opcionales.
- x-sandbox-name:
{SANDBOX_NAME}
Todas las solicitudes que contienen una carga útil (POST
, PUT
, PATCH
) requieren un encabezado de tipo multimedia adicional:
- Tipo de contenido:
application/json
Documentación de referencia del API api-reference-documentation
Puede encontrar la documentación de referencia adjunta para todas las operaciones de API en este tutorial. Consulte Servicio de flujo: documentación de la API de destinos en el sitio web de Adobe Developer. Le recomendamos que utilice este tutorial y la documentación de referencia de la API en paralelo.
Glosario glossary
Para obtener descripciones de los términos que encontrará en este tutorial de API, lea la sección del glosario de la documentación de referencia de la API.
Seleccione el destino donde desea exportar las audiencias select-destination
Antes de iniciar el flujo de trabajo para exportar perfiles, identifique la especificación de conexión y los ID de especificación de flujo del destino al que desea exportar las audiencias. Utilice la tabla siguiente como referencia.
4fce964d-3f37-408f-9778-e597338a21ee
1a0514a6-33d4-4c7f-aff8-594799c47549
6d6b59bf-fb58-4107-9064-4d246c0e5bb2
752d422f-b16f-4f0d-b1c6-26e448e3b388
be2c3209-53bc-47e7-ab25-145db8b873e1
17be2013-2549-41ce-96e7-a70363bec293
10440537-2a7b-4583-ac39-ed38d4b848e8
cd2fc47e-e838-4f38-a581-8fff2f99b63a
c5d93acb-ea8b-4b14-8f53-02138444ae99
585c15c4-6cbf-4126-8f87-e26bff78b657
36965a81-b1c6-401b-99f8-22508f1e6a26
fd36aaa4-bf2b-43fb-9387-43785eeeb799
Estos ID son necesarios para construir varias entidades del servicio de flujo en los siguientes pasos de este tutorial. También debe hacer referencia a partes de la propia especificación de conexión para configurar determinadas entidades y poder recuperar las especificaciones de conexión desde las API de Flow Service. Consulte los ejemplos siguientes de recuperación de especificaciones de conexión para todos los destinos de la tabla:
Solicitud
accordion | ||
---|---|---|
Recuperar connection spec para Amazon S3 | ||
|
Respuesta
accordion | ||
---|---|---|
Amazon S3 - Especificación de conexión | ||
|
Solicitud
accordion | ||
---|---|---|
Recuperar connection spec para Azure Blob Storage | ||
|
Respuesta
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec | ||
|
Solicitud
accordion | ||
---|---|---|
Recuperar connection spec para Azure Data Lake Gen 2(ADLS Gen2) | ||
|
Respuesta
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec | ||
|
Solicitud
accordion | ||
---|---|---|
Recuperar connection spec para Data Landing Zone(DLZ) | ||
|
Respuesta
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec | ||
|
Solicitud
accordion | ||
---|---|---|
Recuperar connection spec para Google Cloud Storage | ||
|
Respuesta
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec | ||
|
Solicitud
accordion | ||
---|---|---|
Recuperar connection spec para SFTP | ||
|
Respuesta
accordion | ||
---|---|---|
SFTP: Connection spec | ||
|
Siga los pasos a continuación para configurar un flujo de datos de exportación de audiencia a un destino de almacenamiento en la nube. En algunos pasos, las solicitudes y respuestas difieren entre los distintos destinos de almacenamiento en la nube. En estos casos, utilice las pestañas de la página para recuperar las solicitudes y respuestas específicas del destino al que desea conectar y exportar audiencias. Asegúrese de usar los connection spec
y flow spec
correctos para el destino que está configurando.
Crear una conexión de Source create-source-connection
Después de decidir a qué destino están exportando las audiencias, debe crear una conexión de origen. La conexión de origen representa la conexión con el almacén interno de perfiles de Experience Platform.
Solicitud
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea al copiar y pegar la solicitud en el terminal que desee.
code language-shell |
---|
|
Respuesta
code language-json |
---|
|
Una respuesta correcta devuelve el identificador (id
) de la conexión de origen recién creada y un etag
. Tenga en cuenta el ID de conexión de origen, ya que lo necesitará más adelante al crear el flujo de datos.
Crear una conexión base create-base-connection
Una conexión base almacena de forma segura las credenciales en su destino. Según el tipo de destino, las credenciales necesarias para autenticarse en ese destino pueden variar. Para encontrar estos parámetros de autenticación, primero recupere connection spec
para el destino deseado tal como se describe en la sección Seleccione el destino donde exportar las audiencias y luego observe el authSpec
de la respuesta. Haga referencia a las fichas siguientes para las propiedades de authSpec
de todos los destinos admitidos.
accordion | ||
---|---|---|
Amazon S3 - Connection spec mostrando auth spec | ||
Observe la línea resaltada con comentarios en línea en el ejemplo connection spec siguiente, que proporciona información adicional sobre dónde encontrar los parámetros de autenticación en connection spec.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec mostrando auth spec | ||
Observe la línea resaltada con comentarios en línea en el ejemplo connection spec siguiente, que proporciona información adicional sobre dónde encontrar los parámetros de autenticación en connection spec.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec mostrando auth spec | ||
Observe la línea resaltada con comentarios en línea en el ejemplo connection spec siguiente, que proporciona información adicional sobre dónde encontrar los parámetros de autenticación en connection spec.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Connection spec mostrando auth spec | |||||
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec mostrando auth spec | ||
Observe la línea resaltada con comentarios en línea en el ejemplo connection spec siguiente, que proporciona información adicional sobre dónde encontrar los parámetros de autenticación en connection spec.
|
accordion | |||||
---|---|---|---|---|---|
SFTP: Connection spec muestra auth spec | |||||
Observe la línea resaltada con comentarios en línea en el ejemplo connection spec siguiente, que proporciona información adicional sobre dónde encontrar los parámetros de autenticación en connection spec.
|
Con las propiedades especificadas en la especificación de autenticación (es decir, authSpec
de la respuesta) puede crear una conexión base con las credenciales necesarias, específicas para cada tipo de destino, como se muestra en los ejemplos siguientes:
Solicitud
accordion | |||||
---|---|---|---|---|---|
Amazon S3: solicitud de conexión base con autenticación de clave de acceso y clave secreta | |||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Solicitud de conexión base con autenticación de rol asumida | |||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
Respuesta
accordion | ||
---|---|---|
Amazon S3 respuesta de conexión base | ||
|
Solicitud
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Solicitud de conexión base | |||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
Respuesta
accordion | ||
---|---|---|
Azure Blob Storage - Respuesta de conexión base | ||
|
Solicitud
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Solicitud de conexión base | |||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
Respuesta
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Respuesta de conexión base | ||
|
Solicitud
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Solicitud de conexión base | |||||
|
Respuesta
accordion | ||
---|---|---|
Data Landing Zone - Respuesta de conexión base | ||
|
Solicitud
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Solicitud de conexión base | |||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
Respuesta
accordion | ||
---|---|---|
Google Cloud Storage - Respuesta de conexión base | ||
|
Solicitud
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP con contraseña: solicitud de conexión base | |||||||||||||||||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP con clave SSH: solicitud de conexión base | |||||||||||||||||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
Respuesta
accordion | ||
---|---|---|
SFTP: respuesta de conexión base | ||
|
Añadir cifrado a los archivos exportados
Opcionalmente, puede agregar cifrado a los archivos exportados. Para ello, debe agregar elementos de encryptionSpecs
. Consulte el ejemplo de solicitud que aparece a continuación con los parámetros obligatorios resaltados:
code language-json line-numbers data-start-1 data-line-offset-4 h-26-27 |
---|
|
Solicitud
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea al copiar y pegar la solicitud en el terminal que desee.
code language-shell line-numbers data-start-1 data-line-offset-4 h-19 |
---|
|
Respuesta
code language-json |
---|
|
Observe el ID de conexión de la respuesta. Este ID será necesario en el siguiente paso al crear la conexión de destino.
Creación de una conexión de destino create-target-connection
A continuación, debe crear una conexión de destino. Las conexiones de destino almacenan los parámetros de exportación de las audiencias exportadas. Los parámetros de exportación incluyen la ubicación de exportación, el formato de archivo, la compresión y otros detalles. Por ejemplo, para los archivos CSV, puede seleccionar varias opciones de exportación. Obtenga información detallada sobre todas las opciones de exportación de CSV admitidas en la página configuraciones de formato de archivo.
Consulte las propiedades de targetSpec
proporcionadas en connection spec
del destino para conocer las propiedades admitidas para cada tipo de destino. Haga referencia a las fichas siguientes para las propiedades de targetSpec
de todos los destinos admitidos.
accordion | ||
---|---|---|
Amazon S3 - Connection spec mostrando parámetros de conexión de destino | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo connection spec siguiente, que proporciona información adicional sobre dónde encontrar los parámetros target spec en la especificación de conexión. También puede ver en el ejemplo a continuación cuáles son los parámetros de destino no aplicables a los destinos de exportación de audiencia.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec mostrando parámetros de conexión de destino | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo connection spec siguiente, que proporciona información adicional sobre dónde encontrar los parámetros target spec en la especificación de conexión. También puede ver en el ejemplo a continuación cuáles son los parámetros de destino no aplicables a los destinos de exportación de audiencia.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec mostrando parámetros de conexión de destino | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo connection spec siguiente, que proporciona información adicional sobre dónde encontrar los parámetros target spec en la especificación de conexión. También puede ver en el ejemplo a continuación cuáles son los parámetros de destino no aplicables a los destinos de exportación de audiencia.
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec mostrando parámetros de conexión de destino | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo connection spec siguiente, que proporciona información adicional sobre dónde encontrar los parámetros target spec en la especificación de conexión. También puede ver en el ejemplo a continuación cuáles son los parámetros de destino no aplicables a los destinos de exportación de audiencia.
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec mostrando parámetros de conexión de destino | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo connection spec siguiente, que proporciona información adicional sobre dónde encontrar los parámetros target spec en la especificación de conexión. También puede ver en el ejemplo a continuación cuáles son los parámetros de destino no aplicables a los destinos de exportación de audiencia.
|
accordion | ||
---|---|---|
SFTP: Connection spec muestra los parámetros de conexión de destino | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo connection spec siguiente, que proporciona información adicional sobre dónde encontrar los parámetros target spec en la especificación de conexión. También puede ver en el ejemplo a continuación cuáles son los parámetros de destino no aplicables a los destinos de exportación de audiencia.
|
Con la especificación anterior, puede construir una solicitud de conexión de destino específica para el destino de almacenamiento en la nube deseado, como se muestra en las pestañas a continuación.
Solicitud
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Solicitud de conexión de destino | |||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Solicitud de conexión de destino con opciones de CSV | |||||
|
Respuesta
accordion | ||
---|---|---|
Conexión de destino: respuesta | ||
|
Solicitud
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Solicitud de conexión de destino | |||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Solicitud de conexión de destino con opciones de CSV | |||||
|
Respuesta
accordion | ||
---|---|---|
Conexión de destino: respuesta | ||
|
Solicitud
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Solicitud de conexión de destino | |||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Solicitud de conexión de destino con opciones de CSV | |||||
|
Respuesta
accordion | ||
---|---|---|
Conexión de destino: respuesta | ||
|
Solicitud
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Solicitud de conexión de destino | |||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Solicitud de conexión de destino con opciones de CSV | |||||
|
Respuesta
accordion | ||
---|---|---|
Conexión de destino: respuesta | ||
|
Solicitud
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Solicitud de conexión de destino | |||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Solicitud de conexión de destino con opciones de CSV | |||||
|
Respuesta
accordion | ||
---|---|---|
Conexión de destino: respuesta | ||
|
Solicitud
accordion | |||||
---|---|---|---|---|---|
SFTP: solicitud de conexión de destino | |||||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
accordion | |||||
---|---|---|---|---|---|
SFTP: solicitud de conexión de destino con opciones de CSV | |||||
|
Respuesta
accordion | ||
---|---|---|
Conexión de destino: respuesta | ||
|
Observe target connection ID
de la respuesta. Este ID será necesario en el siguiente paso al crear el flujo de datos para exportar audiencias.
Una respuesta correcta devuelve el identificador (id
) de la conexión de origen de destino reciente y un etag
. Tenga en cuenta el ID de conexión de destino, ya que lo necesitará más adelante al crear el flujo de datos.
Creación de un flujo de datos create-dataflow
El siguiente paso en la configuración de destino es crear un flujo de datos. Un flujo de datos vincula las entidades creadas anteriormente y también proporciona opciones para configurar la programación de exportación de audiencias. Para crear el flujo de datos, utilice las cargas útiles que se indican a continuación, según el destino de almacenamiento en la nube deseado, y reemplace los ID de entidad de flujo de los pasos anteriores. Tenga en cuenta que en este paso no se agrega ninguna información relacionada con la asignación de atributos o identidades al flujo de datos. Esto seguirá en el siguiente paso.
Solicitud
accordion | ||
---|---|---|
Crear flujo de datos de exportación de audiencia a Amazon S3 destino - Solicitud | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
Respuesta
accordion | ||
---|---|---|
Crear flujo de datos: respuesta | ||
|
Solicitud
accordion | ||
---|---|---|
Crear flujo de datos de exportación de audiencia a Azure Blob Storage destino - Solicitud | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
Respuesta
accordion | ||
---|---|---|
Crear flujo de datos: respuesta | ||
|
Solicitud
accordion | ||
---|---|---|
Crear flujo de datos de exportación de audiencia a Azure Data Lake Gen 2(ADLS Gen2) destino - Solicitud | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
Respuesta
accordion | ||
---|---|---|
Crear flujo de datos: respuesta | ||
|
Solicitud
accordion | ||
---|---|---|
Crear flujo de datos de exportación de audiencia a Data Landing Zone destino - Solicitud | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
Respuesta
accordion | ||
---|---|---|
Crear flujo de datos: respuesta | ||
|
Solicitud
accordion | ||
---|---|---|
Crear flujo de datos de exportación de audiencia a Google Cloud Storage destino - Solicitud | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
Respuesta
accordion | ||
---|---|---|
Crear flujo de datos: respuesta | ||
|
Solicitud
accordion | ||
---|---|---|
Crear flujo de datos de exportación de audiencia a destino SFTP: solicitud | ||
Observe las líneas resaltadas con comentarios en línea en el ejemplo de la solicitud, que proporcionan información adicional. Elimine los comentarios en línea de la solicitud al copiar y pegar la solicitud en el terminal que desee.
|
Respuesta
accordion | ||
---|---|---|
Crear flujo de datos: respuesta | ||
|
Tenga en cuenta el ID de flujo de datos de la respuesta. Este ID será necesario en pasos posteriores.
Añadir audiencias a la exportación
En este paso, también puede seleccionar qué audiencias desea exportar al destino. Para obtener información detallada sobre este paso y el formato de solicitud para agregar una audiencia al flujo de datos, vea los ejemplos en la sección Actualizar un flujo de datos de destino de la documentación de referencia de la API.
Configurar asignación de atributos e identidades attribute-and-identity-mapping
Después de crear el flujo de datos, debe configurar la asignación para los atributos e identidades que desea exportar. Consta de tres pasos, que se enumeran a continuación:
- Creación de un esquema de entrada
- Creación de un esquema de salida
- Configuración de un conjunto de asignaciones para conectar los esquemas creados
Por ejemplo, para obtener la siguiente asignación que se muestra en la interfaz de usuario, debe seguir los tres pasos enumerados arriba y detallados en los siguientes encabezados.
Creación de un esquema de entrada
Para crear un esquema de entrada, primero debe recuperar su esquema de unión y las identidades que se pueden exportar al destino. Este es el esquema de atributos e identidades que puede seleccionar como asignación de origen.
Vea a continuación ejemplos de solicitudes y respuestas para recuperar atributos e identidades.
Solicitud para obtener atributos
code language-shell |
---|
|
Respuesta
La respuesta que aparece a continuación se ha abreviado para que sea más breve.
code language-json |
---|
|
Solicitud para obtener identidades
code language-shell |
---|
|
Respuesta
La respuesta devuelve las identidades que puede utilizar al crear el esquema de entrada. Tenga en cuenta que esta respuesta devuelve las áreas de nombres de identidad standard y custom que configuró en el Experience Platform.
code language-json |
---|
|
A continuación, debe copiar la respuesta de arriba y utilizarla para crear el esquema de entrada. Puede copiar la respuesta JSON completa de la respuesta anterior y colocarla en el objeto jsonSchema
indicado a continuación.
Solicitud para crear esquema de entrada
code language-shell |
---|
|
Respuesta
code language-json |
---|
|
El ID de la respuesta representa el identificador único del esquema de entrada que ha creado. Copie el ID de la respuesta, ya que lo reutilizará en un paso posterior.
Creación de un esquema de salida
A continuación, debe configurar el esquema de salida para la exportación. En primer lugar, debe buscar e inspeccionar el esquema de socio existente.
Solicitud
Tenga en cuenta que el ejemplo siguiente utiliza connection spec ID
para Amazon S3. Sustituya este valor por el ID de especificación de conexión específico de su destino.
code language-shell |
---|
|
Respuesta con un esquema de ejemplo
Inspect devuelve la respuesta que obtiene al realizar la llamada anterior. Debe explorar en profundidad la respuesta para encontrar el objeto targetSpec.attributes.partnerSchema.jsonSchema
code language-json |
---|
|
A continuación, debe crear un esquema de salida. Copie la respuesta JSON que obtuvo arriba y péguela en el objeto jsonSchema
abajo.
Solicitud
code language-shell |
---|
|
Respuesta
code language-json |
---|
|
El ID de la respuesta representa el identificador único del esquema de entrada que ha creado. Copie el ID de la respuesta, ya que lo reutilizará en un paso posterior.
Crear conjunto de asignaciones create-mapping-set
A continuación, utilice la API de preparación de datos para crear el conjunto de asignaciones mediante el ID de esquema de entrada, el ID de esquema de salida y las asignaciones de campo deseadas.
Solicitud
note important |
---|
IMPORTANT |
|
code language-shell line-numbers data-start-1 data-line-offset-4 h-16-38 |
---|
|
Respuesta
code language-json |
---|
|
Tenga en cuenta el ID del conjunto de asignaciones, ya que lo necesitará en el siguiente paso para actualizar el flujo de datos existente con el ID del conjunto de asignaciones.
A continuación, obtenga el ID del flujo de datos que desea actualizar.
Consulte recuperar los detalles de un flujo de datos de destino para obtener información sobre cómo recuperar el ID de un flujo de datos.
Finalmente, debe PATCH
el flujo de datos con la información del conjunto de asignaciones que acaba de crear.
Solicitud
code language-shell |
---|
|
Respuesta
La respuesta de la API de Flow Service devuelve el ID del flujo de datos actualizado.
code language-json |
---|
|
Realización de otras actualizaciones del flujo de datos other-dataflow-updates
Para realizar actualizaciones en el flujo de datos, utilice la operación PATCH
. Por ejemplo, puede agregar una acción de marketing a los flujos de datos. O bien, puede actualizar los flujos de datos para seleccionar campos como claves obligatorias o claves de anulación de duplicación.
Añadir una acción de marketing add-marketing-action
Para agregar una acción de marketing, vea los ejemplos de solicitud y respuesta que aparecen a continuación.
If-Match
al realizar una solicitud PATCH
. El valor de este encabezado es la versión única del flujo de datos que desea actualizar. El valor de la etiqueta se actualiza con cada actualización correcta de una entidad de flujo, como flujo de datos, conexión de destino y otras.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
, donde {ID}
es el identificador de flujo de datos que desea actualizar.If-Match
entre comillas dobles, como en los ejemplos siguientes, al realizar PATCH
solicitudes.Solicitud
code language-shell |
---|
|
Respuesta
Una respuesta correcta devuelve el código de respuesta 200
junto con el ID del flujo de datos actualizado y la etiqueta electrónica actualizada.
code language-json |
---|
|
Añadir una clave obligatoria add-mandatory-key
Para agregar una clave obligatoria, vea los ejemplos de solicitud y respuesta que aparecen a continuación.
If-Match
al realizar una solicitud PATCH
. El valor de este encabezado es la versión única del flujo de datos que desea actualizar. El valor de la etiqueta se actualiza con cada actualización correcta de una entidad de flujo, como flujo de datos, conexión de destino y otras.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
, donde {ID}
es el identificador de flujo de datos que desea actualizar.If-Match
entre comillas dobles, como en los ejemplos siguientes, al realizar PATCH
solicitudes.Solicitud
code language-shell |
---|
|
code language-shell |
---|
|
Respuesta
code language-json |
---|
|
Añadir una clave de anulación de duplicación add-deduplication-key
Para agregar una clave de anulación de duplicación, consulte los ejemplos de solicitud y respuesta que aparecen a continuación
If-Match
al realizar una solicitud PATCH
. El valor de este encabezado es la versión única del flujo de datos que desea actualizar. El valor de la etiqueta se actualiza con cada actualización correcta de una entidad de flujo, como flujo de datos, conexión de destino y otras.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
, donde {ID}
es el identificador de flujo de datos que desea actualizar.If-Match
entre comillas dobles, como en los ejemplos siguientes, al realizar PATCH
solicitudes.Solicitud
code language-shell |
---|
|
code language-shell |
---|
|
Respuesta
code language-json |
---|
|
Validar flujo de datos (obtener las ejecuciones del flujo de datos) get-dataflow-runs
Para comprobar las ejecuciones de un flujo de datos, utilice la API de ejecución de flujo de datos:
Solicitud
code language-shell |
---|
|
Respuesta
code language-json |
---|
|
Puede encontrar información sobre los diversos parámetros devueltos por el flujo de datos ejecuta la API en la documentación de referencia de la API.
Administración de errores de API api-error-handling
Los extremos de la API en este tutorial siguen los principios generales del mensaje de error de la API del Experience Platform. Consulte Códigos de estado de API y errores de encabezado de solicitud en la guía de solución de problemas de Platform para obtener más información sobre la interpretación de respuestas de error.
Pasos siguientes next-steps
Al seguir este tutorial, ha conectado correctamente Platform a uno de los destinos de almacenamiento en la nube preferidos y ha configurado un flujo de datos en el destino correspondiente para exportar audiencias. Consulte las siguientes páginas para obtener más información, como cómo editar flujos de datos existentes mediante la API de Flow Service: