Personyze et Amplitude fonctionnent dans les deux sens : Personyze envoie des événements de campagne à Amplitude, et vos cohortes Amplitude reviennent dans Personyze sous forme de listes d’audience que vous pouvez cibler.
Partie 1 : envoyer les événements Personyze à Amplitude
Personyze peut envoyer un événement à Amplitude chaque fois qu’un visiteur correspond à une campagne — depuis les serveurs de Personyze, via l’API HTTP V2 d’Amplitude.
Amplitude propose bien un SDK pour navigateur ; on peut donc se demander pourquoi l’envoi se fait côté serveur. Envoyer depuis nos serveurs signifie que l’événement arrive que le script Amplitude se soit chargé sur cette page ou non — toute la différence entre une destination qui fonctionne et une destination qui ne fonctionne que là où un script a bien voulu se charger.
Ce qu’il vous faut
| Champ | Où le trouver |
|---|---|
| Clé API du projet | Amplitude → Settings → Projects → votre projet → API Key |
| Case EU project | Cochez-la si votre projet Amplitude est hébergé dans l’UE |
Comment la personne est identifiée
Les événements Amplitude sont rattachés à l’identifiant de visiteur Personyze, pas à une adresse e-mail — cette destination fonctionne donc aussi pour les visiteurs anonymes. Si vous voyez “the recipient has no identifier” dans le journal de la campagne, le visiteur n’avait aucun identifiant à envoyer, ce qui est rare.
Ce qui arrive
Le nom d’événement que vous avez saisi, l’identifiant du visiteur, un horodatage et toutes les propriétés ajoutées à l’action — qui peuvent reprendre des données du profil Personyze du visiteur et des métriques de campagne en temps réel.
Partie 2 : utiliser les cohortes Amplitude dans Personyze
Synchronisez une cohorte Amplitude avec Personyze et elle devient une liste d’audience nommée “Amplitude: <nom de la cohorte>”. Ciblez-la dans n’importe quelle campagne — site web, e-mail ou hors ligne. Quand des personnes entrent dans la cohorte ou en sortent dans Amplitude, elles entrent dans la liste ou en sortent automatiquement, et le site web voit le changement dès la page suivante du visiteur.
Ce qu’il vous faut
- Une offre Amplitude qui inclut les destinations webhook de cohortes (une offre payante).
- Une clé API Personyze : Paramètres → Intégrations → Amplitude → Générer une nouvelle clé (les mêmes clés que sur la carte API complète).
Mise en place
- Dans Personyze, ouvrez Paramètres → Intégrations → Amplitude et copiez l’URL du webhook (
https://personyze.com/api/audiences/amplitude). - Dans Amplitude, ajoutez une destination Cohort Webhook. Saisissez l’URL, puis ajoutez un en-tête nommé Authorization avec la valeur
Bearer <your API key>(le mot Bearer, une espace, puis la clé). - Synchronisez une cohorte vers cette destination.
Comment les personnes sont reconnues
Par le user_id d’Amplitude, comparé à l’identifiant utilisateur que votre site envoie à Personyze lors de la connexion, et à l’adresse e-mail lorsque le user_id est une adresse e-mail.
Où la trouver
Audiences → Listes d’audience. Choisissez la liste dans le ciblage d’une campagne avec la règle Listes d’utilisateurs.
Voir aussi
- Send Event to Analytics — l’action, et ses onze autres destinations.
- Intégration Mixpanel — les deux mêmes sens pour Mixpanel.
- Analytique et rapports