ConvertmaxDocumentación
Habla con nosotrosComenzar
Integraciones

Microsoft Fabric

Publica los conjuntos de datos de reporting de Convertmax en una base Open Mirrored de Microsoft Fabric para SQL y Power BI, con configuración y validación.

Copiar página
Open in ChatGPTAbrir con contexto de la páginaOpen in ClaudeAbrir con contexto de la página

La sincronización Fabric de Convertmax publica los mismos conjuntos de datos de reporting que BigQuery en una base Open Mirrored de Microsoft Fabric de tu propiedad. Convertmax escribe archivos Parquet en la zona de aterrizaje de OneLake; Fabric los replica en tablas Delta para analítica SQL y Power BI.

Esto es un export de almacén. Es independiente de cualquier conexión OAuth opcional de Microsoft Fabric usada para explorar workspaces. La sincronización usa una app de Entra dedicada (escritora) y un secreto de cliente, no ese token OAuth.

Usa esta guía cuando Data Warehouse Sync esté habilitado para tu organización.

Qué se sincroniza

Seis tablas, alineadas con el contrato de reporting de BigQuery:

Tabla Contenido
visits Hechos de sesión y visita de página, UTM, dispositivo y señales agénticas
acquisition_events Eventos de adquisición y touch
conversion_events Conversiones e ingresos
custom_events Eventos de tracker personalizados con nombre
click_events Eventos de clic
daily_searches Filas agregadas de búsqueda y descubrimiento

Cada fila también incluye:

  • _source_id — identidad estable de la fila de reporting de origen
  • __rowMarker__ — marcador de upsert de Open Mirroring

Clave primaria para el mirroring: (tenant_id, time, _source_id)

Las filas reenviadas con la misma clave se actualizan in situ. No crean duplicados.

Cuándo un sitio puede exportar

Un sitio solo se exporta cuando se cumplen todas estas condiciones:

  1. El add-on Data Warehouse Sync está activo para la organización del sitio
  2. Hay un destino Fabric configurado (ID de directorio de Entra, ID de app escritora, ID de workspace, ID de base reflejada y secreto de cliente escritor)
  3. El export está On en Integrations → Data Warehouse

Una base Open Mirrored solo puede asignarse a un sitio de Convertmax.

Autenticación

Convertmax escribe en tu zona de aterrizaje de OneLake con una aplicación de Microsoft Entra (service principal) y un secreto de cliente.

Crea o designa una app escritora en tu directorio de Entra, concédele permiso para escribir en el workspace de Fabric que posee la base reflejada y proporciona:

  • ID de directorio (tenant) de Microsoft Entra
  • ID de aplicación (cliente)
  • Secreto de cliente
  • ID de workspace de Fabric
  • ID de la base Open Mirrored

Guarda y comparte el secreto solo por los canales que apruebe tu equipo de seguridad. Después de guardarlo en Convertmax, el secreto no vuelve a mostrarse en la interfaz.

Preparar el destino de Fabric

En Microsoft Fabric:

  1. Confirma un workspace con capacidad de Fabric.
  2. Crea una base Open Mirrored (la zona de aterrizaje de OneLake donde Convertmax publicará).
  3. Concede a la app escritora acceso a ese workspace para que pueda dejar archivos en la zona de aterrizaje.

Convertmax no crea la base reflejada por ti. Debe existir antes de activar el export.

Configuración en Convertmax

Cuando Data Warehouse Sync esté habilitado:

  1. Abre Integrations → Data Warehouse → Microsoft Fabric.
  2. Introduce el ID de directorio, el ID de app escritora, el ID de workspace y el ID de base reflejada.
  3. Pega el secreto de cliente escritor.
  4. Activa el export (On).

Si no ves Microsoft Fabric, es posible que el add-on no esté habilitado para tu organización: contacta con el soporte de Convertmax.

Cambiar el workspace o la base reflejada inicia un nuevo backfill. Convertmax no elimina archivos del destino anterior.

Cómo funciona la sincronización

En un calendario (y cuando Convertmax ejecuta una sincronización para tu workspace), Convertmax:

  1. Lee las filas de reporting del sitio con derecho.
  2. Escribe lotes Parquet comprimidos con Snappy en la zona de aterrizaje de Fabric de ese sitio, con claves de upsert.
  3. Deja que Fabric replique esos archivos en las seis tablas reflejadas.

Primera ejecución: backfill del historial disponible. Ejecuciones posteriores: incrementales, con una ventana de 48 horas para reenviar actualizaciones tardías de ese intervalo como upserts.

Las tablas vacías reciben igual un archivo Parquet tipado de cero filas para que el esquema pueda aparecer en Fabric antes de los datos.

En Convertmax, Files published (y la marca de tiempo) significa que los archivos llegaron a OneLake. No significa que Fabric haya terminado la replicación. Confirma la replicación en Fabric.

Comportamiento de los datos

Comportamiento Qué esperar
Upserts La reentrega actualiza filas con la misma clave; no añade duplicados
Ventana de relectura 48 horas para cubrir actualizaciones tardías
Resincronización completa Reproduce las filas de origen disponibles como upserts; no trunca las tablas de destino
Borrados Las eliminaciones en origen no se propagan
Tablas vacías El esquema puede aparecer antes de cualquier fila
Cambio de destino Un workspace o base nuevos reinician el progreso y hacen backfill; el destino anterior no se limpia

No trates esta versión como CDC exacto.

Validar el export

Después de la configuración y la primera publicación correcta:

  1. En Fabric, confirma que aparecen archivos en la zona de aterrizaje y que la replicación está en marcha.
  2. En SQL de Fabric sobre la base reflejada, confirma que existen las seis tablas y que los recuentos son coherentes:
SELECT 'visits' AS table_name, COUNT_BIG(*) AS rows FROM dbo.visits
UNION ALL SELECT 'acquisition_events', COUNT_BIG(*) FROM dbo.acquisition_events
UNION ALL SELECT 'conversion_events', COUNT_BIG(*) FROM dbo.conversion_events
UNION ALL SELECT 'custom_events', COUNT_BIG(*) FROM dbo.custom_events
UNION ALL SELECT 'click_events', COUNT_BIG(*) FROM dbo.click_events
UNION ALL SELECT 'daily_searches', COUNT_BIG(*) FROM dbo.daily_searches;
  1. Compara recuentos e ingresos con el reporting de Convertmax para el mismo sitio y el mismo intervalo.
  2. Tras una sincronización posterior, confirma que las claves sin cambios no inflan los recuentos.

Deja tiempo a la replicación de Fabric después de que Convertmax muestre Files published.

Solución de problemas

Microsoft Fabric no aparece en Integrations

Confirma que Data Warehouse Sync está habilitado para tu organización y contacta con el soporte de Convertmax con el nombre de tu workspace.

Guardado en la app pero no hay archivos en OneLake

Confirma el ID de directorio de Entra, el ID de app, el ID de workspace y el ID de base reflejada, que el export está On y que la app escritora puede escribir en el workspace. Luego contacta con el soporte de Convertmax con el nombre de tu workspace y la hora aproximada de la configuración.

Archivos publicados, pero tablas vacías o desactualizadas en Fabric

Convertmax ya dejó los archivos; Fabric puede seguir replicando. Revisa el estado de replicación de la base reflejada en Fabric. Si la replicación está sana y las tablas siguen vacías, contacta con el soporte de Convertmax.

Errores de permiso o de secreto

Confirma:

  • que la app escritora está en el directorio de Entra correcto
  • que el secreto de cliente está vigente (no se vuelve a mostrar tras guardar: rótalo y vuelve a introducirlo si hace falta)
  • que la app tiene acceso al workspace de Fabric y a la base Open Mirrored

Los recuentos siguen creciendo para el mismo periodo

Las claves de fila deberían hacer upsert. Si los recuentos aumentan tras una resincronización, confirma que consultas las tablas reflejadas (no los archivos crudos de la zona de aterrizaje) y contacta con el soporte de Convertmax con el nombre de la tabla y el intervalo.