Amplitude : définir les propriétés utilisateur

Utilisez Amplitude : définir les propriétés utilisateur pour mettre à jour le profil utilisateur Amplitude du voyageur à partir d’une étape du parcours, via l’opération $identify de l’API HTTP V2, afin que la segmentation et les cohortes du côté d’Amplitude voient les mêmes données que Pushwoosh.

Pushwoosh définit l’insert_id d’Amplitude pour vous à partir du voyageur et de cette étape. Cela signifie que le même voyageur passant deux fois par ce point exact, par exemple lors d’un deuxième tour d’un parcours en boucle, met à jour le même profil Amplitude au lieu d’écrire un événement d’identification en double.

Utilisations typiques :

• Synchroniser les tags dans les segments Amplitude : envoyez le niveau de l’abonnement, le statut de l’essai ou un autre tag sur le profil Amplitude afin que les cohortes Amplitude correspondent aux audiences Pushwoosh.
• Maintenir les profils à jour sans tâche de synchronisation séparée : mettez à jour le profil à l’étape exacte du parcours où le tag a changé.
• Éviter les appels d’identification en double sur une boucle : la déduplication intégrée signifie qu’un passage répété par ce point met à jour le même profil au lieu d’écrire deux fois.

Configurer le point

1. Faites glisser Amplitude : définir les propriétés utilisateur de la section Intégrations sur le canevas.
2. Double-cliquez sur le point et saisissez un Nom d’étape.
3. Dans Clé API, saisissez la clé API du projet depuis Amplitude : Paramètres > Projets > votre projet > Général. Elle est stockée masquée, comme un en-tête secret de webhook. Pushwoosh ne l’affiche ni ne la renvoie jamais une fois enregistrée, et elle n’apparaît jamais dans la requête stockée du point ou dans le Journal des appels.

4. Dans Point de terminaison Amplitude, choisissez la région dans laquelle le projet Amplitude a été créé : api2.amplitude.com pour un projet américain, api.eu.amplitude.com pour un projet européen. Une clé d’une région est rejetée par l’autre.

5. Dans Propriétés utilisateur, ajoutez une ligne par propriété à définir sur le profil Amplitude. Saisissez le nom de la propriété et la valeur. Les noms ne doivent pas être vides et doivent être uniques. Une valeur qui est une seule macro de voyageur conserve son propre type dans Amplitude ({{tag:Age}} arrive en tant que nombre, {{tag:Trial Ends}} en tant que date). Tout autre texte est envoyé en tant que chaîne de caractères. Les macros utilisent la même syntaxe que le corps d’un Webhook. Ou cliquez sur Insérer une valeur dynamique pour choisir un attribut produit par une étape antérieure de ce parcours, par exemple une réponse LLM ou une valeur de Webhook mappée.

Exemple

Définir les Propriétés utilisateur sur user_id avec l’ID du voyageur ({{device:user_id}}) et plan avec son niveau d’abonnement ({{tag:Plan}}) définit ces deux propriétés sur son profil Amplitude.

6. Cliquez sur Enregistrer.

Réponse

Le voyageur continue vers l’étape que vous connectez ensuite on le canevas.

Attributs après l’exécution de l’étape

Attribut	Ce qu’il contient
amplitude_events_ingested	Le nombre d’événements ingérés par Amplitude

Comment l’utiliser dans les étapes ultérieures

Le voyageur a déjà continué vers l’étape suivante, quel que soit cet attribut. Enregistrez-le dans un Tag avec Mettre à jour le profil utilisateur si vous avez besoin de confirmer que la mise à jour a été ingérée ou de créer une branche dessus avec Division par condition.

Échecs et réponses inattendues

Une requête échouée retire le voyageur du parcours. Voir Erreurs et requêtes échouées.

Scénario d’exemple : Maintenir le profil Amplitude d’un abonné synchronisé

Une équipe souhaite que le niveau d’abonnement d’un voyageur soit mis à jour sur son profil Amplitude dès qu’il change dans Pushwoosh.

1. Ajoutez Amplitude : définir les propriétés utilisateur juste après l’étape où le niveau d’abonnement change. Dans Propriétés utilisateur, définissez plan sur {{tag:Plan}}.
2. Cliquez sur Enregistrer.

Une fois cette opération exécutée, le profil Amplitude reflète le changement d’abonnement sans nécessiter de tâche de synchronisation séparée.