ConvertmaxDocumentation
Parler avec nousCommencer
Intégrations

Microsoft Fabric

Publiez les jeux de données reporting Convertmax dans une base Open Mirrored Microsoft Fabric pour SQL et Power BI, avec configuration et validation.

Copier la page
Open in ChatGPTOuvrir avec le contexte de la pageOpen in ClaudeOuvrir avec le contexte de la page

La synchronisation Fabric Convertmax publie les mêmes jeux de données reporting que BigQuery dans une base Open Mirrored Microsoft Fabric que vous possédez. Convertmax écrit des fichiers Parquet dans la zone d’atterrissage OneLake ; Fabric les réplique en tables Delta pour l’analytique SQL et Power BI.

Il s’agit d’un export entrepôt. Il est distinct d’une éventuelle connexion Microsoft Fabric OAuth utilisée pour parcourir les espaces de travail. La synchronisation utilise une application Entra dédiée (écrivain) et un secret client — pas ce jeton OAuth.

Utilisez ce guide lorsque la synchronisation Data Warehouse est activée pour votre organisation.

Données synchronisées

Six tables, alignées sur le contrat reporting BigQuery :

Table Contenu
visits Faits de session et de page, UTM, appareil et signaux agentiques
acquisition_events Événements d’acquisition et de touch
conversion_events Conversions et revenu
custom_events Événements tracker personnalisés nommés
click_events Événements de clic
daily_searches Lignes agrégées de recherche et de découverte

Chaque ligne inclut aussi :

  • _source_id — identité stable de la ligne reporting source
  • __rowMarker__ — marqueur d’upsert Open Mirroring

Clé primaire pour le mirroring : (tenant_id, time, _source_id)

Les lignes renvoyées avec la même clé sont mises à jour sur place. Elles ne créent pas de doublons.

Quand un site peut exporter

Un site n’est exporté que si toutes les conditions suivantes sont vraies :

  1. L’add-on Data Warehouse Sync est actif pour l’organisation du site
  2. Une destination Fabric est configurée (ID d’annuaire Entra, ID d’application écrivain, ID d’espace de travail, ID de base en mirroring, secret client écrivain)
  3. L’export est activé dans Integrations → Data Warehouse

Une base Open Mirrored ne peut être assignée qu’à un site Convertmax.

Authentification

Convertmax écrit dans votre zone d’atterrissage OneLake avec une application Microsoft Entra (principal de service) et un secret client.

Créez ou désignez une application écrivain dans votre annuaire Entra, accordez-lui l’autorisation d’écrire dans l’espace de travail Fabric qui possède la base en mirroring, et fournissez :

  • l’ID d’annuaire (locataire) Microsoft Entra
  • l’ID d’application (client)
  • le secret client
  • l’ID d’espace de travail Fabric
  • l’ID de la base Open Mirrored

Stockez et partagez le secret uniquement via les canaux approuvés par votre équipe sécurité. Une fois enregistré dans Convertmax, le secret n’est plus affiché dans l’interface.

Préparer la destination Fabric

Dans Microsoft Fabric :

  1. Confirmez un espace de travail avec capacité Fabric.
  2. Créez une base Open Mirrored (zone d’atterrissage OneLake dans laquelle Convertmax publiera).
  3. Accordez à l’application écrivain l’accès à cet espace de travail pour qu’elle puisse déposer des fichiers dans la zone d’atterrissage.

Convertmax ne crée pas la base en mirroring à votre place. Elle doit exister avant d’activer l’export.

Configuration dans Convertmax

Lorsque la synchronisation Data Warehouse est activée :

  1. Ouvrez Integrations → Data Warehouse → Microsoft Fabric.
  2. Saisissez l’ID d’annuaire, l’ID d’application écrivain, l’ID d’espace de travail et l’ID de base en mirroring.
  3. Collez le secret client écrivain.
  4. Activez l’export (On).

Si Microsoft Fabric n’apparaît pas, l’add-on peut ne pas être activé pour votre organisation — contactez le support Convertmax.

Changer d’espace de travail ou de base en mirroring relance un rattrapage. Convertmax ne supprime pas les fichiers de l’ancienne destination.

Fonctionnement de la synchronisation

Selon un calendrier (et lorsqu’une synchronisation est lancée pour votre espace), Convertmax :

  1. Lit les lignes reporting du site éligible.
  2. Écrit des lots Parquet compressés Snappy dans la zone d’atterrissage Fabric de ce site, avec les clés d’upsert.
  3. Laisse Fabric répliquer ces fichiers dans les six tables en mirroring.

Premier passage : rattrapage de l’historique disponible. Passages suivants : incrémental, avec une relecture de 48 heures pour renvoyer les mises à jour tardives de cette fenêtre sous forme d’upserts.

Les tables vides reçoivent tout de même un fichier Parquet typé à zéro ligne, pour que le schéma puisse apparaître dans Fabric avant les données.

Dans Convertmax, Files published (et l’horodatage) signifie que les fichiers sont arrivés dans OneLake. Cela ne signifie pas que Fabric a terminé la réplication. Confirmez la réplication dans Fabric.

Comportement des données

Comportement Attendu
Upserts Une nouvelle livraison met à jour les lignes de même clé ; elle n’ajoute pas de doublons
Fenêtre de relecture 48 heures pour couvrir les mises à jour tardives
Resynchronisation complète Rejoue les lignes source disponibles en upsert — ne tronque pas les tables de destination
Suppressions Les suppressions source ne sont pas propagées
Tables vides Le schéma peut apparaître avant toute ligne
Changement de destination Un nouvel espace de travail ou une nouvelle base réinitialise la progression et relance un rattrapage ; l’ancienne destination n’est pas nettoyée

Ne traitez pas cette version comme du change-data-capture exact.

Valider l’export

Après la configuration et la première publication réussie :

  1. Dans Fabric, confirmez que des fichiers apparaissent dans la zone d’atterrissage et que la réplication tourne.
  2. En SQL Fabric sur la base en mirroring, confirmez que les six tables existent et que les volumes sont cohérents :
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. Comparez les volumes et le revenu au reporting Convertmax pour le même site et la même plage de temps.
  2. Après une synchronisation ultérieure, confirmez que les clés inchangées n’augmentent pas les comptes.

Laissez le temps à Fabric de répliquer après que Convertmax affiche Files published.

Dépannage

Microsoft Fabric n’apparaît pas dans Integrations

Confirmez que Data Warehouse Sync est activé pour votre organisation, puis contactez le support Convertmax avec le nom de votre espace.

Enregistré dans l’app mais aucun fichier dans OneLake

Vérifiez l’ID d’annuaire Entra, l’ID d’application, l’ID d’espace de travail et l’ID de base en mirroring, que l’export est On, et que l’application écrivain peut écrire dans l’espace de travail. Puis contactez le support Convertmax avec le nom de votre espace et l’heure approximative de la configuration.

Fichiers publiés, mais tables vides ou obsolètes dans Fabric

Convertmax a déposé les fichiers ; Fabric peut encore répliquer. Vérifiez l’état de réplication de la base en mirroring dans Fabric. Si la réplication est saine et que les tables restent vides, contactez le support Convertmax.

Erreurs d’autorisation ou de secret

Confirmez :

  • que l’application écrivain est dans le bon annuaire Entra
  • que le secret client est à jour (il n’est plus affiché après enregistrement — faites une rotation et ressaisissez-le si besoin)
  • que l’application a accès à l’espace de travail Fabric et à la base Open Mirrored

Les volumes augmentent pour la même période

Les clés de ligne doivent faire un upsert. Si les comptes gonflent après une resynchronisation, confirmez que vous interrogez les tables en mirroring (pas les fichiers bruts de la zone d’atterrissage) et contactez le support Convertmax avec le nom de la table et la plage de temps.