Présentation de Forecast Signals
Cette page présente Forecast Signals.
Collecte des évènements
C’est généralement suite aux actions d’un utilisateur qu’une application va transmettre un évènement à Forecast Signals. Chaque évènement transmis porte des informations. Par exemple, l’évènement “Page vue” porte les informations suivantes : URL de la page, titre de la page.
Les différents évènements
Les différents évènements supportés par Forecast Signals sont les suivants :
- Page vue
- Taux de lecture
- Temps de lecture
- Clic sur une publicité
- Survol d’une publicité
- Partage d’un contenu
- Commentaire
- Cadeau (exemple, article offert)
- Accès au tunnel d’abonnement
- Conversion
- Volonté de désabonnement (exemple, accès à la page “Comment se désabonner ?”)
- Résiliation d’un abonnement
- Vue d’un widget servi par Forecast
- Clique sur un widget servi par Forecast
- Fermeture d’un un widget servi par Forecast
- Attribution d’une version d’A/B test pour un widget servi par Forecast
Le contenu des évènements
Chaque évènement peut porter ces informations :
- Identifiant de l’utilisateur
- Statut de l’utilisateur (anonyme, inscrit, abonné)
- URL consultée
- Identifiant de l’article consulté
- Device utilisé
- Referrer
Si l’utilisateur est connecté, les évènements peuvent porter ces informations supplémentaires :
- Identifiant de l’abonnement
- Date de début d’abonnement
- Date de fin d’abonnement
- Toute autre information permettant une meilleure caractérisation de l’utilisateur
Forecast Signals API
Forecast Signals a une API HTTP dédiée à la transmission des évènements. La documentation de cette API se trouve dans la page Intégration API.
Exemple d’utilisation
La commande ci-dessous permet d’envoyer un évènement “churn” à Forecast.
curl --request POST 'http://forecast.loc-lemonde.fr/l/action/' \
--data-raw '{
"event_name" : "churn",
"event_properties" : {
"u": "https://forecast.example.com/articles/lorem-ipsum",
"d": "2022-05-05T14:00:00Z",
"formula": "ABC123"
},
"user_properties": {
"uid": "123",
"uis": false
}
}'
Forecast Signals JS
Forecast Signals a une librairie Javascript dédiée à la transmission des évènements depuis les pages web. La documentation de cette librairie se trouve dans la page Intégration JS.
Exemple d’utilisation
Le script ci-dessous permet d’envoyer un évènement “churn” à Forecast depuis une page web.
__forecast.collectChurn();
Étapes suivantes
- Intégration API : Spécification OpenAPI de Forecast Signals API.
- Intégration JS : Comment envoyer des évènements vers Forecast depuis une page web ?