Passer au contenu principal

​
Aperçu

L’intégration OneSignal + Google Sheets permet la synchronisation automatique des événements personnalisés de vos Google Sheets vers OneSignal. Cela vous permet de déclencher des Journeys automatisés et des campagnes de messagerie personnalisées basées sur les données comportementales des utilisateurs stockées dans vos feuilles de calcul, parfait pour les équipes qui gèrent les données d’événements de manière collaborative.

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

​
Google Sheets

  • Compte Google avec accès à la feuille contenant les données d’événements
  • Feuille de calcul d’événements avec une structure de colonnes appropriée pour les données d’événements
  • Autorisations de partage de feuille pour que OneSignal puisse accéder aux données
  • Format de données cohérent dans votre feuille de suivi des événements

​
Configuration

1

Préparer votre feuille de données d'événements

Structurez votre Google Sheet avec les colonnes requises pour les données d’événements :Colonnes requises :
  • event_name ou event_type : Le nom de l’événement (Chaîne)
  • user_id ou email : Identifiant utilisateur (Chaîne)
  • timestamp ou created_at : Horodatage de l’événement (Date/DateTime)
  • properties : Propriétés de l’événement au format JSON ou colonnes séparées (Optionnel)
Exemple de structure de feuille :
| event_name | user_id | timestamp           | product_id | amount |
|------------|---------|---------------------|------------|--------|
| purchase   | user123 | 2024-01-15 10:30:00 | prod_abc   | 29.99  |
| signup     | user456 | 2024-01-15 11:45:00 |            |        |
2

Configurer les autorisations de la feuille

Partagez votre Google Sheet avec le compte de service de OneSignal :
  1. Ouvrez votre Google Sheet
  2. Cliquez sur le bouton Partager en haut à droite
  3. Ajoutez l’adresse e-mail du compte de service OneSignal (fournie lors de la configuration)
  4. Définissez les autorisations sur Lecteur (accès en lecture seule)
  5. Cliquez sur Envoyer pour accorder l’accès
OneSignal fournira l’adresse e-mail spécifique du compte de service pendant le processus de configuration de l’intégration.
3

Ajouter l'intégration dans OneSignal

Dans OneSignal, allez dans Data > Integrations et cliquez sur Add Integration.Sélectionnez Google Sheets et fournissez :
  • URL de la feuille : L’URL complète de votre Google Sheet
  • Nom de la feuille : Le nom spécifique de l’onglet/feuille contenant les données d’événements
  • Ligne d’en-tête : Numéro de ligne contenant les en-têtes de colonnes (généralement 1)
  • Plage de données : Plage de cellules contenant vos données d’événements (par ex., A2:F1000)
4

Configurer le mappage des colonnes

Mappez vos colonnes Google Sheets aux champs d’événements OneSignal :
  • Colonne du nom de l’événement : Sélectionnez la colonne contenant les noms d’événements
  • Colonne de l’ID utilisateur : Sélectionnez la colonne avec les identifiants utilisateurs
  • Colonne de l’horodatage : Sélectionnez la colonne avec les horodatages d’événements
  • Colonnes de propriétés : Sélectionnez les colonnes supplémentaires à inclure comme propriétés d’événements
Vous pouvez mapper plusieurs colonnes comme propriétés d’événements. OneSignal les combinera en une seule charge utile d’événement.
5

Définir le calendrier de synchronisation

Configurez la fréquence à laquelle OneSignal doit vérifier les nouvelles données d’événements :
  • Fréquence de synchronisation : Choisissez parmi 15 minutes, horaire ou quotidien
  • Synchronisation incrémentielle : Activez pour synchroniser uniquement les nouvelles lignes depuis la dernière mise à jour
  • Filtre d’horodatage : Synchronisez uniquement les événements dans une plage de temps spécifique
Google Sheets a des limites de débit d’API. Une synchronisation plus fréquente peut être limitée pour les feuilles avec des jeux de données volumineux.
6

Tester la connexion

Cliquez sur Test Connection pour vérifier que OneSignal peut accéder à votre Google Sheet et lire correctement les données d’événements.

​
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

​
Configuration avancée

​
Configuration de la synchronisation incrémentielle

Configurez la synchronisation incrémentielle pour ne traiter que les nouveaux événements :
  1. Colonne d’horodatage : Assurez-vous que votre feuille dispose d’une colonne d’horodatage cohérente
  2. Ordre de tri : Conservez les événements triés par horodatage (les plus récents en dernier)
  3. Ajout uniquement : Ajoutez de nouveaux événements en bas de votre feuille
  4. Éviter les modifications : Ne modifiez pas les lignes d’événements historiques après leur synchronisation

​
Validation des données

Implémentez la validation des données dans votre Google Sheet : 
Data > Data validation
- Event Name: List from range (predefined event types)
- User ID: Custom formula to check format
- Timestamp: Date/Time format validation
- Amount: Number validation for numeric properties

​
Flux de travail collaboratifs

Meilleures pratiques pour la collaboration en équipe :
  • Plages nommées : Utilisez des plages nommées pour les sections de données d’événements
  • Plages protégées : Protégez les lignes d’en-tête contre les modifications accidentelles
  • Commentaires : Ajoutez des commentaires pour expliquer les définitions d’événements
  • Historique des versions : Utilisez l’historique des versions de Google Sheets pour suivre les modifications
  • Contrôles d’accès : Limitez l’accès en modification aux membres de l’équipe de saisie de données

​
Optimisation des performances

Optimisez pour les grands ensembles de données :
  • Limites de feuille : Conservez les feuilles individuelles sous 10 000 lignes pour de meilleures performances
  • Feuilles multiples : Utilisez des feuilles séparées pour différents types d’événements
  • Archivage des données : Archivez mensuellement les anciennes données vers des feuilles séparées
  • Formules : Minimisez les formules complexes dans les plages de données d’événements
Google Sheets fonctionne mieux avec moins de 50 000 cellules au total. Pour le suivi d’événements à volume élevé, envisagez plutôt d’utiliser une source de base de données.

​
FAQ

​
À quelle fréquence OneSignal synchronise-t-il les événements depuis Google Sheets ?

OneSignal peut se synchroniser aussi fréquemment que toutes les 15 minutes, mais nous recommandons une synchronisation horaire ou quotidienne pour la plupart des cas d’utilisation afin de respecter les limites d’API de Google.

​
Plusieurs membres de l’équipe peuvent-ils ajouter des événements à la même feuille ?

Oui, Google Sheets prend en charge la collaboration en temps réel. Cependant, assurez-vous que les membres de l’équipe comprennent le format de données requis et la structure des colonnes.

​
Que se passe-t-il si quelqu’un modifie les données d’événements historiques ?

OneSignal se synchronise en fonction des horodatages et des positions des lignes. La modification des données historiques peut entraîner des événements en double ou des incohérences de données. Nous recommandons des flux de travail en ajout uniquement.