
Aperçu de l'intégration OneSignal Snowflake
Aperçu
L’intégration OneSignal + Snowflake prend en charge deux pipelines de données puissants :- Export : Envoyez automatiquement les données d’événements de messagerie (push, e-mail, SMS, in-app) de OneSignal vers Snowflake pour l’analyse et les rapports.
- Import : Synchronisez les événements utilisateur personnalisés depuis 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 commerciales pour l’analyse
- OneSignal Forfait professionnel (non disponible sur les applications gratuites).
- Compte Snowflake
- Assurez-vous que votre compte Snowflake possède les 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 message. De là, nous contacterons votre équipe pour obtenir plus d’informations.2. Fournir les informations de 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. La façon la plus simple d’obtenir ces informations est de cliquer sur le bouton “Copier l’identifiant de compte” (comme indiqué ci-dessous).snowflake-data-sharing@onesignal.com
Copie de l'identifiant de 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. Naviguez vers Données → Partage privé où vous devriez pouvoir voir une nouvelle liste partagée privée. Une fois que vous cliquez sur Obtenir, 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.
Il faudra un certain temps pour que les données soient répliquées. Snowflake vous 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 statut de réplication des données

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

Achèvement 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 message
Consultez 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 | chaîne | 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/abonnement | 6e8b6978-75a4-4882-878c-2d15a78c2409 |
| subscription_language | chaîne | La langue de cet abonnement | en |
| subscription_timezone | entier | Le fuseau horaire spécifié de cet abonnement | -25200 |
| subscription_device_type | chaîne | Le type d’appareil utilisé par cet abonnement. | SMS |
| onesignal_id | UUID | L’onesignal_id de l’utilisateur qui a fait l’impression | dc76df03-287c-403a-aabd-b2d4fe44e5c6 |
| external_id | chaîne | L’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 | chaîne | L’ID lisible de la Notification/Message | Campaign 1 |
| message_title | chaîne | Le titre de la Notification/Message.Anglais uniquement pour le moment | Bonus 50 coins when you play! |
| message_body | chaîne | Le corps du message. (Tronqué) Anglais uniquement pour le moment. | Play against your friends and earn an additional... |
Types d’événements de message
Consultez Event Streams pour plus de détails. Les événements de message sont la première catégorie de données que nous offrirons sur le Marketplace de Snowflake. Veuillez nous contacter àsnowflake-data-sharing@onesignal.com 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 garantir 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 des données d’événements comportementaux depuis Snowflake vers OneSignal pour :- Déclencher des Journeys basés sur l’activité des utilisateurs
- Personnaliser la messagerie en fonction des 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 de 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 de passe 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 d’entrepôt
- Utilisez la 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
Prise en charge des synchronisations en direct
Pour le traitement d’é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 IP actuelles.Limitations
- Les requêtes analytiques complexes peuvent impacter les performances de l’entrepôt et les coûts
- L’authentification utilisateur/mot de passe sera dépréciée 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 àsnowflake-data-sharing@onesignal.com 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 dispose d’une capacité suffisante pour vos besoins de traitement d’événements.Comment puis-je optimiser les coûts ?
- Utilisez la 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