Transmission des Hits

Cette page explique la transmission des Hits vers Forecast.

Forecast Hits API

Forecast dispose d’une API HTTP dédiée à la transmission des Hits nommée Forecast Hits API.

Forecast Hits API expose plusieurs points de terminaison permettant la réception de différents Hits et des informations qui leur sont attachées. La liste de ces points de terminaison se trouve dans la section Référence.

La bonne réception d’un Hit est confirmé par une réponse HTTP 200 ou HTTP 204. Dans le cas contraire, un message d’erreur est retourné.

Exemple

La commande ci-dessous permet d’envoyer un Hit “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 JS

Forecast JS est une librairie Javascript à intégrer aux pages web. Elle permet de faciliter l’envoi de Hits — vers Forecast Hits API — avec un maximum d’informations durant une session de navigation web.

L’appel aux méthodes de Forecast JS déclenche l’envoi d’un Hit et des informations qui y sont attachées. La liste des méthodes JavaScript fournies par la librairie se trouve dans la section Référence.

Certains Hits sont transmis automatiquement lors du chargement de Forecast JS, sans nécessiter l’appel à une méthode Javascript spécifique.

Pour enrichir vos hits, Forecast JS détecte et extrait les informations directement à partir des balises présentes dans le contenu de vos pages. En plus des balises HTML spécifiques à Forecast, notre outil de suivi prend en charge les balises et les nomenclatures standard, telles que schema.org au format JSON-LD, OpenGraph et Microdata. Cette compatibilité avec les balises existantes permet une intégration transparente et simplifie l’implémentation de Forecast, sans nécessiter d’interventions supplémentaires sur le balisage du site ou de développement spécifique.

Exemple

Le script ci-dessous permet d’envoyer un Hit “churn” à Forecast depuis une page web.

__forecast.collectChurn();