Integraciones de almacenamiento de almacén de datos

1. Crea un principal de servicio y concede acceso a las API de Fabric.
2. Configura un espacio de trabajo compartido y concede al principal de servicio acceso a él.
3. En el espacio de trabajo compartido de Fabric que creaste en el paso 2, configura las tablas o vistas que quieras sincronizar con Braze.
4. Crea una nueva integración en el dashboard de Braze.
5. Prueba la integración e inicia la sincronización.

Paso 1.1: Configurar el principal de servicio y conceder acceso

Braze se conectará a tu almacén de 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 de Azure
• Principal ID (también llamado ID de aplicación) del principal de servicio
• Secreto de cliente para que Braze se autentique

1. En el portal de Azure, ve al centro de administración de Microsoft Entra y, a continuación, a App Registrations.
2. Selecciona + New registration en Identity > Applications > App registrations.
3. Introduce un nombre y, a continuación, selecciona Accounts in this organizational directory only como tipo de cuenta admitido. A continuación, selecciona Register.
4. Selecciona la aplicación (principal de servicio) que acabas de crear y, a continuación, ve a Certificates & secrets > + New client secret.
5. Introduce una descripción para el secreto y establece un periodo de caducidad para el secreto. Después, selecciona Add.
6. Toma nota del secreto de cliente creado para utilizarlo en la configuración de 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 Settings > Governance and insights > Admin portal > Tenant settings.

• En Developer settings, habilita Service principals can use Fabric APIs para que Braze pueda conectarse utilizando Microsoft Entra ID.
• En OneLake settings, habilita Users can access data stored in OneLake with apps external to Fabric para que el principal de servicio pueda acceder a los datos desde una aplicación externa.

Paso 1.3: Configurar un espacio de trabajo compartido y conceder acceso

Cualquier recurso de Fabric que quieras conectar a Braze debe colocarse en un espacio de trabajo compartido. Si solo has estado usando el espacio de trabajo predeterminado My Workspace, crea un nuevo espacio de trabajo compartido:

1. En el menú de navegación, selecciona Workspaces y luego selecciona + New workspace.
2. Introduce un Name para el espacio de trabajo y selecciona Apply.

Una vez que tengas un espacio de trabajo compartido, concede acceso al principal de servicio:

1. Selecciona el espacio de trabajo y luego selecciona Manage Access.
2. Selecciona + Add people or groups.
3. Busca y selecciona el nombre del principal de servicio que creaste en el paso 1.1. Si no aparece, confirma que has habilitado la configuración Service principals can use Fabric APIs en el paso 1.2.
4. En el desplegable de rol, selecciona Contributor.

El principal de servicio ahora puede acceder a los recursos del almacén de Fabric en este espacio de trabajo a través de sus puntos de conexión SQL, incluido el almacén que utilizarás para Braze.

Paso 1.4: Preparar la tabla

Braze admite tanto tablas como vistas en Fabric Warehouses. Si necesitas crear un nuevo almacén, créalo dentro del espacio de trabajo compartido del paso 1.3. Ve a Create > Data Warehouse > Warehouse en la consola de Fabric.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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, email is used 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 - La hora a la que se actualizó o añadió esta fila a la tabla. Braze sincroniza las filas donde UPDATED_AT es posterior al último valor sincronizado. Las filas en la marca de tiempo exacta del límite pueden volver a sincronizarse si nuevas filas comparten esa misma marca de tiempo.
• Columnas de identificador de usuario - Tu tabla puede contener una o más columnas de identificador de usuario. Cada fila solo 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 deseas actualizar. Debe coincidir con el valor external_id utilizado en Braze.
  • ALIAS_NAME y ALIAS_LABEL - Estas dos columnas crean un objeto de 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 solo un alias_name por alias_label.
  • BRAZE_ID - El identificador de usuario de Braze. Lo genera el SDK de Braze, y no se pueden crear nuevos usuarios utilizando un ID de Braze a través de la ingesta de datos en la nube. Para crear nuevos usuarios, especifica 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 incluyes tanto el correo electrónico como el teléfono, el correo electrónico se utilizará 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 deseas sincronizar con el usuario en Braze.

Paso 1.5: Obtener la cadena de conexión del almacén

Necesitarás el punto de conexión SQL de tu almacén para que Braze pueda conectarse. Para recuperarlo, 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 Copy SQL connection string.

Paso 1.6: Permitir IP de Braze en el cortafuegos (opcional)

Dependiendo de la configuración de tu cuenta de Microsoft Fabric, puede que necesites 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 de Entra.

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)

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

Crearás una nueva sincronización de datos para Microsoft Fabric. En el dashboard de Braze, ve a Data Settings > Cloud Data Ingestion, selecciona Create New Data Sync y, a continuación, selecciona Microsoft Fabric Import.

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

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

• Credentials Name es una etiqueta para estas credenciales en Braze; puedes establecer un valor descriptivo aquí
• Consulta los pasos de la sección 1 para obtener información detallada sobre cómo recuperar el Tenant ID, el Principal ID, el secreto de cliente y la cadena de 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 tu dashboard 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

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 defecto, los correos electrónicos de contacto solo 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 incluir lo siguiente:

• Problemas de conectividad
• Falta de recursos
• Problemas de permisos
• (Solo 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.

Una vez introducidos todos los detalles de configuración de la sincronización, selecciona Test connection. Si tiene é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.

Puedes 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 reutilizas el mismo usuario en varias integraciones, no podrás eliminar el usuario en el dashboard de Braze hasta que se elimine de todas las sincronizaciones activas.

Una vez activada, la sincronización se ejecutará según la planificación configurada durante la instalación. Si deseas ejecutar la sincronización fuera de la planificación normal de pruebas o recuperar los datos más recientes, selecciona Sync Now. Esta ejecución no afectará a las futuras sincronizaciones programadas regularmente.