Passer au contenu principal

​
Aperçu

L’intégration OneSignal + SingleStore permet la synchronisation des événements personnalisés de votre base de données SingleStore vers OneSignal pour déclencher des campagnes de messagerie automatisées et des parcours basés sur le comportement des utilisateurs. SingleStore est une base de données SQL distribuée conçue pour l’analytique en temps réel et les applications haute performance.

​
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)

​
SingleStore

  • SingleStoreDB Cloud ou SingleStoreDB v7.1+
  • Utilisateur de base de données avec les permissions appropriées
  • Tables d’événements contenant des données comportementales structurées
  • Connectivité réseau de OneSignal vers votre cluster SingleStore

​
Configuration

1

Créer un utilisateur dédié pour OneSignal

Créez un compte utilisateur dédié avec un mot de passe fort et unique :
-- Create census user with the ability to sign in with a password
CREATE USER CENSUS IDENTIFIED BY '<strong-unique-password>';
2

Accorder les permissions aux données d'événements

Fournissez un accès en lecture seule aux schémas contenant vos données d’événements :
-- Grant read-only access to schema with event data
GRANT SELECT ON analytics.* TO CENSUS;

-- Repeat for additional schemas if needed
GRANT SELECT ON events.* TO CENSUS;
Si vous avez plusieurs schémas contenant des données d’événements, répétez l’instruction GRANT SELECT pour chaque schéma.
3

Se connecter à OneSignal

Dans OneSignal, allez dans Data > Integrations et cliquez sur Add Integration.Sélectionnez SingleStore et fournissez les détails de connexion suivants :
  • Host: Votre point de terminaison de cluster SingleStore
  • Port: 3306 (par défaut)
  • Database: Votre nom de base de données
  • Username: CENSUS
  • Password: Le mot de passe 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

-- Example SingleStore event table
CREATE TABLE analytics.user_events (
    event_id BIGINT AUTO_INCREMENT PRIMARY KEY,
    event_name VARCHAR(100) NOT NULL,
    user_id VARCHAR(255) NOT NULL,
    event_timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    event_data JSON,
    session_id VARCHAR(255),
    device_type VARCHAR(50)
);

​
Mode de requête SQL

Écrivez des requêtes SQL personnalisées pour transformer vos données d’événements : 
-- Example: Recent high-value events
SELECT
    event_name,
    user_id,
    event_timestamp,
    event_data
FROM analytics.user_events
WHERE event_timestamp >= DATE_SUB(NOW(), INTERVAL 7 DAY)
    AND JSON_EXTRACT_STRING(event_data, 'value') > '100'
ORDER BY event_timestamp DESC;

​
Configuration réseau avancée

OneSignal peut se connecter avec succès aux instances SingleStore qui utilisent des contrôles de réseau avancés, notamment des contraintes de région et des listes d’autorisation d’adresses IP. Pour plus d’informations sur la configuration de l’accès réseau, contactez votre administrateur SingleStore ou le support OneSignal.

​
Limitations

  • Les requêtes d’analytique en temps réel peuvent impacter les performances du cluster pendant les périodes de trafic élevé
  • Les opérations JSON doivent être optimisées pour l’exécution distribuée

​
FAQ

​
Puis-je me connecter à plusieurs schémas SingleStore ?

Oui, vous pouvez accorder à l’utilisateur CENSUS l’accès à plusieurs schémas en exécutant l’instruction GRANT SELECT pour chaque schéma contenant des données d’événements.

​
OneSignal prend-il en charge SingleStore Cloud ?

Oui, OneSignal prend en charge à la fois SingleStoreDB Cloud et les installations SingleStoreDB v7.1+ sur site.