Passer au contenu principal

​
Aperçu

L’intégration OneSignal + Google AlloyDB permet la synchronisation automatique des événements personnalisés depuis votre base de données AlloyDB directement vers l’API d’événements personnalisés de OneSignal. Cela vous permet de déclencher des Journeys automatisés et des campagnes de messagerie personnalisées basées sur le comportement réel des utilisateurs stocké dans votre base de données. Vous pouvez synchroniser des événements tels que des achats, des vues de produits, des changements d’abonnement ou toute action utilisateur personnalisée pour déclencher automatiquement des séquences d’intégration, des campagnes de réengagement, des messages transactionnels et des promotions ciblées sur les notifications push, les e-mails, les messages in-app et les SMS.

​
Exigences

  • 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 AlloyDB

  • Compte Google Cloud Platform avec instance AlloyDB
  • Auth Proxy configuré selon les exigences de Google Cloud
  • Permissions de base de données pour créer des utilisateurs et accorder l’accès
  • Accès réseau à votre instance AlloyDB

​
Configuration

​
Configurer les permissions AlloyDB

OneSignal doit lire les données d’événements depuis votre base de données AlloyDB. Nous recommandons de créer un compte utilisateur dédié ONESIGNAL avec un accès en lecture seule à vos tables d’événements.
1

Créer un utilisateur de base de données OneSignal

Créez un compte utilisateur dédié avec un mot de passe fort et unique :
-- Create the OneSignal user
CREATE USER ONESIGNAL WITH PASSWORD '<strong, unique password>';
2

Accorder l'accès au schéma

Accordez à l’utilisateur OneSignal l’accès en lecture à votre schéma de données d’événements :
-- Let the OneSignal user see your event schema
GRANT USAGE ON SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- Let the OneSignal user read all existing tables in this schema
GRANT SELECT ON ALL TABLES IN SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- Let the OneSignal user read any new tables added to this schema
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_event_schema>" GRANT SELECT ON TABLES TO ONESIGNAL;
Remplacez <your_event_schema> par le schéma réel contenant vos tables d’événements.
3

Accorder les permissions de fonction (si nécessaire)

Si vous utilisez des procédures stockées ou des fonctions pour les données d’événements :
-- Let the OneSignal user execute functions in this schema
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- Let the OneSignal user execute any new functions added to this schema
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_event_schema>" GRANT EXECUTE ON FUNCTIONS TO ONESIGNAL;

​
Configurer Auth Proxy

1

Configurer Auth Proxy

AlloyDB nécessite un Auth Proxy pour les connexions tierces. Suivez la documentation Auth Proxy de Google pour configurer cela.
L’Auth Proxy est requis - OneSignal ne peut pas se connecter directement à AlloyDB sans lui.
2

Noter les détails de connexion

Enregistrez les informations de connexion suivantes :
  • Hôte : Point de terminaison Auth Proxy
  • Port : Port Auth Proxy (généralement 5432)
  • Base de données : Nom de votre base de données AlloyDB
  • Nom d’utilisateur : ONESIGNAL (créé ci-dessus)
  • Mot de passe : Le mot de passe que vous avez défini

​
Configurer la connexion OneSignal AlloyDB

1

Accéder aux intégrations

Dans OneSignal, allez dans Data > Integrations et cliquez sur Add Integration.
2

Sélectionner Google AlloyDB

Choisissez Google AlloyDB dans la liste des intégrations disponibles.
3

Saisir les détails de connexion

Fournissez les informations de connexion AlloyDB :
  • Hôte : Votre point de terminaison Auth Proxy
  • Port : Port Auth Proxy
  • Base de données : Nom de la base de données AlloyDB
  • Nom d’utilisateur : ONESIGNAL
  • Mot de passe : Mot de passe utilisateur
  • SSL : Activé (recommandé)
4

Tester la connexion

Cliquez sur Tester la connexion pour vérifier que OneSignal peut accéder à votre instance AlloyDB.

​
Mappage des données d’événements

Une fois connecté, vous devrez mapper les colonnes de votre table AlloyDB aux champs d’événements personnalisés OneSignal :
1

Sélectionner les tables d'événements

Choisissez les tables contenant vos données d’événements que vous souhaitez synchroniser avec OneSignal.
2

Mapper les champs d'événements requis

Mappez les champs requis pour les événements personnalisés :
  • Nom de l’événement : Colonne contenant le type d’événement (par exemple, “purchase”, “signup”)
  • Identifiant utilisateur : Colonne ID utilisateur externe, e-mail ou numéro de téléphone
  • Horodatage de l’événement : Quand l’événement s’est produit (optionnel)
3

Mapper les données de charge utile d'événement

Mappez les colonnes supplémentaires aux propriétés de charge utile d’événement :
  • Propriétés d’événements personnalisés (product_id, price, category, etc.)
  • Données contextuelles (source, campaign, etc.)
  • Métriques comportementales (value, quantity, etc.)
4

Configurer les paramètres de synchronisation

Définissez votre fréquence de traitement des événements et vos préférences de livraison.

​
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 réseau avancée

​
Listes d’adresses IP autorisées

Si votre instance AlloyDB utilise des listes d’adresses IP autorisées, ajoutez les adresses IP de OneSignal. Vous pouvez trouver les plages IP actuelles dans votre tableau de bord OneSignal sous Données > Intégrations > Accès réseau.

​
Tunnelisation SSH

OneSignal prend en charge la connexion à AlloyDB via des tunnels SSH pour une sécurité supplémentaire :
1

Créer un utilisateur SSH

Créez un compte utilisateur dédié pour OneSignal sur votre serveur hôte SSH.
2

Configurer le tunnel SSH

Dans les paramètres de connexion OneSignal AlloyDB, activez Utiliser un tunnel SSH et fournissez :
  • Hôte SSH
  • Port SSH
  • Nom d’utilisateur SSH
3

Ajouter une clé SSH

OneSignal générera une paire de clés SSH. Copiez la clé publique dans le fichier authorized_keys de votre hôte SSH pour l’utilisateur OneSignal.

​
Limitations

  • Performance : Évitez de vous connecter aux bases de données de production pendant les heures de pointe
  • Permissions : OneSignal nécessite un accès en lecture seule aux tables d’événements
  • Auth Proxy : Requis pour toutes les connexions AlloyDB

​
FAQ

​
Que se passe-t-il si la structure de ma table d’événements change ?

OneSignal détectera les changements de schéma et pourra nécessiter un remappage des champs. Mettez à jour vos mappages de champs dans les paramètres d’intégration.

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

OneSignal vérifie les nouveaux événements en fonction de votre fréquence de synchronisation configurée, avec un intervalle minimum de 15 minutes.

​
Besoin d’aide ?

Contactez notre équipe de support à support@onesignal.com ou utilisez le chat dans l’application pour obtenir de l’aide avec votre configuration d’intégration AlloyDB.