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
  • l’identifiant Edition à indiquer lors de l’intégration de Forecast JS à votre site, par exemple : edition-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.editionId = 'edition-xyz';
    __forecast.config.campaigns = {enabled: false};
    if (!__forecast.loaded) {
      const forecast = d.createElement('script');
      forecast.async = true;
      forecast.src = `${__forecast.domain}/sdk.js`;
      forecast.addEventListener('load', () => {
        __forecast.loaded = true;
      });
      const s = d.getElementsByTagName('script')[0];
      s.parentNode.insertBefore(forecast, s);
    }
  })(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.editionId = 'edition-xyz';
    __forecast.config.campaigns = {enabled: false};
    if (!__forecast.loaded) {
      var forecast = d.createElement('script');
      forecast.async = true;
      forecast.src = __forecast.domain + '/sdk.js';
      forecast.addEventListener('load', function () {
        __forecast.loaded = true;
      });
      var s = d.getElementsByTagName('script')[0];
      s.parentNode.insertBefore(forecast, s);
    }
  })(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 a été fourni par l’équipe Forecast (voir Prérequis).

⚠️ Remplacez edition-xyz par l’identifiant Edition qui vous a é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 évènements vers Forecast Signals.

Étapes suivantes