Passer au contenu principal

Vue d’ensemble

L’intégration OneSignal + MotherDuck permet la synchronisation automatique des événements personnalisés depuis vos bases de données MotherDuck vers OneSignal pour déclencher des campagnes de messagerie automatisées et des parcours basés sur le comportement des utilisateurs. MotherDuck est un service DuckDB dans le cloud qui offre des capacités OLAP (Traitement analytique en ligne) rapides avec la simplicité du SQL.

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)

MotherDuck

  • Compte MotherDuck avec accès à la base de données
  • Token de service pour l’authentification
  • Base de données contenant les données d’événement
  • Tables ou vues avec des informations d’événement structurées

Configuration

1

Créer un token de service MotherDuck

Générez un token d’accès pour permettre à OneSignal de se connecter à MotherDuck :
  1. Connectez-vous à l’interface web MotherDuck sur app.motherduck.com
  2. Cliquez sur votre profil dans le coin supérieur gauche
  3. Naviguez vers Paramètres > Général > Tokens d’accès
  4. Cliquez sur Créer un token
  5. Définissez la date d’expiration (ou laissez illimité)
  6. Copiez le token de service généré
2

Préparer vos données d'événement

Assurez-vous que votre base de données MotherDuck contient des tables d’événements correctement structurées :
3

Se connecter à OneSignal

Dans OneSignal, allez dans Data > Integrations et cliquez sur Add Integration.Sélectionnez MotherDuck et fournissez :
  • Token de service : Token de l’étape 1
  • Nom de la base de données : Le nom de votre base de données MotherDuck
  • Chaîne de connexion : md:votre_nom_de_base_de_données
4

Configurer la synchronisation des données

Sélectionnez les tables ou rédigez des requêtes SQL personnalisées pour définir quelles données d’événement synchroniser :

Mappage des données d’événement

Mappez vos au format des événements personnalisés de OneSignal :

Exemple de requête d’événement


Modes de traitement

Mode table

Synchronisez des tables entières directement depuis votre base de données MotherDuck. OneSignal mappera automatiquement les colonnes aux champs d’événement.

Mode requête SQL

Rédigez des requêtes SQL DuckDB personnalisées pour transformer et filtrer vos données d’événement :

Limitations

  • La complexité des requêtes affecte les performances de synchronisation
  • Les grands ensembles de résultats peuvent impacter la vitesse de synchronisation
  • L’analyse JSON nécessite un typage de colonne approprié

FAQ

Comment optimiser les performances des requêtes dans MotherDuck ?

Utilisez les avantages du stockage en colonnes de DuckDB en sélectionnant uniquement les colonnes nécessaires et en appliquant les filtres tôt dans vos requêtes.

Puis-je synchroniser depuis plusieurs bases de données MotherDuck ?

Oui, vous pouvez créer des intégrations distinctes pour chaque base de données MotherDuck dans votre compte.