Envoyer des Hits

Comment envoyer des Hits vers Forecast depuis une page web ?

Cette page explique comment envoyer des Hits à Forecast depuis une page web à l’aide de Forecast JS.

Prérequis

Avant d’utiliser ses fonctionnalités, Forecast doit être installé et configuré. La page Premiers pas explique comment démarrer avec Forecast.

Article vu

Ce hit est transmis dès le chargement de Forecast JS.

Pour permettre à ce Hit de transmettre un maximum d’informations, vous devez indiquer les balises HTML décrites ci-dessous dans votre page web.

Bonne pratique

Nous vous recommandons vivement d’utiliser schema.org au format JSON-LD pour structurer les données de votre site web en association avec Forecast. Adopter cette pratique facilite l’intégration, optimise l’efficacité de Forecast et améliore l’expérience utilisateur.

Auteur

Auteur de l’article.

<meta property="og:article:author" content="Alice">

<script type="text/javascript">
  __forecast.config.article.author = "Alice";
</script>

Contenu

Contenu de l’article.

<script type="text/javascript">
  __forecast.config.contentSelector = "selector"; // Sélecteur CSS de l'élément parent du contenu de l'article
</script>

Date de modification

Date de modification de l’article.

<script type="application/ld+json">
  {
    "dateModified": "2019-10-12T07:20:50.52+00:00"
  }
</script>

<foobar itemprop="dateModified" datetime="2019-10-12T07:20:50.52+00:00">

<meta itemprop="dateModified" content="2019-10-12T07:20:50.52+00:00">

<script type="text/javascript">
  __forecast.config.article.modifiedAt = "2019-10-12T07:20:50.52+00:00";
</script>

Date de publication

Date de publication de l’article.

<script type="application/ld+json">
  {
    "datePublished": "2019-10-12T07:20:50.52+00:00"
  }
</script>

<foobar itemprop="datePublished" datetime="2019-10-12T07:20:50.52+00:00">

<meta property="og:article:published_time" content="2019-10-12T07:20:50.52+00:00">

<script type="text/javascript">
  __forecast.config.article.publishedAt = "2019-10-12T07:20:50.52+00:00";
</script>

Description

Description de l’article.

<meta property="og:description" content="example">

<script type="text/javascript">
  __forecast.config.article.description = "example";
</script>

Gratuité

Gratuité de l’article.

<script type="application/ld+json">
  {
    "isAccessibleForFree": true // ou `false`
  }
</script>

<meta property="og:article:content_tier" content="free">
<!-- ou -->
<meta property="og:article:content_tier" content="locked">

<script type="text/javascript">
  __forecast.config.article.free = true; // ou `false`
</script>

Image

Image de l’article.

<meta property="og:image" content="url">

<script type="text/javascript">
  __forecast.config.article.image = "url";
</script>

Image de la rubrique

Image de la rubrique de l’article.

<meta property="forecast:section_image" content="url">

<script type="text/javascript">
  __forecast.config.article.sectionImage = "url";
</script>

Langue

Langue de l’article.

<meta property="og:locale" content="en_US">

<script type="text/javascript">
  __forecast.config.article.locale = "en_US";
</script>

Mots-clés

Mots-clés de l’article.

<script type="application/ld+json">
  {
    "keywords": "item#1,item#2"
  }
</script>

<foobar itemprop="keywords" datetime="item#1,item#2">

<meta property="keywords" content="item#1,item#2">

<script type="text/javascript">
  __forecast.config.article.keywords = ["item#1", "item#2"];
</script>

Rubrique fine

Rubrique la plus fine de l’article.

<script type="application/ld+json">
  {
    "articleSection": [
      "Rubrique large",
      "Rubrique fine" // Attention, c'est le deuxième élément qui est considéré comme la rubrique fine et non pas le dernier élément
    ]
  }
</script>

<foobar itemprop="subsection" content="example">

<script type="text/javascript">
  __forecast.config.article.subSection = "example";
</script>

Rubrique large

Rubrique la plus large de l’article.

<meta property="og:article:section" content="example">

<script type="text/javascript">
  __forecast.config.article.section = "example";
</script>

Titre

Titre de l’article.

<meta property="og:title" content="example">

<script type="text/javascript">
  __forecast.config.article.title = "example";
</script>

URL

URL de l’article.

<link rel="canonical" href="url">

<script type="text/javascript">
  __forecast.config.article.canonicalUrl = "url";
</script>

URLs alternatifs

URLs alternatifs de l’article.

<link rel="shortlink" href="url">

<script type="text/javascript">
  __forecast.config.article.alternativeUrls = ["url"];
</script>

URLs historiques

Liste des URLs historiques de l’article, séparées par une virgule.

<meta property="forecast:first_published_urls" content="url#1,url#2">

<script type="text/javascript">
  __forecast.config.article.firstPublishedURLs = "url#1,url#2";
</script>

Conversion

Pour transmettre un Hit lorsque le visiteur a accompli l’action d’achat d’une offre, utilisez cette fonction :

window.__forecast.collectConversion("product_id");

Pour plus précisions concernant cette fonction et ses paramètres, référez-vous à sa description dans le référentiel de Forecast JS : collectConversion(formula)

Page vue

Ce hit est transmis dès le chargement de Forecast JS.

Pour permettre à ce Hit de transmettre un maximum d’informations, vous devez indiquer les balises HTML décrites ci-dessous dans votre page web.

(à compléter)