Passer au contenu principal

​
Vue d’ensemble

L’intégration OneSignal + Microsoft Fabric permet la synchronisation automatique des événements personnalisés depuis votre lakehouse ou entrepôt Fabric vers OneSignal pour déclencher des campagnes de messagerie automatisées et des parcours basés sur le comportement des utilisateurs. Microsoft Fabric est une plateforme d’analytique unifiée qui rassemble l’ingénierie des données, la science des données, l’analytique en temps réel et l’intelligence d’affaires dans un environnement unique.

​
Prérequis

  • Accès aux Event Streams pour les événements de message sortants (Les limitations de forfait et les dépassements s’appliquent)
  • Accès aux Événements personnalisés pour la synchronisation des événements entrants (Les limitations de forfait et les dépassements s’appliquent)
  • Forfait de compte mis à jour (non disponible sur les applications gratuites)

​
Microsoft Fabric

  • Capacité Microsoft Fabric avec accès à l’espace de travail
  • Principal de service avec les permissions appropriées
  • Point de terminaison SQL (Entrepôt ou Lakehouse) contenant les données d’événement
  • Accès à l’API externe activé dans les paramètres du locataire

​
Configuration

1

Créer un principal de service dans Azure

Créez un nouveau principal de service pour permettre à OneSignal d’accéder à vos ressources Fabric :
  1. Connectez-vous au portail Azure
  2. Naviguez vers Microsoft Entra ID > Inscriptions d’applications
  3. Cliquez sur + Nouvelle inscription
  4. Entrez le nom : “OneSignal Fabric Integration”
  5. Sélectionnez Comptes dans cet annuaire organisationnel uniquement
  6. Cliquez sur Inscrire
  7. Notez l’ID d’application (client) et l’ID d’annuaire (locataire)
  8. Sous Certificats et secrets, créez un nouveau secret client
  9. Notez la valeur du secret client
2

Configurer les paramètres du locataire Fabric

Activez l’accès externe pour les principaux de service :
  1. Dans Microsoft Fabric, cliquez sur Paramètres > Portail d’administration
  2. Allez dans Paramètres du locataire
  3. Sous Paramètres développeur, activez Les principaux de service peuvent utiliser les API Fabric
  4. Sous Paramètres OneLake, activez Les utilisateurs peuvent accéder aux données stockées dans OneLake avec des applications externes à Fabric
3

Accorder l'accès à l'espace de travail

Ajoutez le principal de service à votre espace de travail Fabric :
  1. Naviguez vers votre espace de travail (créez un espace de travail partagé si vous utilisez “Mon espace de travail”)
  2. Cliquez sur Gérer l’accès > + Ajouter des personnes ou des groupes
  3. Sélectionnez votre principal de service
  4. Définissez le rôle sur Contributeur
4

Obtenir le point de terminaison SQL

Obtenez la chaîne de connexion SQL pour votre source de données :
  1. Dans votre espace de travail, survolez votre entrepôt/lakehouse
  2. Cliquez sur … > Paramètres
  3. Copiez la chaîne de connexion SQL (c’est votre nom d’hôte)
5

Se connecter à OneSignal

Dans OneSignal, allez dans Data > Integrations et cliquez sur Add Integration.Sélectionnez Microsoft Fabric et fournissez :
  • Nom d’hôte : Point de terminaison SQL de l’étape 4
  • Base de données/Catalogue : Le nom de votre lakehouse ou entrepôt
  • ID du locataire : ID d’annuaire de l’étape 1
  • ID client : ID d’application de l’étape 1
  • Secret client : Valeur du secret de l’étape 1

​
Mappage des données d’événement

Mappez vos au format des événements personnalisés de OneSignal :
Champ OneSignalDescriptionRequis
nameevent_nameIdentifiant de l’événementOui
external_iduser_idIdentifiant de l’utilisateurOui
timestampevent_timestampQuand l’événement s’est produitNon
propertiesevent_dataNon

​
Exemple de schéma de table d’événements

-- Exemple de structure de table Fabric
CREATE TABLE user_events (
    event_name STRING,
    user_id STRING,
    event_time TIMESTAMP,
    properties JSON,
    session_id STRING,
    device_type STRING
);

​
Modes de traitement

​
Mode requête SQL

Rédigez des requêtes SQL personnalisées pour transformer vos données Fabric avant la synchronisation : 
SELECT
    event_name,
    user_id,
    event_time,
    TO_JSON(STRUCT(
        session_id,
        device_type,
        product_id
    )) as properties
FROM user_events
WHERE event_time >= CURRENT_DATE - INTERVAL 7 DAYS

​
Mode table

Synchronisez des tables ou des vues entières directement depuis votre espace de travail Fabric. OneSignal mappera automatiquement les colonnes aux champs d’événement.

​
Limitations

  • Nécessite une capacité Fabric (non disponible en version d’essai)
  • Les points de terminaison SQL doivent être accessibles aux services externes
  • Les grands ensembles de résultats peuvent affecter les performances de synchronisation

​
FAQ

​
Comment optimiser les performances des requêtes ?

Utilisez le partitionnement et l’indexation dans vos tables Fabric. Envisagez de créer des vues matérialisées pour les données d’événement fréquemment consultées.

​
Puis-je synchroniser à partir de lakehouses et d’entrepôts ?

Oui, OneSignal prend en charge toute ressource Fabric qui expose un point de terminaison SQL, y compris les lakehouses, les entrepôts et les points de terminaison d’analytique SQL.