Premiers pas

Commencer à utiliser Forecast.

Cette page explique comment démarrer avec Forecast.

Prérequis

Avant d’utiliser Forecast, demandez aux équipes de Forecast de vous activer les accès en leur transmettant ces informations :

  • le nom de domaine du site qui sera suivi par Forecast, par exemple : example.com
  • le sigle de votre compagnie, par exemple : example
  • les IPs pouvant accéder aux espaces d’administration protégés de Forecast, par exemple : 82.255.255.255 et 194.0.0.0

Les équipes de Forecast vous confirmerons l’activation de vos accès et vous fourniront ces informations à conserver :

  • les sous-domaines que vous devez créer — en suivant la section Installation — pour atteindre Forecast depuis votre infrastructure, par exemple : forecast.example.com et stg-forecast.example.com
  • la clé d’API pour vous authentifier auprès des APIs de Forecast, par exemple : ce879da6fce0482e8d375eec91bf29cb
  • l’identifiant Client à indiquer lors de l’intégration de Forecast JS à votre site, par exemple : client-xyz

Installation

Pour installer Forecast vous devez ajouter des sous-domaines au domaine de votre site. Les sous-domaines devront pointer vers les serveurs Forecast. Pour faire cela, suivez ces étapes :

  1. munissez-vous des sous-domaines que les équipes de Forecast vous ont demandé de créer (voir Prérequis), par exemple : forecast.example.com et stg-forecast.example.com

  2. créez ces sous-domaines en utilisant la méthode fournie par votre service de gestion des domaines

  3. ajoutez les enregistrements DNS ci-dessous en utilisant la méthode fournie par votre service DNS :

    • enregistrement CNAME :

      stg-forecast.example.com. 300 IN CNAME stg-forecast.example.lemonde.fr.
forecast.example.com. 300 IN CNAME forecast.example.lemonde.fr.

Mise en place de Forecast JS

Intégrez Forecast JS à votre site pour profiter des services de Forecast en insérant cette balise JavaScript sur vos pages suivies :

<script type="text/javascript">
  (function (w, d) {
    const __forecast = w.__forecast || (w.__forecast = {});
    __forecast.domain = 'forecast.example.com';
    __forecast.config = __forecast.config || {};
    __forecast.config.clientId = 'client-xyz';
    __forecast.config.campaigns = {enabled: false};
    if (!__forecast.loaded) {
      const forecast = d.createElement('script');
      forecast.async = true;
      forecast.src = `${__forecast.domain}/sdk.js`;
      const s = d.getElementsByTagName('script')[0];
      s.parentNode.insertBefore(forecast, s);
      __forecast.loaded = true;
    }
  })(window, document);
</script>
   
<script type="text/javascript">
  (function (w, d) {
    var __forecast = w.__forecast || (w.__forecast = {});
    __forecast.domain = 'forecast.example.com';
    __forecast.config = __forecast.config || {};
    __forecast.config.clientId = 'client-xyz';
    __forecast.config.campaigns = {enabled: false};
    if (!__forecast.loaded) {
      var forecast = d.createElement('script');
      forecast.async = true;
      forecast.src = __forecast.domain + '/sdk.js';
      var s = d.getElementsByTagName('script')[0];
      s.parentNode.insertBefore(forecast, s);
      __forecast.loaded = true;
    }
  })(window, document);
</script>

⚠️ Remplacez forecast.example.com par l’URL du sous-domaine de votre site.

⚠️ Remplacez client-xyz par l’identifiant Client qui vous été fourni par l’équipe Forecast (voir Prérequis).

C’est parti !

Naviguez sur votre site et Forecast JS transmettra d’ores et déjà des Hits vers les serveurs Forecast. Ces Hits permettent les suivis de navigation et de contenu.

Ouvrez la page de prévisualisation des recommandations d’article https://forecast.example.com/experiment/recommendations en veillant à remplacer example.com par votre nom de domaine conformément à votre installation. Aucun résultat ne sera visible à cet instant, car Forecast n’a pas encore reçu assez de Hits pour produire des recommandations.

Étapes suivantes