> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.poool.fr/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Utiliser les segments d'engagement Marfeel (RFV) avec Access

Poool Access peut utiliser les groupes d'engagement calculés par Marfeel afin de personnaliser l'expérience proposée aux lecteurs.
Grâce à cette intégration, le groupe d'engagement attribué par Marfeel est transmis à Poool sous la forme d'un segment personnalisé (`custom_segment`). Cela permet d'afficher des scénarios différents en fonction du niveau d'engagement de chaque visiteur.
Cette intégration s'appuie sur le SDK JavaScript Marfeel déjà présent sur votre site.

# Fonctionnement

À l'arrivée d'un lecteur sur un article : Le script interroge le SDK Marfeel déjà présent sur la page.
Marfeel retourne le score d'engagement RFV, calculé à partir de trois indicateurs :
    * Recency — date de la dernière visite
    * Frequency — fréquence des visites
    * Volume — nombre de pages consultées

Ce score place le lecteur dans l'un des groupes de l'*Audience Loyalty Funnel* de Marfeel :

| Group | Description |
| ---- |
| `new` | Nouveau lecteur |
| `fly-by` | Visite occasionnelle, sans engagement |
| `casual` | Lecteur occasionnel |
| `loyal` | Lecteur fidèle |
| `lover` | Lecteur très engagé |

Transmettez à Poool via la propriété `custom_segment` au moment de la création du paywall, ce qui déclenche le scénario associé à ce lecteur.

||| Si aucun score valide n'est disponible, Poool utilise simplement sa segmentation native.


# Configuration dans le Dashboard Poool

Avant toute mise en production, créez dans votre Dashboard Poool les segments personnalisés correspondants. Vous pouvez choisir de conserver exactement les mêmes slugs que ceux utilisés par Marfeel afin que la correspondance soit automatique :

* `new`
* `fly-by`
* `casual`
* `loyal`
* `lover`

Associez ensuite un scénario spécifique à chacun de ces segments.

||| Les segments personnalisés sont prioritaires sur la segmentation native de Poool. Dès qu'un lecteur appartient à un segment personnalisé, le scénario associé remplace les règles natives.

# Intégration technique

### JavaScript

Une fois le groupe Marfeel récupéré, transmettez-le à Poool lors de l'initialisation d'Access. Si aucun groupe n'est disponible, ne transmettez simplement pas la propriété `custom_segment` :

```
.config({
  ...
  ...(segment && { custom_segment: segment })
})
```

### React

Avec le SDK `@poool/react-access`, récupérez le groupe Marfeel avant de monter le composant `AccessContext`, puis transmettez-le dans la configuration :

```
<AccessContext
  appId="YOUR_APP_ID"
  config={{
    ...(segment && { custom_segment: segment }),
  }}
>
```

### Exemple concret

```
custom_segment: "loyal"
```

Cette valeur déclenche automatiquement le scénario configuré pour les lecteurs du segment `loyal`.

| Pour que la segmentation fonctionne correctement, assurez-vous d'initialiser Poool Access après avoir récupéré le groupe d'engagement Marfeel.

Nous recommandons également de prévoir une logique de fallback. Si Marfeel est indisponible, ne répond pas dans un délai raisonnable. Pour bien s'assurer que le wall est bien visible


# Exemple d'intégration Poool × Marfeel

Dans notre exemple d'intégration, le fonctionnement est le suivant :

À l’arrivée d’un lecteur sur un article, le script récupère le score d’engagement RFV depuis le SDK Marfeel déjà présent sur les pages.
Ce score est ensuite converti en un groupe personnalisé.
Le groupe obtenu est transmis à Poool au moment de la création du paywall afin de déclencher le scénario associé au segment du lecteur.

Si Marfeel n’est pas disponible, ne répond pas dans le délai prévu (2 secondes), ou si le lecteur ne peut pas être personnalisé, aucun groupe personnalisé n’est envoyé. Dans ce cas, on utilise automatiquement la segmentation native et le fonctionnement actuel du paywall reste inchangé.

Avant la mise en production, il faudra donc créer les cinq groupes personnalisés dans le Dashboard avec exactement les bons slugs.

Exemple react: https://codesandbox.io/p/sandbox/gq54q6
Exemple JS: https://codesandbox.io/p/sandbox/marfeel-files-js-lrt6yd

# Pour aller plus loin

Pour comprendre en détail le calcul du score RFV et la signification des différents groupes d'engagement, consultez la documentation officielle Marfeel :
[RFV Score: Recency, Frequency and Volume explained.](https://www.marfeel.com/docs/loyalty/rfv-score-recency-frequency-and-volume-explained)