
Aperçu de l'intégration OneSignal Snowflake
Aperçu
L’intégration OneSignal + Snowflake prend en charge deux pipelines de données puissants :- Exporter : Envoyez automatiquement les données d’événements de messagerie (push, email, SMS, in-app) depuis OneSignal vers Snowflake pour l’analyse et le reporting.
- Importer : Synchronisez les événements utilisateur personnalisés de vos ensembles de données Snowflake vers OneSignal pour déclencher des Journeys automatisés et une messagerie personnalisée.
Exporter les événements OneSignal vers Snowflake
Envoyez les événements de performance et d’engagement de messagerie (par exemple, envois, ouvertures, clics) vers Snowflake pour :- Créer des tableaux de bord et des rapports personnalisés
- Suivre les tendances de livraison et d’engagement sur tous les canaux
- Combiner les données OneSignal avec d’autres données métier pour l’analyse
- Plan Professional OneSignal (non disponible sur les applications gratuites).
- Compte Snowflake
- Assurez-vous que votre compte Snowflake dispose des rôles
IMPORT SHAREetCREATE DATABASE.- Nous recommandons d’utiliser le rôle
ACCOUNTADMINpour accepter le partage.
- Nous recommandons d’utiliser le rôle
1. S’inscrire
Pour activer l’intégration Snowflake, vous devrez demander l’accès via la liste OneSignal Marketplace pour les données d’événements de messages. De là, nous contacterons votre équipe pour obtenir plus d’informations.2. Fournir les informations du compte
Une fois que nous nous connectons avec votre équipe, vous devrez nous fournir quelques détails afin que nous puissions partager des données avec vous. Nous aurons besoin de votre ID de compte Snowflake et de votre ID d’organisation Snowflake. Le moyen le plus simple d’obtenir ces informations est de cliquer sur le bouton “Copier l’identifiant du compte” (comme indiqué ci-dessous).[email protected]
Copie de l'identifiant du compte Snowflake
- E-mail de OneSignal vous souhaitant la bienvenue dans le programme
- E-mail de Snowflake notifiant que le partage de données est terminé

E-mail de notification de partage de données Snowflake
3. Accepter le partage de données dans Snowflake
Une fois que vous recevez un e-mail de Snowflake vous informant que le partage de données est terminé, vous devriez pouvoir vous connecter à l’application Snowflake et accepter le partage de données. Accédez à Data → Private Sharing où vous devriez pouvoir voir une nouvelle liste partagée en privé. Une fois que vous cliquez sur Get, vos données commenceront à se répliquer dans votre région.
Interface de partage privé Snowflake
CREATE DATABASE ou IMPORT SHARE. Nous suggérons de passer au rôle ACCOUNTADMIN.
La réplication des données prendra un certain temps. Snowflake enverra un e-mail supplémentaire une fois les données disponibles. Vous devriez voir une boîte de dialogue qui ressemble à ceci

Boîte de dialogue de l'état de réplication des données

Boîte de dialogue de configuration de la base de données

Finalisation de la configuration du partage de données
Événements et propriétés
Un aperçu des données disponibles sur le Marketplace de SnowflakeDonnées d’événements de messages
Voir Event Streams pour plus de détails. Pour chaque événement de message généré par un utilisateur, les métadonnées suivantes seront attachées à l’enregistrement.| Nom de colonne | Type | Description | Exemple |
|---|---|---|---|
| event_id | UUID | Un ID unique qui représente l’événement | dc76df03-287c-403a-aabd-b2d4fe44e5c6 |
| event_kind | string | Le type d’événement qui s’est produit. La liste des types d’événements peut être trouvée ici. | message.email.opened |
| event_impression_timestamp | unix_timestamp | L’heure à laquelle OneSignal traite l’événement | 1684951205 |
| subscription_id | UUID | Un ID unique qui représente l’appareil/l’abonnement | 6e8b6978-75a4-4882-878c-2d15a78c2409 |
| subscription_language | string | La langue de cet abonnement | en |
| subscription_timezone | integer | Le fuseau horaire spécifié de cet abonnement | -25200 |
| subscription_device_type | string | Le type d’appareil que cet abonnement utilise. | SMS |
| onesignal_id | UUID | Le onesignal_id de l’utilisateur qui a fait l’impression | dc76df03-287c-403a-aabd-b2d4fe44e5c6 |
| external_id | string | Le external_id de l’utilisateur qui a fait l’impression | MyExternalId |
| message_id | UUID | Un ID unique qui représente le message | dc76df03-287c-403a-aabd-b2d4fe44e5c6 |
| message_name | string | L’ID lisible par l’homme de la Notification/Message | Campaign 1 |
| message_title | string | Le titre de la Notification/Message.Anglais uniquement pour le moment | Bonus 50 coins when you play! |
| message_body | string | Le corps du message. (Tronqué) Anglais uniquement pour le moment. | Play against your friends and earn an additional... |
Types d’événements de messages
Voir Event Streams pour plus de détails. Les événements de messages sont la première catégorie de données que nous offrirons sur le Marketplace de Snowflake. N’hésitez pas à nous contacter à[email protected] pour toute demande de catégories de données supplémentaires !
Rétention des données
Les données partagées depuis OneSignal via Snowflake sont conservées pendant une période de 30 jours. Pour assurer la préservation des données au-delà de ce délai, nous vous recommandons de copier les données pertinentes dans vos propres tables.Importer des événements depuis Snowflake
Envoyez les données d’événements comportementaux depuis Snowflake vers OneSignal pour :- Déclencher des Journeys basés sur l’activité utilisateur
- Personnaliser la messagerie basée sur les données comportementales
- 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)
- Compte Snowflake avec accès à l’entrepôt
- Données d’événements stockées dans des tables ou vues Snowflake
- Connectivité réseau depuis OneSignal vers votre instance Snowflake
- Identifiants utilisateur avec les autorisations appropriées
Créer un rôle dédié pour OneSignal
Créer un entrepôt dédié
Créer un utilisateur et accorder des autorisations
Créer une base de données de comptabilité (Moteur de synchronisation avancé)
Configurer l'authentification
- Générez une paire de clés publique/privée en suivant la documentation de Snowflake
- Configurez la clé publique sur votre utilisateur Snowflake
- Utilisez la clé privée dans les paramètres de connexion de OneSignal
Se connecter à OneSignal
- Nom de compte : Votre identifiant de compte Snowflake (par exemple,
abc123.us-east-1) - Entrepôt :
CENSUS_WAREHOUSE - Utilisateur :
CENSUS - Base de données : Le nom de votre base de données d’événements
- Schéma : Le nom de votre schéma de données d’événements
- Authentification : Paire de clés (fournissez la clé privée et la phrase secrète optionnelle)
Mappage des données d’événement
Mappez vos au format des événements personnalisés de OneSignal :| Champ OneSignal | Description | Requis | |
|---|---|---|---|
name | event_name | Identifiant de l’événement | Oui |
external_id | user_id | Identifiant de l’utilisateur | Oui |
timestamp | event_timestamp | Quand l’événement s’est produit | Non |
properties | event_data | Non |
Exemple de schéma de table d’événements
Mode de requête SQL
Écrivez des requêtes SQL personnalisées pour transformer vos données d’événements :Configuration avancée
Gestion des coûts de l’entrepôt
- Utilisez une taille d’entrepôt X-Small pour l’optimisation des coûts
- Configurez la suspension automatique (60 secondes) et la reprise automatique
- Planifiez les synchronisations pendant les heures creuses
- Envisagez de partager l’entrepôt avec d’autres systèmes de traitement par lots
Support des synchronisations en direct
Pour le traitement des événements en temps réel, activez le suivi des modifications sur vos tables d’événements :Sécurité réseau
Si vous utilisez la politique réseau des IP autorisées de Snowflake, ajoutez les adresses IP de OneSignal à votre liste d’autorisation. Contactez le support OneSignal pour les plages d’IP actuelles.Limitations
- Les requêtes analytiques complexes peuvent impacter les performances et les coûts de l’entrepôt
- L’authentification Utilisateur/Mot de passe sera obsolète en novembre 2025
- La base de données CENSUS est réservée aux opérations OneSignal uniquement
Déconnecter le partage de données avec OneSignal
Veuillez nous envoyer un e-mail à[email protected] pour demander la désactivation de votre partage de données avec OneSignal.
FAQ
Quelle méthode d’authentification dois-je utiliser ?
Utilisez l’authentification par paire de clés (recommandé). L’authentification Utilisateur/Mot de passe sera bloquée par Snowflake à partir de novembre 2025.Puis-je utiliser un entrepôt existant ?
Oui, vous pouvez partager un entrepôt avec d’autres systèmes de traitement par lots comme dbt ou Fivetran pour optimiser les coûts. Assurez-vous que l’entrepôt a une capacité suffisante pour vos besoins de traitement d’événements.Comment puis-je optimiser les coûts ?
- Utilisez une taille d’entrepôt X-Small
- Configurez une suspension automatique agressive (60 secondes)
- Planifiez les synchronisations pendant les heures creuses
- Utilisez des synchronisations horaires/quotidiennes au lieu d’une synchronisation continue