> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AlloyDB

> Synchronisez les événements personnalisés depuis Google AlloyDB vers OneSignal pour déclencher des Journeys automatisés et des campagnes de messagerie personnalisées basées sur le comportement des utilisateurs.

export const DATA_TYPE_0 = "table columns"

export const PLATFORM_0 = "AlloyDB"

export const COLUMN_HEADER_0 = "AlloyDB Column"

export const PROPERTIES_DESCRIPTION_0 = "Event metadata as JSON object"

## 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](/docs/en/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](/docs/en/custom-events) pour la synchronisation des événements entrants (Les limitations de forfait et les dépassements s'appliquent)
* [Forfait de compte mis à jour](https://onesignal.com/pricing) (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.

<Steps>
  <Step title="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 :

    ```sql theme={null}
    -- Create the OneSignal user
    CREATE USER ONESIGNAL WITH PASSWORD '<strong, unique password>';
    ```
  </Step>

  <Step title="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 :

    ```sql theme={null}
    -- 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;
    ```

    <Info>
      Remplacez `<your_event_schema>` par le schéma réel contenant vos tables d'événements.
    </Info>
  </Step>

  <Step title="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 :

    ```sql theme={null}
    -- 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;
    ```
  </Step>
</Steps>

### Configurer Auth Proxy

<Steps>
  <Step title="Configurer Auth Proxy">
    AlloyDB nécessite un Auth Proxy pour les connexions tierces. Suivez la [documentation Auth Proxy de Google](https://cloud.google.com/alloydb/docs/auth-proxy/overview) pour configurer cela.

    <Warning>
      L'Auth Proxy est requis - OneSignal ne peut pas se connecter directement à AlloyDB sans lui.
    </Warning>
  </Step>

  <Step title="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
  </Step>
</Steps>

### Configurer la connexion OneSignal AlloyDB

<Steps>
  <Step title="Accéder aux intégrations">
    Dans OneSignal, allez dans **Data > Integrations** et cliquez sur **Add Integration**.
  </Step>

  <Step title="Sélectionner Google AlloyDB">
    Choisissez **Google AlloyDB** dans la liste des intégrations disponibles.
  </Step>

  <Step title="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é)
  </Step>

  <Step title="Tester la connexion">
    Cliquez sur **Tester la connexion** pour vérifier que OneSignal peut accéder à votre instance AlloyDB.
  </Step>
</Steps>

***

## 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 :

<Steps>
  <Step title="Sélectionner les tables d'événements">
    Choisissez les tables contenant vos données d'événements que vous souhaitez synchroniser avec OneSignal.
  </Step>

  <Step title="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)
  </Step>

  <Step title="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.)
  </Step>

  <Step title="Configurer les paramètres de synchronisation">
    Définissez votre fréquence de traitement des événements et vos préférences de livraison.
  </Step>
</Steps>

***

### Mappage des données d'événement

Mappez vos {DATA_TYPE_0} {PLATFORM_0} au format des événements personnalisés de OneSignal :

| Champ OneSignal | {COLUMN_HEADER_0} | 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`      | {PROPERTIES_DESCRIPTION_0}      | Non    |

***

## 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 :

<Steps>
  <Step title="Créer un utilisateur SSH">
    Créez un compte utilisateur dédié pour OneSignal sur votre serveur hôte SSH.
  </Step>

  <Step title="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
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

## 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.