Google Cloud Storage conexión

Información general overview

Cree una conexión saliente activa con Google Cloud Storage para exportar periódicamente archivos de datos de Adobe Experience Platform a sus propios contenedores.

Conectar con su almacenamiento de Google Cloud Storage mediante API o IU connect-api-or-ui

Audiencias compatibles supported-audiences

Esta sección describe qué tipos de audiencias puede exportar a este destino.

Origen de audiencia
Admitido
Descripción
Segmentation Service
Audiencias generadas a través del servicio de segmentación de Experience Platform.
Cargas personalizadas
Las audiencias importadas en Experience Platform desde archivos CSV.

Tipo y frecuencia de exportación export-type-frequency

Consulte la tabla siguiente para obtener información sobre el tipo y la frecuencia de exportación de destino.

Elemento
Tipo
Notas
Tipo de exportación
Profile-based
Está exportando todos los miembros de un segmento, junto con los campos de esquema aplicables, tal como se eligió en la pantalla Seleccionar atributos de perfil del flujo de trabajo de activación de destino.
Frecuencia de exportación
Batch
Los destinos por lotes exportan archivos a plataformas descendentes en incrementos de tres, seis, ocho, doce o veinticuatro horas. Obtenga más información sobre destinos basados en archivos por lotes.

Exportar conjuntos de datos export-datasets

Este destino admite exportaciones de conjuntos de datos. Para obtener información completa sobre cómo configurar exportaciones de conjuntos de datos, lea los tutoriales:

Formato de archivo de los datos exportados file-format

Al exportar datos de audiencia, Experience Platform crea un archivo de .csv, parquet o .json en la ubicación de almacenamiento proporcionada. Para obtener más información sobre los archivos, consulte la sección formatos de archivo compatibles con la exportación en el tutorial de activación de audiencia.

Al exportar conjuntos de datos, Experience Platform crea un archivo de .parquet o .json en la ubicación de almacenamiento proporcionada. Para obtener más información sobre los archivos, consulte la sección verificar la exportación correcta del conjunto de datos en el tutorial exportar conjuntos de datos.

Configuración de requisitos previos para conectar su cuenta de Google Cloud Storage prerequisites

Para conectar Experience Platform a Google Cloud Storage, primero debe habilitar la interoperabilidad para su cuenta de Google Cloud Storage. Para acceder a la configuración de interoperabilidad, abra Google Cloud Platform y seleccione Settings en la opción Cloud Storage del panel de navegación.

Panel de Google Cloud Platform con Almacenamiento en la nube y Configuración resaltados.

Aparecerá la página Settings. Desde aquí puede ver información sobre el identificador de proyecto Google y detalles sobre la cuenta Google Cloud Storage. Para acceder a la configuración de interoperabilidad, seleccione Interoperability en el encabezado superior.

La ficha Interoperabilidad resaltada en el panel de Google Cloud Platform.

La página Interoperability contiene información sobre la autenticación, las claves de acceso y el proyecto predeterminado asociado a su cuenta de servicio. Para generar un nuevo identificador de clave de acceso y una clave de acceso secreta para su cuenta de servicio, seleccione Create a Key for a Service Account.

Cree una clave para un control de cuenta de servicio resaltado en el panel de Google Cloud Platform.

Puede usar el identificador de clave de acceso y la clave de acceso secreta generados recientemente para conectar su cuenta de Google Cloud Storage a Experience Platform.

Conectar con el destino connect

IMPORTANT
Para conectarse al destino, necesita los View Destinations y Manage Destinations permisos de control de acceso. 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 conectarse a este destino, siga los pasos descritos en el tutorial de configuración de destino. En el flujo de trabajo de configuración de destino, rellene los campos enumerados en las dos secciones siguientes.

Autenticarse en el destino authenticate

Para autenticarse en el destino, rellene los campos obligatorios y seleccione Connect to destination.

  • Access key ID: cadena alfanumérica de 61 caracteres usada para autenticar su cuenta de Google Cloud Storage en Experience Platform. Para obtener información sobre cómo obtener este valor, lea la sección requisitos previos más arriba.

  • Secret access key: cadena de 40 caracteres codificada en Base64 usada para autenticar su cuenta de Google Cloud Storage en Experience Platform. Para obtener información sobre cómo obtener este valor, lea la sección requisitos previos más arriba.

  • Encryption key: de forma opcional, puede adjuntar la clave pública con formato RSA para agregar cifrado a los archivos exportados. Vea un ejemplo de una clave de cifrado con formato correcto en la siguiente imagen.

    Imagen que muestra un ejemplo de una clave PGP correctamente formateada en la interfaz de usuario

Para obtener más información sobre estos valores, lea la guía Claves HMAC de Google Cloud Storage. Para ver los pasos sobre cómo generar tu propio identificador de clave de acceso y clave de acceso secreta, consulta la Google Cloud Storage descripción general de origen.

Rellenar detalles de destino destination-details

Para configurar los detalles del destino, rellene los campos obligatorios y opcionales a continuación. Un asterisco junto a un campo en la interfaz de usuario indica que el campo es obligatorio.

  • Name: rellene el nombre preferido para este destino.

  • Description: Opcional. Por ejemplo, puede mencionar para qué campaña está usando este destino.

  • Bucket name: escriba el nombre del bloque Google Cloud Storage que utilizará este destino.

  • Folder path: escriba la ruta a la carpeta de destino que alojará los archivos exportados.

  • File type: seleccione el formato que Experience Platform debe usar para los archivos exportados. Al seleccionar la opción CSV, también puede configurar las opciones de formato de archivo.

  • Compression format: seleccione el tipo de compresión que Experience Platform debe utilizar para los archivos exportados.

  • Include manifest file: Active esta opción si desea que las exportaciones incluyan un archivo JSON de manifiesto que contenga información sobre la ubicación de exportación, el tamaño de exportación, etc. Se ha asignado un nombre al manifiesto con el formato manifest-<<destinationId>>-<<dataflowRunId>>.json. Ver archivo de manifiesto de ejemplo. El archivo de manifiesto incluye los campos siguientes:

    • flowRunId: la ejecución de flujo de datos que generó el archivo exportado.
    • scheduledTime: la hora en UTC en que se exportó el archivo.
    • exportResults.sinkPath: ruta de acceso de la ubicación de almacenamiento en la que se deposita el archivo exportado.
    • exportResults.name: nombre del archivo exportado.
    • size: tamaño del archivo exportado, en bytes.

Habilitar alertas enable-alerts

Puede activar alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista a la que suscribirse para recibir notificaciones sobre el estado del flujo de datos. Para obtener más información sobre las alertas, consulte la guía sobre suscripción a alertas de destinos mediante la interfaz de usuario.

Cuando termine de proporcionar detalles para la conexión de destino, seleccione Next.

Permisos necesarios de Google Cloud Storage required-google-cloud-storage-permission

Para conectar y exportar datos correctamente a la ubicación de almacenamiento Google Cloud Storage, necesita los siguientes permisos de Google Cloud Storage para los contenedores:

  • orgpolicy.policy.get
  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • storage.managedFolders.create
  • storage.multipartUploads.abort
  • storage.multipartUploads.create
  • storage.multipartUploads.listParts
  • storage.objects.create
  • storage.objects.list

Más información sobre control de acceso y permisos en Google Cloud Storage.

Activar públicos en este destino activate

IMPORTANT
  • Para activar los datos, necesita los permisos de control de acceso View Destinations, Activate Destinations, View Profiles y View Segments 5}. ​ 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 View Identity Graph permiso de control de acceso.
    Seleccione el área de nombres de identidad resaltada en el flujo de trabajo para activar audiencias en los destinos. {width="100" modal="regular"}

Consulte Activar datos de audiencia en destinos de exportación de perfiles por lotes para obtener instrucciones sobre cómo activar audiencias en este destino.

Programación

En el paso Scheduling, puede configurar la programación de exportación para su destino Google Cloud Storage y también configurar el nombre de los archivos exportados.

Asignar atributos e identidades map

En el paso Mapping, puede seleccionar qué campos de atributo e identidad desea exportar para sus perfiles. También puede seleccionar cambiar los encabezados del archivo exportado por cualquier nombre descriptivo que desee. Para obtener más información, vea el paso de asignación en el tutorial de la interfaz de usuario para activar destinos por lotes.

Validación de la exportación de datos correcta exported-data

Para comprobar si los datos se han exportado correctamente, compruebe el bloque Google Cloud Storage y asegúrese de que los archivos exportados contienen las poblaciones de perfiles esperadas.

LISTA DE PERMITIDOS de direcciones IP ip-address-allow-list

Consulte el artículo lista de permitidos de direcciones IP si necesita agregar direcciones IP de Adobe a una lista de permitidos.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6