Integraciones de almacenamiento de almacén de datos

Esta página explica cómo utilizar Braze Cloud Data Ingestion (CDI) para sincronizar datos relevantes con tu integración de Snowflake, Redshift, BigQuery y Databricks.

Configuración de integraciones de almacenes de datos

Las integraciones de la ingesta de datos en la nube requieren cierta configuración en Braze y en tu instancia de almacén de datos. Siga estos pasos para configurar la integración:

En tu instancia de Snowflake, configura las tablas o vistas que quieras sincronizar con Braze.
Cree una nueva integración en el salpicadero de Braze.
Recupera la clave pública proporcionada en panel de Braze y añádela al usuario Snowflake para la autenticación.
Pruebe la integración e inicie la sincronización.

tip:

La guía de inicio rápido de Snowflake proporciona un código de ejemplo y recorre los pasos necesarios para crear una canalización automatizada utilizando Snowflake Streams y CDI para sincronizar datos con Braze.

Asegúrese de que se permite el acceso de Braze a las tablas de Redshift que desea sincronizar. Braze se conectará a Redshift a través de Internet.
En tu instancia de Redshift, configura las tablas o vistas que quieras sincronizar con Braze.
Cree una nueva integración en el salpicadero de Braze.
Pruebe la integración e inicie la sincronización.

Cree una cuenta de servicio y permita el acceso a los proyectos de BigQuery y a los conjuntos de datos que contienen los datos que desea sincronizar.
En tu cuenta de BigQuery, configura las tablas o vistas que quieras sincronizar con Braze.
Cree una nueva integración en el salpicadero de Braze.
Pruebe la integración e inicie la sincronización.

Crea una cuenta de servicio y permite el acceso a los proyectos y conjuntos de datos de Databricks que contienen los datos que deseas sincronizar.
En tu cuenta de Databricks, configura las tablas o vistas que quieras sincronizar con Braze.
Cree una nueva integración en el salpicadero de Braze.
Pruebe la integración e inicie la sincronización.

important:

Puede haber de dos a cinco minutos de tiempo de calentamiento cuando Braze se conecte a las instancias Classic y Pro SQL, lo que provocará retrasos durante la configuración de la conexión y las pruebas, así como al inicio de las sincronizaciones programadas. El uso de una instancia SQL sin servidor minimizará el tiempo de calentamiento y mejorará el rendimiento de las consultas, pero puede dar lugar a costes de integración ligeramente superiores.

Crea un principal de servicio y permite el acceso al espacio de trabajo de Fabric que se utilizará para tu integración.
En tu espacio de trabajo de Fabric, configura las tablas o vistas que quieras sincronizar con Braze.
Cree una nueva integración en el salpicadero de Braze.
Pruebe la integración e inicie la sincronización.

Paso 1: Configurar tablas o vistas

Paso 1.1: Preparar la mesa

CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required  
     EXTERNAL_ID VARCHAR(16777216),
     --if using user alias, both alias_name and alias_label are required
     ALIAS_LABEL VARCHAR(16777216),
     ALIAS_NAME VARCHAR(16777216),
     --braze_id can only be used to update existing users created through the Braze SDK
     BRAZE_ID VARCHAR(16777216),
     --If you include both email and phone, we will use the email as the primary identifier
     EMAIL VARCHAR(16777216),
     PHONE VARCHAR(16777216),
     PAYLOAD VARCHAR(16777216) NOT NULL
);

Puede nombrar la base de datos, el esquema y la tabla como desee, pero los nombres de las columnas deben coincidir con la definición anterior.

UPDATED_AT - Hora a la que se actualizó o añadió esta fila a la tabla. Sólo se sincronizarán las filas que se hayan añadido o actualizado desde la última sincronización.
Columnas de identificador de usuario - Su tabla puede contener una o más columnas de identificador de usuario. Cada fila sólo debe contener un identificador (ya sea external_id, la combinación de alias_name y alias_label, braze_id, email o phone). Una tabla de origen puede tener columnas para uno, dos, tres, cuatro o los cinco tipos de identificadores.
- EXTERNAL_ID - Identifica al usuario que desea actualizar. Esto debería coincidir con el valor external_id utilizado en Braze.
- ALIAS_NAME y ALIAS_LABEL - Estas dos columnas crean un objeto alias de usuario. alias_name debe ser un identificador único, y alias_label especifica el tipo de alias. Los usuarios pueden tener varios alias con etiquetas diferentes, pero sólo un alias_name por alias_label.
- BRAZE_ID - El identificador de usuario Braze. Esto lo genera el SDK de Braze, y no se pueden crear nuevos usuarios utilizando un ID de Braze a través de Cloud Data Ingestion. Para crear nuevos usuarios, especifique un ID de usuario externo o un alias de usuario.
- EMAIL - La dirección de correo electrónico del usuario. Si existen varios perfiles con la misma dirección de correo electrónico, se dará prioridad al perfil actualizado más recientemente. Si incluye tanto el correo electrónico como el teléfono, utilizaremos el correo electrónico como identificador principal.
- PHONE - El número de teléfono del usuario. Si existen varios perfiles con el mismo número de teléfono, se dará prioridad al perfil actualizado más recientemente.
PAYLOAD - Se trata de una cadena JSON de los campos que desea sincronizar con el usuario en Braze.

Paso 1.2: Configurar el rol y los permisos de la base de datos

CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;

Actualiza los nombres según sea necesario, pero los permisos deben coincidir con el ejemplo anterior.

Paso 1.3: Configura el almacén y da acceso al rol de Braze

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

note:

El almacén debe tener activada la bandera de reanudación automática. Si no es así, tendrá que conceder a Braze privilegios adicionales de OPERATE en el almacén para que podamos activarlo cuando llegue el momento de ejecutar la consulta.

Paso 1.4: Configura el usuario

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Después de este paso, compartirás la información de conexión con Braze y recibirás una clave pública para adjuntar al usuario.

note:

Cuando conecte diferentes espacios de trabajo a la misma cuenta Snowflake, debe crear un usuario único para cada espacio de trabajo Braze en el que esté creando una integración. Dentro de un espacio de trabajo, puede reutilizar el mismo usuario en todas las integraciones, pero la creación de la integración fallará si un usuario de la misma cuenta Snowflake se duplica en todos los espacios de trabajo.

Paso 1.5: Permite las IP de Braze en la política de redes de Snowflake (opcional)

Dependiendo de la configuración de su cuenta Snowflake, puede que necesite permitir las siguientes direcciones IP en su política de red Snowflake. Para obtener más información sobre cómo activar esta opción, consulte la documentación pertinente de Snowflake sobre la modificación de una política de red.

Para las instancias US-01, US-02, US-03, US-04, US-05, US-06, US-07, éstas son las direcciones IP correspondientes:

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Por ejemplo US-08, éstas son las direcciones IP correspondientes:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Por ejemplo US-10, éstas son las direcciones IP correspondientes:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Para las instancias EU-01 y EU-02, estas son las direcciones IP correspondientes:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Por ejemplo AU-01, éstas son las direcciones IP correspondientes:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Paso 1.1: Preparar la mesa

Opcionalmente, configura una nueva Base de datos y un nuevo Esquema para albergar tu tabla de origen

CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

Cree una tabla (o vista) para utilizarla en su integración CDI

CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
   updated_at timestamptz default sysdate,
   --at least one of external_id, alias_name and alias_label, or braze_id is required
   external_id varchar,
   --if using user alias, both alias_name and alias_label are required
   alias_label varchar,
   alias_name varchar,
   --braze_id can only be used to update existing users created through the Braze SDK
   braze_id varchar,
   --If you include both email and phone, we will use the email as the primary identifier
   email varchar,
   phone varchar,
   payload varchar(max)
)

Puede nombrar la base de datos, el esquema y la tabla como desee, pero los nombres de las columnas deben coincidir con la definición anterior.

UPDATED_AT - Hora a la que se actualizó o añadió esta fila a la tabla. Sólo se sincronizarán las filas que se hayan añadido o actualizado desde la última sincronización.
Columnas de identificador de usuario - Su tabla puede contener una o más columnas de identificador de usuario. Cada fila sólo debe contener un identificador (ya sea external_id, la combinación de alias_name y alias_label, braze_id, email o phone). Una tabla de origen puede tener columnas para uno, dos, tres, cuatro o los cinco tipos de identificadores.
- EXTERNAL_ID - Identifica al usuario que desea actualizar. Esto debería coincidir con el valor external_id utilizado en Braze.
- ALIAS_NAME y ALIAS_LABEL - Estas dos columnas crean un objeto alias de usuario. alias_name debe ser un identificador único, y alias_label especifica el tipo de alias. Los usuarios pueden tener varios alias con etiquetas diferentes, pero sólo un alias_name por alias_label.
- BRAZE_ID - El identificador de usuario Braze. Esto lo genera el SDK de Braze, y no se pueden crear nuevos usuarios utilizando un ID de Braze a través de Cloud Data Ingestion. Para crear nuevos usuarios, especifique un ID de usuario externo o un alias de usuario.
- EMAIL - La dirección de correo electrónico del usuario. Si existen varios perfiles con la misma dirección de correo electrónico, se dará prioridad al perfil actualizado más recientemente. Si incluye tanto el correo electrónico como el teléfono, utilizaremos el correo electrónico como identificador principal.
- PHONE - El número de teléfono del usuario. Si existen varios perfiles con el mismo número de teléfono, se dará prioridad al perfil actualizado más recientemente.
PAYLOAD - Se trata de una cadena JSON de los campos que desea sincronizar con el usuario en Braze.

Paso 1.2: Crear usuario y conceder permisos

CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;

Estos son los permisos mínimos requeridos para este usuario. Si crea varias integraciones CDI, puede que desee conceder permisos a un esquema o gestionar los permisos mediante un grupo.

Paso 1.3: Permitir el acceso a las IP Braze

Si tienes un cortafuegos u otras políticas de red, debes dar acceso de red a Braze a tu instancia de Redshift. Un ejemplo de punto final de URL de Redshift es “example-cluster.ap-northeast-2.redshift.amazonaws.com”.

Algunas cosas importantes que hay que saber:

Es posible que también tenga que cambiar sus grupos de seguridad para permitir que Braze acceda a sus datos en Redshift.
Asegúrese de permitir explícitamente el tráfico entrante en las IP de la tabla y en el puerto utilizado para consultar su clúster Redshift (por defecto es 5439). Debe permitir explícitamente la conectividad TCP de Redshift en este puerto incluso si las reglas de entrada están configuradas para “permitir todo”.
El punto final del clúster Redshift debe ser de acceso público para que Braze se conecte a tu clúster.
- Si no quieres que tu clúster de Redshift sea accesible públicamente, puedes configurar una VPC y una instancia EC2 para que utilicen un túnel SSH para acceder a los datos de Redshift. Consulte esta publicación del Centro de conocimientos de AWS para obtener más información.

Permita el acceso desde las siguientes IP correspondientes a la región de su cuadro de mandos Braze.

Para las instancias US-01, US-02, US-03, US-04, US-05, US-06, US-07, éstas son las direcciones IP correspondientes:

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Por ejemplo US-08, éstas son las direcciones IP correspondientes:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Por ejemplo US-10, éstas son las direcciones IP correspondientes:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Para las instancias EU-01 y EU-02, estas son las direcciones IP correspondientes:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Por ejemplo AU-01, éstas son las direcciones IP correspondientes:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Paso 1.1: Preparar la mesa

Si lo desea, puede crear un nuevo proyecto o conjunto de datos que contenga la tabla de origen.

CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

Cree una o más tablas para utilizar en su integración CDI con los siguientes campos:

CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp,
  --At least one of external_id, alias_name and alias_label, or braze_id is required  
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  --braze_id can only be used to update existing users created through the Braze SDK
  braze_id STRING,
  --If you include both email and phone, we will use the email as the primary identifier
  email STRING,
  phone STRING,
  payload JSON
);

Nombre del campo	Tipo	Modo
`UPDATED_AT`	MARCA DE TIEMPO	REQUERIDO
`PAYLOAD`	JSON	REQUERIDO
`EXTERNAL_ID`	CADENA	NULABLE
`ALIAS_NAME`	CADENA	NULABLE
`ALIAS_LABEL`	CADENA	NULABLE
`BRAZE_ID`	CADENA	NULABLE
`EMAIL`	CADENA	NULABLE
`PHONE`	CADENA	NULABLE

Puede nombrar el proyecto, el conjunto de datos y la tabla como desee, pero los nombres de las columnas deben coincidir con la definición anterior.

UPDATED_AT - Hora a la que se actualizó o añadió esta fila a la tabla. Sólo se sincronizarán las filas que se hayan añadido o actualizado desde la última sincronización.
Columnas de identificador de usuario - Su tabla puede contener una o más columnas de identificador de usuario. Cada fila sólo debe contener un identificador (ya sea external_id, la combinación de alias_name y alias_label, braze_id, email o phone). Una tabla de origen puede tener columnas para uno, dos, tres, cuatro o los cinco tipos de identificadores.
- EXTERNAL_ID - Identifica al usuario que desea actualizar. Esto debería coincidir con el valor external_id utilizado en Braze.
- ALIAS_NAME y ALIAS_LABEL - Estas dos columnas crean un objeto alias de usuario. alias_name debe ser un identificador único, y alias_label especifica el tipo de alias. Los usuarios pueden tener varios alias con etiquetas diferentes, pero sólo un alias_name por alias_label.
- BRAZE_ID - El identificador de usuario Braze. Esto lo genera el SDK de Braze, y no se pueden crear nuevos usuarios utilizando un ID de Braze a través de Cloud Data Ingestion. Para crear nuevos usuarios, especifique un ID de usuario externo o un alias de usuario.
- EMAIL - La dirección de correo electrónico del usuario. Si existen varios perfiles con la misma dirección de correo electrónico, se dará prioridad al perfil actualizado más recientemente. Si incluye tanto el correo electrónico como el teléfono, utilizaremos el correo electrónico como identificador principal.
- PHONE - El número de teléfono del usuario. Si existen varios perfiles con el mismo número de teléfono, se dará prioridad al perfil actualizado más recientemente. email varchar, varchar phone_number,
PAYLOAD - Se trata de una cadena JSON de los campos que desea sincronizar con el usuario en Braze.

Paso 1.2: Crear una cuenta de servicio y conceder permisos

Cree una cuenta de servicio en GCP para que Braze la utilice para conectarse y leer datos de su(s) tabla(s). La cuenta de servicio debe tener los siguientes permisos:

Usuario de conexión BigQuery: Esto permitirá a Braze hacer conexiones
Usuario de BigQuery: Esto proporcionará acceso a Braze para ejecutar consultas, leer metadatos de conjuntos de datos y listar tablas.
Visor de datos BigQuery: Esto proporcionará acceso a Braze para ver los conjuntos de datos y su contenido.
Usuario de BigQuery Job: Esto proporcionará acceso a Braze para ejecutar trabajos

Tras crear la cuenta de servicio y conceder los permisos, genera una clave JSON. Aquí encontrará más información sobre cómo hacerlo. Actualizarás esto al panel de Braze más tarde.

Paso 1.3: Permitir el acceso a las IP Braze

Si tienes políticas de red en vigor, debes dar acceso de red Braze a tu instancia de BigQuery. Permita el acceso desde las siguientes IP correspondientes a la región de su panel de control Braze.

Para las instancias US-01, US-02, US-03, US-04, US-05, US-06, US-07, éstas son las direcciones IP correspondientes:

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Por ejemplo US-08, éstas son las direcciones IP correspondientes:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Por ejemplo US-10, éstas son las direcciones IP correspondientes:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Para las instancias EU-01 y EU-02, estas son las direcciones IP correspondientes:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Por ejemplo AU-01, éstas son las direcciones IP correspondientes:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Paso 1.1: Preparar la mesa

Opcionalmente, configure un nuevo Catálogo o Esquema para contener su tabla de origen.

CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

Cree una o más tablas para utilizar en su integración CDI con los siguientes campos:

CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp(),
  --At least one of external_id, alias_name and alias_label, or braze_id is required  
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  --braze_id can only be used to update existing users created through the Braze SDK
  braze_id STRING,
  --If you include both email and phone, we will use the email as the primary identifier
  email STRING,
  phone STRING,
  payload STRING, STRUCT, or MAP
);

Nombre del campo	Tipo	Modo
`UPDATED_AT`	MARCA DE TIEMPO	REQUERIDO
`PAYLOAD`	CADENA, ESTRUCTURA o MAPA	REQUERIDO
`EXTERNAL_ID`	CADENA	NULABLE
`ALIAS_NAME`	CADENA	NULABLE
`ALIAS_LABEL`	CADENA	NULABLE
`BRAZE_ID`	CADENA	NULABLE
`EMAIL`	CADENA	NULABLE
`PHONE`	CADENA	NULABLE

Puede nombrar el esquema y la tabla como desee, pero los nombres de las columnas deben coincidir con la definición anterior.

UPDATED_AT - Hora a la que se actualizó o añadió esta fila a la tabla. Sólo se sincronizarán las filas que se hayan añadido o actualizado desde la última sincronización.
Columnas de identificador de usuario - Su tabla puede contener una o más columnas de identificador de usuario. Cada fila sólo debe contener un identificador (ya sea external_id, la combinación de alias_name y alias_label, braze_id, email o phone). Una tabla de origen puede tener columnas para uno, dos, tres, cuatro o los cinco tipos de identificadores.
- EXTERNAL_ID - Identifica al usuario que desea actualizar. Esto debería coincidir con el valor external_id utilizado en Braze.
- ALIAS_NAME y ALIAS_LABEL - Estas dos columnas crean un objeto alias de usuario. alias_name debe ser un identificador único, y alias_label especifica el tipo de alias. Los usuarios pueden tener varios alias con etiquetas diferentes, pero sólo un alias_name por alias_label.
- BRAZE_ID - El identificador de usuario Braze. Esto lo genera el SDK de Braze, y no se pueden crear nuevos usuarios utilizando un ID de Braze a través de Cloud Data Ingestion. Para crear nuevos usuarios, especifique un ID de usuario externo o un alias de usuario.
- EMAIL - La dirección de correo electrónico del usuario. Si existen varios perfiles con la misma dirección de correo electrónico, se dará prioridad al perfil actualizado más recientemente. Si incluye tanto el correo electrónico como el teléfono, utilizaremos el correo electrónico como identificador principal.
- PHONE - El número de teléfono del usuario. Si existen varios perfiles con el mismo número de teléfono, se dará prioridad al perfil actualizado más recientemente.
PAYLOAD - Se trata de una cadena o estructura de los campos que desea sincronizar con el usuario en Braze.

Paso 1.2: Crear un token de acceso

Para que Braze acceda a Databricks, es necesario crear un token de acceso personal.

En tu espacio de trabajo de Databricks, selecciona tu nombre de usuario de Databricks en la barra superior y, a continuación, selecciona Configuración de usuario en el desplegable.
En la pestaña Tokens de acceso, selecciona Generar nuevo token.
Introduzca un comentario que le ayude a identificar este token, como “Braze CDI”, y cambie la vida útil del token a sin vida útil dejando la casilla Vida útil (días) vacía (en blanco).
Seleccione Generar.
Copie el token mostrado y seleccione Hecho.

Guarde el token en un lugar seguro hasta que necesite introducirlo en el panel de control de Braze durante el paso de creación de credenciales.

Paso 1.3: Permitir el acceso a las IP Braze

Si tienes políticas de red en vigor, debes dar acceso de red Braze a tu instancia de Databricks. Permita el acceso desde las siguientes IP correspondientes a la región de su panel de control Braze.

Para las instancias US-01, US-02, US-03, US-04, US-05, US-06, US-07, éstas son las direcciones IP correspondientes:

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Por ejemplo US-08, éstas son las direcciones IP correspondientes:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Por ejemplo US-10, éstas son las direcciones IP correspondientes:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Para las instancias EU-01 y EU-02, estas son las direcciones IP correspondientes:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Por ejemplo AU-01, éstas son las direcciones IP correspondientes:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Paso 1.1: Configurar el principal del servicio y conceder acceso

Braze se conectará a tu almacén Fabric utilizando un principal de servicio con autenticación Entra ID. Crearás un nuevo principal de servicio para que lo utilice Braze, y concederás acceso a los recursos de Fabric según sea necesario. Braze necesitará los siguientes datos para conectarse:

Tenant ID (también llamado directorio) de tu cuenta Azure
ID de la entidad de seguridad (también llamado ID de aplicación) para la entidad de seguridad del servicio
Secreto de cliente para que Braze se autentique

En el portal de Azure, ve al centro de administración de Microsoft Entra y, a continuación, a Registros de aplicaciones.
Selecciona + Nuevo registro en Identidad > Aplicaciones > Registros de aplicaciones.
Introduce un nombre y, a continuación, selecciona Accounts in this organizational directory only como tipo de cuenta admitido. A continuación, selecciona Registro.
Selecciona la aplicación (servicio principal) que acabas de crear y, a continuación, ve a Certificados y secretos > + Nuevo secreto de cliente.
Introduce una descripción para el secreto y establece un periodo de caducidad para el secreto. Después, selecciona Añadir.
Toma nota del secreto de cliente creado para utilizarlo en la configuración de Braze.

note:

Azure no permite la caducidad ilimitada de los secretos de principal de servicio. Recuerda actualizar las credenciales antes de que caduquen para mantener el flujo de datos a Braze.

Paso 1.2: Conceder acceso a los recursos de Fabric

Proporcionarás acceso para que Braze se conecte a tu instancia de Fabric. En tu portal de administración de Fabric, ve a Configuración > Gobierno e información > Portal de administración > Configuración de inquilinos.

En la configuración del desarrollador habilita “Los principales del servicio pueden utilizar APIs de Fabric” para que Braze pueda conectarse utilizando Microsoft Entra ID.
En la configuración de OneLake habilita “Los usuarios pueden acceder a los datos almacenados en OneLake con aplicaciones externas a Fabric” para que el principal del servicio pueda acceder a los datos de una aplicación externa.

Paso 1.3: Preparar la mesa

Braze admite tanto tablas como vistas en Fabric Warehouses. Si necesitas crear un nuevo almacén, ve a Crear > Almacén de datos > Almacén en la consola Fabric.

CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name] 
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required  
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR,
  --braze_id can only be used to update existing users created through the Braze SDK
  BRAZE_ID VARCHAR,
  --If you include both email and phone, we will use the email as the primary identifier
  EMAIL VARCHAR,
  PHONE VARCHAR
)
GO

Puedes nombrar el almacén, el esquema y la tabla o vista como quieras, pero los nombres de las columnas deben coincidir con la definición anterior.

UPDATED_AT - Hora a la que se actualizó o añadió esta fila a la tabla. Sólo se sincronizarán las filas que se hayan añadido o actualizado desde la última sincronización.
Columnas de identificador de usuario - Su tabla puede contener una o más columnas de identificador de usuario. Cada fila sólo debe contener un identificador (ya sea external_id, la combinación de alias_name y alias_label, braze_id, email o phone). Una tabla de origen puede tener columnas para uno, dos, tres, cuatro o los cinco tipos de identificadores.
- EXTERNAL_ID - Identifica al usuario que desea actualizar. Esto debería coincidir con el valor external_id utilizado en Braze.
- ALIAS_NAME y ALIAS_LABEL - Estas dos columnas crean un objeto alias de usuario. alias_name debe ser un identificador único, y alias_label especifica el tipo de alias. Los usuarios pueden tener varios alias con etiquetas diferentes, pero sólo un alias_name por alias_label.
- BRAZE_ID - El identificador de usuario Braze. Esto lo genera el SDK de Braze, y no se pueden crear nuevos usuarios utilizando un ID de Braze a través de Cloud Data Ingestion. Para crear nuevos usuarios, especifique un ID de usuario externo o un alias de usuario.
- EMAIL - La dirección de correo electrónico del usuario. Si existen varios perfiles con la misma dirección de correo electrónico, se dará prioridad al perfil actualizado más recientemente. Si incluye tanto el correo electrónico como el teléfono, utilizaremos el correo electrónico como identificador principal.
- PHONE - El número de teléfono del usuario. Si existen varios perfiles con el mismo número de teléfono, se dará prioridad al perfil actualizado más recientemente.
PAYLOAD - Se trata de una cadena JSON de los campos que desea sincronizar con el usuario en Braze.

Paso 1.4: Obtener cadena de conexión al almacén

Necesitarás el punto final SQL de tu almacén para que Braze pueda conectarse. Para recuperarla, ve al espacio de trabajo en Fabric, y en la lista de elementos, pasa el ratón por encima del nombre del almacén y selecciona Copiar cadena de conexión SQL.

La página "Fabric Console" de Microsoft Azure, donde los usuarios deben recuperar la cadena de conexión SQL.

Paso 1.5: Permitir IPs Braze en Firewall (Opcional)

Dependiendo de la configuración de tu cuenta Microsoft Fabric, puede que tengas que permitir las siguientes direcciones IP en tu cortafuegos para permitir el tráfico desde Braze. Para más información sobre cómo habilitarlo, consulta la documentación correspondiente sobre el Acceso Condicional Entra.

Para las instancias US-01, US-02, US-03, US-04, US-05, US-06, US-07, éstas son las direcciones IP correspondientes:

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Por ejemplo US-08, éstas son las direcciones IP correspondientes:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Por ejemplo US-10, éstas son las direcciones IP correspondientes:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Para las instancias EU-01 y EU-02, estas son las direcciones IP correspondientes:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Por ejemplo AU-01, éstas son las direcciones IP correspondientes:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Paso 2: Crear una nueva integración en el cuadro de mandos de Braze

En el Dashbord Braze, ve a Configuración de datos > Ingesta de datos en la nube, selecciona Crear nueva sincronización de datos y, a continuación, Snowflake Importar.

Paso 2.1: Añadir información de conexión Snowflake y tabla de origen

Introduce la información de tu almacén de datos Snowflake y la tabla de origen, y pasa al siguiente paso.

La página "Crear nueva sincronización de importación" para Snowflake en el panel de Braze con datos de ejemplo introducidos en el Paso 1: "Configurar conexión".

Paso 2.2: Configurar los detalles de sincronización

A continuación, elige un nombre para la sincronización e introduce los correos electrónicos de los contactos. Utilizaremos esta información de contacto para notificarle cualquier error de integración, como la eliminación inesperada del acceso a la mesa.

Los correos electrónicos de contacto sólo recibirán notificaciones de errores globales o a nivel de sincronización, como falta de tablas, permisos y otros. No recibirán ediciones a nivel de fila. Los errores globales indican problemas críticos con la conexión que impiden que se ejecuten las sincronizaciones. Estos problemas pueden ser los siguientes:

Problemas de conectividad
Falta de recursos
Problemas de permisos
(Sólo para sincronización de catálogos) No hay espacio en el nivel de catálogo

La página "Crear nueva sincronización de importación" para Snowflake en el panel de Braze con datos de ejemplo añadidos en el Paso 2: "Configurar detalles de sincronización".

También elegirás el tipo de datos y la frecuencia de sincronización. La frecuencia puede ser desde cada 15 minutos hasta una vez al mes. Utilizaremos la zona horaria configurada en el panel de control de Braze para programar la sincronización periódica. Los tipos de datos admitidos son Atributos personalizados, Eventos personalizados y Eventos de compra, y el tipo de datos para una sincronización no se puede cambiar después de la creación.

Añadir una clave pública al usuario Braze

En este punto, debe volver a Snowflake para completar la configuración. Añada la clave pública que aparece en el panel al usuario que creó para que Braze se conecte a Snowflake.

Para más información sobre cómo hacerlo, consulta la documentación de Snowflake. Si desea rotar las claves en cualquier momento, podemos generar un nuevo par de claves y proporcionarle la nueva clave pública.

ALTER USER BRAZE_INGESTION_USER SET rsa_public_key='Braze12345...';

En el Dashbord de Braze, ve a Configuración de datos > Ingesta de datos en la nube, selecciona Crear nueva sincronización de datos y, a continuación, selecciona Importación de Amazon Redshift.

Paso 2.1: Añadir información de conexión Redshift y tabla de origen

Introduce la información de tu almacén de datos Redshift y la tabla de origen. Si utilizas un túnel de red privada, alterna el control deslizante e introduce la información del túnel. A continuación, continúe con el siguiente paso.

La página "Crear nueva sincronización de importación" para Redshift en el panel de Braze, configurada en el Paso 1: "Configurar conexión".

Paso 2.2: Configurar los detalles de sincronización

Problemas de conectividad
Falta de recursos
Problemas de permisos
(Sólo para sincronización de catálogos) No hay espacio en el nivel de catálogo

La página "Crear nueva sincronización de importación" para Redshift en el panel de Braze con algunos datos de ejemplo añadidos en el Paso 2: "Configurar detalles de sincronización".

Paso 2.1: Añadir información de conexión BigQuery y tabla de origen

Cargue la clave JSON y proporcione un nombre para la cuenta de servicio; a continuación, introduzca los detalles de su tabla de origen.

La página "Crear nueva sincronización de importación" para BigQuery en el panel de Braze, configurada en el Paso 1: "Configurar conexión".

Paso 2.2: Configurar los detalles de sincronización

Problemas de conectividad
Falta de recursos
Problemas de permisos
(Sólo para sincronización de catálogos) No hay espacio en el nivel de catálogo

La página "Crear nueva sincronización de importación" para BigQuery en el panel de Braze, configurada en el Paso 2: "Configurar detalles de sincronización".

También elegirás el tipo de datos y la frecuencia de sincronización. La frecuencia puede ser desde cada 15 minutos hasta una vez al mes. Utilizaremos la zona horaria configurada en el panel de control de Braze para programar la sincronización periódica. Los tipos de datos soportados son Atributos Personalizados, Eventos Personalizados, Eventos de Compra y Borrados de Usuario. El tipo de datos de una sincronización no puede modificarse después de su creación.

Paso 2.1: Añadir información de conexión Databricks y tabla de origen

Introduce la información de tu almacén de datos Databricks y la tabla de origen, y pasa al siguiente paso.

La página "Crear nueva sincronización de importación" para Databricks en el panel de Braze, configurada en el Paso 1: "Configurar conexión".

Paso 2.2: Configurar los detalles de sincronización

Problemas de conectividad
Falta de recursos
Problemas de permisos
(Sólo para sincronización de catálogos) No hay espacio en el nivel de catálogo

La página "Crear nueva sincronización de importación" para Databricks en el panel de Braze, configurada en el Paso 2: "Configurar detalles de sincronización".

También elegirás el tipo de datos y la frecuencia de sincronización. La frecuencia puede ser desde cada 15 minutos hasta una vez al mes. Utilizaremos la zona horaria configurada en el panel de control de Braze para programar la sincronización periódica. Los tipos de datos admitidos son atributos personalizados, eventos personalizados, eventos de compra y eliminaciones de usuarios. El tipo de datos de una sincronización no puede modificarse después de su creación.

Paso 2.1: Configurar una sincronización de la ingesta de datos en la nube

Crearás una nueva sincronización de datos para Microsoft Fabric. En el panel de control de Braze, ve a Configuración de datos > Ingesta de datos en la nube, selecciona Crear nueva sincronización de datos y, a continuación, selecciona Importar Microsoft Fabric.

Paso 2.2: Añadir información de conexión Microsoft Fabric y tabla de origen

Introduce la información de tus credenciales del almacén Microsoft Fabric y la tabla de origen, y pasa al siguiente paso.

Nombre de credenciales es una etiqueta para estas credenciales en Braze, puedes establecer un valor útil aquí
Consulta los pasos de la sección 1 para obtener información detallada sobre cómo recuperar el ID de arrendatario, el ID de mandante, el secreto de cliente y la cadena de conexión.

La página "Crear nueva sincronización de importación" para Redshift en el panel de Braze, configurada en el Paso 1: "Configurar conexión".

Paso 2.3: Configurar los detalles de sincronización

A continuación, configura los siguientes detalles para tu sincronización:

Nombre de la sincronización
Tipo de datos - Los tipos de datos admitidos son atributos personalizados, eventos personalizados, eventos de compra, catálogos y eliminaciones de usuarios. El tipo de datos de una sincronización no puede modificarse después de su creación.
Frecuencia de sincronización - La frecuencia puede ser desde cada 15 minutos hasta una vez al mes. Utilizaremos la zona horaria configurada en el panel de control de Braze para programar la sincronización periódica.
- Las sincronizaciones no periódicas se pueden desencadenar manualmente o a través de la API

La página "Crear nueva sincronización de importación" para Microsoft Fabric en el panel de Braze, configurada en el Paso 2: "Configurar detalles de sincronización".

Paso 2.4: Configurar las preferencias de notificación

A continuación, introduce los correos electrónicos de contacto. Utilizaremos esta información de contacto para notificarte cualquier error de integración, como la eliminación inesperada del acceso a la tabla, o alertarte cuando determinadas filas no se actualicen .

Por predeterminado, los correos electrónicos de contacto sólo recibirán notificaciones de errores globales o a nivel de sincronización, como tablas que faltan, permisos y otros. Los errores globales indican problemas críticos con la conexión que impiden que se ejecuten las sincronizaciones. Estos problemas pueden ser los siguientes:

Problemas de conectividad
Falta de recursos
Problemas de permisos
(Sólo para sincronización de catálogos) No hay espacio en el nivel de catálogo

También puedes configurar alertas para problemas a nivel de fila, o elegir recibir una alerta cada vez que una sincronización se ejecute correctamente.

La página "Crear nueva sincronización de importación" para Microsoft Fabric en el panel de Braze, configurada en el Paso 3: "Configura las preferencias de notificación".

Paso 3: Probar conexión

Vuelve al panel de control de Braze y selecciona Probar conexión. Si tienes éxito, verás una vista previa de los datos. Si, por alguna razón, no podemos conectar, mostraremos un mensaje de error para ayudarte a solucionar el problema.

La página "Crear nueva sincronización de importación" para Snowflake en el panel de Braze con el Paso 3: "Conexión de prueba" mostrando una clave pública RSA.

public network
private network

La página "Crear nueva sincronización de importación" para Redshift en el panel de Braze, configurada en el paso 3: "Prueba de conexión".

La página "Crear nueva sincronización de importación" para Red Privada Redshift en el panel de Braze, con el Paso 4: "Conexión de prueba" mostrando una clave pública RSA.

Una vez introducidos todos los detalles de configuración de la sincronización, seleccione Probar conexión. Si tienes éxito, verás una vista previa de los datos. Si, por alguna razón, no podemos conectar, mostraremos un mensaje de error para ayudarte a solucionar el problema.

La página "Crear nueva sincronización de importación" para BigQuery en el panel de Braze, configurada en el Paso 3: "Prueba de conexión".

La página "Crear nueva sincronización de importación" para Databricks en el panel de Braze, configurada en el Paso 3: "Prueba de conexión".

La página "Crear nueva sincronización de importación" para Microsoft Fabric en el panel de Braze, configurada en el Paso 4: "Prueba de conexión".

note:

Debe probar con éxito una integración antes de que pueda pasar del estado Borrador al Activo. Si necesita salir de la página de creación, su integración se guardará y podrá volver a visitar la página de detalles para realizar cambios y pruebas.

Configurar integraciones o usuarios adicionales (opcional)

Puede configurar varias integraciones con Braze, pero cada integración debe configurarse para sincronizar una tabla diferente. Al crear sincronizaciones adicionales, puede reutilizar las credenciales existentes si se conecta a la cuenta Snowflake.

La página "Crear nueva sincronización de importación" para Snowflake en el panel de Braze, con el desplegable "Seleccionar credenciales" abierto en el Paso 1: "Configurar conexión".

Si reutiliza el mismo usuario y función en todas las integraciones, no tendrá que volver a añadir la clave pública.

La página "Crear nueva sincronización de importación" para Redshift en el panel de Braze, con el desplegable "Seleccionar credenciales" abierto en el Paso 1: "Configurar conexión".

Si reutiliza el mismo usuario en varias integraciones, no podrá eliminar el usuario en el panel de control de Braze hasta que se elimine de todas las sincronizaciones activas.

La página "Crear nueva sincronización de importación" para BigQuery en el panel de Braze, con el desplegable "Seleccionar credenciales" abierto en el Paso 1: "Configurar conexión".

Si reutiliza el mismo usuario en varias integraciones, no podrá eliminar el usuario en el panel de control de Braze hasta que se elimine de todas las sincronizaciones activas.

Puede configurar varias integraciones con Braze, pero cada integración debe configurarse para sincronizar una tabla diferente. Al crear sincronizaciones adicionales, puedes reutilizar las credenciales existentes si te conectas a la misma cuenta de Databricks.

La página "Crear nueva sincronización de importación" para Databricks en el panel de Braze, con el desplegable "Seleccionar credenciales" abierto en el Paso 1: "Configurar conexión".

Si reutiliza el mismo usuario en varias integraciones, no podrá eliminar el usuario en el panel de control de Braze hasta que se elimine de todas las sincronizaciones activas.

Puede configurar varias integraciones con Braze, pero cada integración debe configurarse para sincronizar una tabla diferente. Al crear sincronizaciones adicionales, puedes reutilizar las credenciales existentes si te conectas a la misma cuenta de Fabric.

Si reutiliza el mismo usuario en varias integraciones, no podrá eliminar el usuario en el panel de control de Braze hasta que se elimine de todas las sincronizaciones activas.

Ejecución de la sincronización

Una vez activada, la sincronización se ejecutará según el calendario configurado durante la instalación. Si desea ejecutar la sincronización fuera del calendario normal de pruebas o recuperar los datos más recientes, seleccione Sincronizar ahora. Esta ejecución no afectará a las futuras sincronizaciones programadas regularmente.

La página "Importación de datos" para Snowflake en el panel de Braze muestra la opción "Sincronizar ahora" del menú de elipses verticales.

La página "Importación de datos" para Redshift en el panel de Braze muestra la opción "Sincronizar ahora" del menú de elipses verticales.

La página "Importación de datos" para BigQuery en el panel de Braze muestra la opción "Sincronizar ahora" del menú de elipses verticales.

La página "Importación de datos" para Databricks en el panel de Braze muestra la opción "Sincronizar ahora" del menú de elipses verticales.

Editar esta página en GitHub

¿QUÉ TAN ÚTIL FUE ESTA PÁGINA?

Editar esta página en GitHub

New Stuff!