Segments externes

Les segments externes vous permettent de cibler des personnes déjà stockées dans votre propre base de données, comme votre CRM ou votre entrepôt de données, au lieu de les exporter vers un fichier CSV et de le télécharger à nouveau chaque fois que la liste change. Vous fournissez à Pushwoosh une requête SQL qui renvoie les bons ID utilisateur, et Pushwoosh continue de réexécuter cette requête pour maintenir le segment à jour. Une fois configuré, vous pouvez utiliser ces utilisateurs de la même manière que n’importe quel autre segment.

Aide d'un développeur requise

Vous aurez besoin de l’aide de votre développeur ou de votre administrateur de base de données pour configurer la connexion. Partagez ce guide avec eux pour commencer.

La configuration d’une connexion touche votre base de données de production. Avant de commencer, demandez à votre développeur ou administrateur de base de données de :

• Préparer un utilisateur en lecture seule (ou, pour BigQuery, un compte de service en lecture seule)
• Confirmer la requête que vous prévoyez d’utiliser
• Si la base de données est derrière un pare-feu, demandez au support Pushwoosh quelles adresses IP autoriser

Créer un segment externe

Nommer le segment et choisir la base de données

1. Allez dans Audience → Segments Externes.
2. Cliquez sur Créer un segment externe.

3. Saisissez un Nom pour le segment (jusqu’à 100 caractères).
4. Choisissez le Type de base de données : PostgreSQL, MySQL, Google BigQuery, ou Microsoft SQL Server / Fabric.

Remplir les champs de connexion

PostgreSQL et MySQL

Pour PostgreSQL et MySQL, remplissez :

• Hôte et Port : l’adresse de votre serveur de base de données. Pushwoosh requiert un hôte accessible publiquement et rejette les adresses privées, internes ou de bouclage lorsque vous vérifiez la connexion ou enregistrez le segment.
• Base de données : le nom de la base de données.
• Utilisateur et Mot de passe : les identifiants d’un compte en lecture seule.
• Mode SSL (PostgreSQL uniquement, car les connexions MySQL n’utilisent pas TLS) définit comment SSL/TLS, le protocole qui chiffre la connexion, s’applique à votre connexion de base de données. Demandez à votre administrateur de base de données quel mode utiliser :
  • Disable : pas de chiffrement.
  • Require : chiffre la connexion, mais ne vérifie pas l’identité du serveur de base de données.
  • Verify CA : chiffre la connexion et vérifie que le certificat du serveur a été émis par une autorité de certification (CA) de confiance.
  • Verify full : identique à Verify CA, et vérifie également que le certificat correspond au nom d’hôte de votre base de données. L’option la plus forte.
• Pour tout mode autre que Disable, fournissez le certificat CA sous Source du certificat (Téléverser des fichiers ou Coller PEM), plus un Certificat client et une Clé client si votre base de données les requiert.

BigQuery

Pour Google BigQuery, remplissez :

• ID du projet : le projet GCP qui contient votre jeu de données.
• JSON du compte de service : la clé d’un compte de service avec un accès en lecture à BigQuery.
• Emplacement : la région du jeu de données (par exemple, EU, US, ou europe-west3). Laissez vide pour résoudre automatiquement l’emplacement à partir du jeu de données.

SQL Server / Fabric

Pour Microsoft SQL Server / Fabric, remplissez :

• Hôte et Port : l’adresse de votre serveur de base de données, ou votre point de terminaison d’analyse SQL Fabric. Pushwoosh requiert un hôte accessible publiquement et rejette les adresses privées, internes ou de bouclage lorsque vous vérifiez la connexion ou enregistrez le segment.
• Base de données : le nom de la base de données.
• Utilisateur et Mot de passe : les identifiants d’un compte en lecture seule.
• ID de locataire Microsoft Entra : optionnel. Laissez vide pour une connexion SQL Server. Pour Microsoft Fabric, dont le point de terminaison d’analyse SQL n’a pas de connexions SQL, définissez-le pour vous connecter en tant que principal de service à la place. Saisissez son ID d’application (client) comme Utilisateur et son secret client comme Mot de passe.

Saisir la requête

1. Saisissez la Requête. Elle doit retourner une seule colonne nommée user_id, avec une ligne par utilisateur que vous souhaitez dans le segment. Par exemple :

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

Note

Les valeurs user_id doivent correspondre aux ID utilisateur Pushwoosh que vous avez définis pour vos utilisateurs (le même identifiant utilisé par Créer des segments par ID utilisateur). Une requête retournant des ID que Pushwoosh ne reconnaît pas ne correspondra à aucun appareil.

2. Cliquez sur Vérifier la connexion pour confirmer que Pushwoosh peut atteindre la base de données (expire après 30 secondes).
3. Cliquez sur Vérifier la requête pour confirmer que la requête s’exécute et retourne la bonne colonne (expire également après 30 secondes).

Vérifier et créer

Lorsque les deux vérifications réussissent, cliquez sur Créer. Pushwoosh enregistre le segment et l’ajoute immédiatement à la liste des Segments Externes.

Comment le segment reste à jour

Pushwoosh n’exécute pas votre requête selon un calendrier fixe. Au lieu de cela, il rafraîchit le segment en fonction de la date de sa dernière utilisation :

• Si les données du segment ont moins d’une heure, Pushwoosh utilise les données actuelles telles quelles.
• Si elles ont plus d’une heure, Pushwoosh continue d’utiliser les données actuelles pendant qu’il se rafraîchit en arrière-plan.
• Si elles ont plus de trois heures, Pushwoosh attend un nouveau rafraîchissement avant d’utiliser le segment.

En pratique, cela signifie qu’un segment que vous utilisez régulièrement (par exemple, dans un Journey récurrent) reste à jour, tandis qu’un segment que vous touchez rarement peut prendre un moment pour se rafraîchir la première fois que vous l’utilisez à nouveau.

Si un rafraîchissement échoue (par exemple, la base de données devient inaccessible ou la requête commence à générer des erreurs), Pushwoosh enregistre l’erreur, mais le statut du segment dans la liste des Segments Externes ne change pas de lui-même. Après avoir résolu le problème de votre côté, ouvrez le segment et cliquez sur Vérifier la connexion pour confirmer la correction. L’erreur est effacée automatiquement la prochaine fois que les données du segment se rafraîchissent avec succès.

Utiliser un segment externe

Une fois que vous l’avez créé, le segment externe apparaît automatiquement dans Audience → Segments sous le même nom, prêt à être utilisé comme n’importe quel autre segment, par exemple comme audience d’une campagne ou d’un Journey.

Pour le combiner avec d’autres conditions, ajoutez-le comme filtre :

1. Allez dans Audience → Segments → Créer un segment.
2. Cliquez sur Ajouter un filtre par → Segment.
3. Sélectionnez votre segment externe par son nom.

Le même filtre Segment est disponible dans les filtres composés et lorsque vous choisissez l’audience dans l’Entrée basée sur l’audience. Pour en savoir plus sur la combinaison de segments, consultez Créer des segments à partir de segments existants.

Vérifier le nombre de personnes dans le segment

La liste des Segments Externes n’affiche pas de nombre de membres. Ouvrez l’enveloppe du segment dans Audience → Segments (voir Utiliser un segment externe) et calculez sa taille à cet endroit.

Gérer les segments externes

Dans la liste des Segments Externes, chaque ligne affiche le nom du segment, le Code (l’identifiant utilisé pour référencer le segment dans les appels API), le type de base de données, l’hôte et le statut (valide ou invalide).

• Cliquez sur Modifier pour changer la connexion ou la requête. Le type de base de données ne peut pas être modifié après la création. Créez plutôt un nouveau segment.
• Cliquez sur Supprimer pour retirer un segment. Pushwoosh bloque la suppression tant que le segment est utilisé par une campagne, un Journey, un filtre ou un formulaire popup. Supprimez d’abord ces références, puis supprimez le segment. Cette action est irréversible.