Concept
Segments avec suivi
Les segments avec suivi enregistrent qui entre et qui sort, et quand. Démarrez des automatisations et envoyez des webhooks lors des entrées et des sorties, et suivez l’évolution d’un segment. Alpha : réservé à l’équipe Emailit.
Un segment avec suivi est un segment qui enregistre aussi ses membres. Lorsqu’un contact commence ou cesse de correspondre à ses règles, Emailit enregistre le changement, ce qui vous permet de :
- démarrer des automatisations quand une personne entre ou sort,
- recevoir des webhooks pour les entrées et les sorties,
- voir l’évolution du segment dans le temps et la date d’entrée de chaque contact.
Les nombres, la liste de contacts et les campagnes fonctionnent comme pour tout segment : ils évaluent les règles en direct et n’utilisent jamais les membres enregistrés.
Les segments avec suivi sont inclus dans les forfaits Pro, Business et Custom, et comptent dans la même limite de segments que les autres segments.
Créer un segment avec suivi
Lorsque vous créez un segment, choisissez Tracked segment sous Type. Sur Pay as you go, l’option est désactivée et affiche Upgrade. Avec l’API, transmettez "tracked": true à Créer un segment.
Le type ne peut pas être modifié par la suite, dans un sens comme dans l’autre. Pour suivre un segment existant, créez un nouveau segment avec suivi doté des mêmes règles. Duplicate conserve le type de l’original.
Juste après sa création, un segment avec suivi affiche Recording current members pendant qu’Emailit enregistre toutes les personnes qui correspondent déjà (tracking.status vaut syncing dans l’API). Ce premier décompte n’envoie pas d’événement et ne démarre pas d’automatisation : seuls les contacts qui entrent ou sortent ensuite comptent comme des changements.
Mise à jour des membres
| Ce qui se passe | Quand les membres sont mis à jour | reason |
|---|---|---|
| Un contact est créé, modifié, supprimé, s’inscrit ou se désinscrit, ou une étape d’automatisation le modifie | Généralement en moins d’une minute | contact |
| Un import de contacts se termine, ou une liste est supprimée | À la fin de l’opération, pour tout le segment | contact |
| Règles qui évoluent avec le temps, comme Created au cours des 30 derniers jours, et changements qui ne produisent pas d’événement de contact | Chaque jour à 0 h 30 UTC, pour tout le segment | schedule |
| Vous modifiez la source ou les filtres du segment | Juste après l’enregistrement | segment_updated |
Chaque entrée ou sortie est enregistrée avec sa reason. Les changements dus à la modification du segment sont envoyés aux webhooks mais ne démarrent pas d’automatisation : un changement de règles ne lance donc pas une automatisation pour toutes les personnes concernées. Les contacts qui sortent parce qu’ils ont été supprimés n’envoient aucun événement.
Démarrer des automatisations
Deux déclencheurs de contact partent d’un segment avec suivi :
| Déclencheur | Clé API | Démarre une exécution quand |
|---|---|---|
| Added to segment | contact.added_to_segment |
Un contact entre dans le segment. |
| Removed from segment | contact.removed_from_segment |
Un contact sort du segment. |
Choisissez le segment sous Tracked segment dans le déclencheur. Seuls les segments avec suivi sont listés, et eux seuls peuvent être utilisés. Les exécutions démarrent généralement moins d’une minute après l’entrée ou la sortie.
Pour Added to segment, cochez Also start for contacts already in the segment when the automation is first started pour exécuter aussi l’automatisation pour les membres actuels. Cela se produit une seule fois, au premier démarrage de l’automatisation, pour les membres enregistrés à ce moment-là. Les paramètres d’exécution de l’automatisation, comme allow_reentry et cooldown_seconds, s’appliquent toujours. Consultez Utiliser l’API.
Les entrées et sorties peuvent aussi mettre fin à des exécutions (Removed from segment comme condition de sortie), remplir des objectifs et reprendre des étapes Wait until. Consultez Conditions de sortie et objectifs.
Un segment qu’une automatisation utilise ne peut pas être supprimé tant que vous n’avez pas modifié cette automatisation. Consultez Déclencheurs d’automatisation.
Webhooks
Les entrées et les sorties envoient ces événements webhook :
segment.contact_addedlorsqu’un contact entre, avecjoined_at.segment.contact_removedlorsqu’un contact sort, avecleft_at.
Les deux contiennent l’id et le name du segment, l’id, l’email, les noms et les champs personnalisés du contact, ainsi que la reason du tableau ci-dessus. L’Activity log du contact affiche aussi des entrées « Joined segment » et « Left segment ».
L’évolution et la colonne Joined
La page d’un segment avec suivi comporte un graphique Growth sur les 30 derniers jours : les Members à la fin de chaque jour, et le nombre de contacts entrés (Joined) et sortis (Left). L’historique commence au démarrage du suivi, et le premier décompte n’apparaît pas comme des entrées.
Le tableau des contacts ajoute une colonne Joined avec la date de début de la présence actuelle du contact dans le segment. Un contact qui sort puis revient reçoit une nouvelle date. Elle reste vide tant que le suivi n’a pas enregistré le contact.
Avec l’API, utilisez Récupérer l’évolution d’un segment pour 365 jours au maximum, et Lister les contacts d’un segment pour joined_at.
Quand le suivi est mis en pause
Si l’espace de travail passe à un forfait sans segments avec suivi, le suivi est mis en pause. La page du segment affiche Tracking is paused et tracking.status vaut paused :
- Les membres ne sont plus mis à jour, aucun événement n’est envoyé et aucune automatisation ne démarre à partir du segment.
- Le segment continue d’être compté, listé et utilisé pour les envois en direct, comme tout segment.
Après un nouveau passage à un forfait supérieur, Emailit enregistre de nouveau les membres actuels lors de la mise à jour suivante, sans envoyer d’événement ni démarrer d’automatisation, puis le suivi reprend. Les entrées et les sorties survenues pendant la pause du suivi ne sont pas enregistrées.
Utiliser l’API
| Tâche | Endpoint |
|---|---|
| Créer un segment avec suivi | Créer un segment avec "tracked": true |
| Vérifier l’état du suivi | tracked et tracking dans Récupérer un segment |
| Membres, entrées et sorties par jour | Récupérer l’évolution d’un segment |
| Date d’entrée de chaque membre | joined_at dans Lister les contacts d’un segment |
Sur Pay as you go, "tracked": true renvoie 403 avec "error": "plan_required" et "required_plan": "pro". Lister les segments renvoie usage.tracking_allowed, qui indique si le forfait inclut les segments avec suivi.