Google Cloud Storage
Google Cloud Storage es un sistema de almacenamiento de objetos masivo y escalable para datos no estructurados ofrecido por Google como parte del paquete de productos Cloud Computing.
Si vas a cambiar de proveedor de almacenamiento en la nube, ponte en contacto con tu administrador del éxito del cliente de Braze para que te ayude a configurar y validar tu nueva integración.
La integración de Braze y Google Cloud Storage te permite transmitir datos de Currents a Google Cloud Storage. Posteriormente, puede utilizar un proceso ETL (Extract, Transform, Load) para transferir sus datos a otras ubicaciones, como Google BigQuery.
Requisitos previos
| Requisito | Descripción |
|---|---|
| Cuenta Google Cloud Storage | Se necesita una cuenta de Google Cloud Storage para beneficiarse de esta asociación. |
| Currents | Para volver a exportar datos a Google Cloud Storage, debes tener configurado Braze Currents en tu cuenta. Currents no es necesario si sólo estás configurando el archivo de mensajes. |
Integración
Para integrarse con Google Cloud Storage, debe configurar las credenciales adecuadas que permitan a Braze obtener información sobre los buckets de almacenamiento en los que se está escribiendo (storage.buckets.get) y crear objetos dentro de ese bucket (storage.objects.create).
Workload Identity Federation (WIF) no es compatible como método de autenticación para Currents. Debes utilizar una cuenta de servicio con una clave privada JSON.
Para ello, siga las siguientes instrucciones, que le guiarán a través de la creación de un rol y una cuenta de servicio que generarán una clave privada para utilizarla en su integración de Currents.
Paso 1: Crear rol
Crea un nuevo rol en tu Consola de Google Cloud Platform accediendo a IAM & admin > Roles > + Crear Rol.
Dale un nombre al rol, luego selecciona +Añadir permisos y elige lo siguiente:
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
El permiso storage.objects.delete es opcional. Permite a Braze limpiar los archivos incompletos.
En raras circunstancias, Google Cloud puede finalizar las conexiones antes de tiempo, lo que provoca que Braze escriba archivos incompletos en Google Cloud Storage. En la mayoría de los casos, Braze volverá a intentarlo y creará un nuevo archivo con los datos correctos, dejando el archivo antiguo en Google Cloud Storage.
Cuando hayas terminado, selecciona Crear.
Paso 2: Crear una nueva cuenta de servicio
Paso 2.1: Crear la cuenta de servicio
Crea una nueva cuenta de servicio en tu consola de Google Cloud Platform accediendo a IAM & admin > Cuentas de servicio y seleccionando Crear cuenta de servicio.
A continuación, asigna un nombre a la cuenta de servicio y concédele acceso al rol personalizado que acabas de crear.
Paso 2.2: Crear una clave
En la parte inferior de la página, utilice el botón Crear clave para crear una clave privada JSON y utilizarla en Braze. Una vez creada la clave, se descargará en tu máquina.
Paso 3: Configurar corrientes en Braze
En Braze, ve a Corrientes > + Crear corriente > Exportación de datos de Google Cloud Storage e indica tu nombre de integración y tu correo electrónico de contacto.
A continuación, sube tu clave privada JSON en Credenciales JSON GCS e indica tu nombre de contenedor GCS y el prefijo GCS (opcional). Ten en cuenta que debes generar estas credenciales a través de Google Cloud Platform, como se describe en los pasos anteriores.
Es importante que mantengas actualizado tu archivo de credenciales; si las credenciales de tu conector caducan, el conector dejará de enviar eventos. Si esto persiste durante más de 5 días, los eventos del conector se eliminarán y los datos se perderán permanentemente.
Por último, desplácese hasta la parte inferior de la página y seleccione los eventos de participación en mensajes o los eventos de comportamiento del cliente que desea exportar. Cuando hayas terminado, lanza tu Corriente.
Paso 4: Configurar las exportaciones de Google Cloud Storage
Para configurar las exportaciones de Google Cloud Storage (GCS), vaya a Socios tecnológicos > Google Cloud Storage, introduzca sus credenciales de GCS y seleccione Convertir este destino en el destino predeterminado de exportación de datos.
Ten en cuenta que la organización y el contenido de los archivos exportados serán idénticos en todas las integraciones de AWS S3, Microsoft Azure y Google Cloud Storage.
Asegúrate de introducir el valor JSON completo generado por Google Cloud.
Paso 5: Comprueba las credenciales de tu cuenta de servicio (opcional)
Tu cuenta del servicio IAM de Google Cloud debe tener los siguientes permisos:
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
Para verificar estos permisos en el panel de Braze, ve a la página Google Cloud Storage y, a continuación, selecciona Probar credenciales.
Comportamiento de la exportación
Los usuarios que hayan integrado una solución de almacenamiento en la nube y estén intentando exportar API, informes de panel o informes CSV experimentarán lo siguiente:
- Todas las exportaciones de la API no devolverán una URL de descarga en el cuerpo de la respuesta y deberán recuperarse a través del almacenamiento de datos.
- Todos los informes del panel y los informes CSV se enviarán al correo electrónico del usuario para su descarga (sin necesidad de permisos de almacenamiento) y se realizará una copia de seguridad en Almacenamiento de datos.
Requisito de formato JSON: Para las exportaciones JSON, Braze utiliza el formato JSONL (JSON delimitado por nuevas líneas), en el que cada línea contiene un objeto JSON independiente. Este formato difiere del JSON estándar, que es una única matriz u objeto JSON. Cada línea del archivo exportado es un objeto JSON válido, pero el archivo en su conjunto no es un único documento JSON válido. Al procesar estos archivos, analiza cada línea individualmente como un objeto JSON distinto, en lugar de intentar analizar todo el archivo como un único documento JSON.
Las exportaciones de Currents utilizan el formato Apache Avro (archivos.avro ), no JSON. Este requisito de formato JSON se aplica a las exportaciones de datos del panel y a las exportaciones de API que utilizan el formato JSON.
Solución de problemas
Las credenciales de Google Cloud Storage no son válidas
Si recibes el siguiente error al intentar introducir tus credenciales:
1
Google Cloud Storage Credentials are invalid. Please ensure that your credentials string, bucket name, and prefix are valid. You do not have read permission.
Asegúrate de que tu cuenta del servicio IAM de Google Cloud tiene los siguientes permisos:
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
Tras la verificación, puedes comprobar tus credenciales en el panel de Braze.
Editar esta página en GitHub