Nous listons ici les principales étapes à prévoir lorsque vous intégrez Poool Access, et vous redirigeons vers la documentation adéquate. Selon les cas d'usage que vous implémentez, certaines actions devront être approfondies.
💡 Vous retrouvez également l'ensemble de notre documentation technique dans notre devhub.
Introduction
L'implémentation des parcours avec Poool Access implique l'intégration de deux scripts: Access.js et Audit.js
Script Access.js
Permet d’afficher le paywall et tracke tout ce qui est lié à l'affichage du paywall
Celui-ci implique l'étape préalable d'identification du contenu à bloquer ainsi que de l'emplacement du paywall sur la page. Il faut donc :
identifier le contenu que vous souhaitez verrouiller
<div class="content" data-poool="80" data-poool-mode="excerpt">
Ceci est un article premium important, il raconte l'histoire de..
</div>
ajouter le contenu HTML et javascript nécessaire pour définir là où votre wall va être afficher
<div id="poool-widget">
<!-- votre paywall sera affiché ici -->
</div>
Pour plus d'informations, vous pouvez consulter la documentation d'installation.
Script Audit.js
Ce script est dédié au tracking. Il permet de suivre ce qui est lié à l'interaction du lecteur avec la page et le site - son intégration est nécessaire pour utiliser la segmentation native de poool et obtenir des statistiques complètes.
Access.js - réglages initiaux
Access.js est constitué de 3 parties obligatoires, qui doivent être appelées dans l’ordre suivant :
1. L’initialisation avec votre identifiant d’application fournie au moment de l'onboarding
2. La configuration qui contient tous vos paramètres
3. La création d’une instance du paywall et de ses options
Dans le cadre de la mise en conformité avec le RGPD, l’information que vous obtenez sur le consentement de l’utilisateur doit être envoyée à Poool dans votre configuration
.config({ cookies_enabled: <true|false> })
Gestion du type de page
Le tag de Poool est dynamique. Pour chaque page, il doit être adapté en fonction du type de page dans laquelle il se trouve : homepage, articles premium, contenu gratuit. 3 valeurs sont disponibles: 'premium', 'free' et 'page'.
access.createPaywall({ pageType: 'premium' });
Selon la valeur qui est envoyée, les paramétrages réalisés dans le Dashboard seront appliqués.
Premium => application des contextes de type premium actifs dans le Dashboard ainsi que du contexte par défaut
Free => application des contextes de type gratuits actifs dans le Dashboard
Mode de blocage
Il existe deux types de méthodes pour bloquer le contenu : d’un côté les méthodes natives conçues pour optimiser le temps d’intégration et l’expérience utilisateur (méthodes hide et excerpt), d’un autre la méthode custom pour personnaliser les règles de déblocage selon vos exigences de sécurité.
Pour vous aider dans votre choix, vous trouverez plus de détail dans notre article dédié : quels modes de blocages sont disponibles dans Poool Access
Gestion des droits abonnés
Poool Access ne gère pas le non-affichage du paywall pour les utilisateurs ayant des droits abonnés. Ce cas doit être géré côté éditeur. Vous trouverez plus d'informations à ce sujet dans notre article : comment configurer l'accès à mon contenu pour les utilisateurs avec des droits abonnés.
Personnalisation via les contextes
Le Dashboard propose nativement différents types de contextes et de segmentations d’audience. Vous pouvez aussi personnaliser certains paramètres selon votre stratégie marketing en ajoutant des éléments à votre configuration.
Vous pouvez ainsi créer un contexte personnalisé dans le Dashboard, et ajouter dans votre configuration le “slug” attribué à ce contexte.
Côté intégration, vous pouvez passer dans la configuration des contextes une seule valeur, ou un tableau de valeurs.
access.config('context', 'custom-test-context');
// Il est aussi possible de passer plusieurs valeurs pour affiner le choix du contexte personnalisé
access.config('context', ['custom-test-context', 'fan', 'category']);
Pour approfondir vos options en terme de ciblage et notamment comprendre comment fonctionne la combinaison de plusieurs valeurs, vous pouvez consulter notre article : comment configurer un contexte avancé avec plusieurs variables personnalisées.
Personnalisation via les groupes personnalisés
De la même manière, les groupes personnalisés vous permettent d'envoyer une valeur personnalisée à Poool et d'activer un scénario en conséquence.
access.config('custom_segment', 'test-segment');Pour approfondir cette option, n'hésitez pas à consulter notre article comment créer un groupe custom.
A la différence des contextes personnalisés, vous ne pouvez envoyer qu'une seule valeur à la fois dans le configuration custom_segment.
Collecte des données
Dans les cas où vous utilisez nos widgets dédiés à la collecte de donnée (widget Newsletter et widget Formulaire), vous devez mettre en place un logique de récupération des données, selon les méthodes mises à votre disposition :
Paywall par défaut
Dans certaines circonstances, il est possible qu'une erreur empêche de communiquer avec le Dashboard. Les paramètres que vous aurez définis ne pourront donc pas être appliqués, et le lecteur sera potentiellement exposé à une action par défaut.
Afin de vous assurer que l'expérience utilisateur reste préservée, plusieurs options sont possibles. Voici notre article sur comment paramétrer le comportement en cas d'erreur ainsi que notre guide technique.
Poool status
Vous pouvez à cette adresse suivre les incidents API 👉 https://status.poool.fr/. N’hésitez pas à vous inscrire aux alertes.
Tracking des performances
Vous pouvez suivre les performances de vos actions dans le Dashboard, onglet statistiques. Les statistiques de Poool sont mises à jour chaque nuit et sont disponibles sur le Dashboard le jour suivant.
💡 Les statistiques Poool sont accessibles dans votre Dashboard pendant une durée de 120 jours.
Vous pouvez également relier la donnée Poool à votre propre solution de tracking. Nous mettons à disposition les connecteurs suivants :
GTM (à choisir si GA4 est chargé via GTM)
Si vous souhaitez mettre en place un tracking personnalisé, et/ou dans le cas où vous utilisez un outil Analytics autre que GA et Piano, vous pouvez vous appuyer sur les événements poool.
Webperformances
Pour les éditeurs pour qui le sujet des webperformances est une priorité, voici nos recommandations d'optimisations à prendre en considération pour votre intégration. N'hésitez pas à en parler avec nos équipes pendant l'onboarding.
Audit.js - principale étapes d’intégration
Audit.js est une librairie sœur d’Access.js et sera automatiquement détectée par Access.js.
Audit.js est constitué de 3 parties obligatoires, qui doivent être appelées dans l’ordre suivant :
L’initialisation avec votre identifiant d’application
La configuration si besoin
L'envoi d'un event Audit - pour chaque page, il doit être adapté en fonction du type de page dans laquelle il se trouve (premium ou free)
Comme pour Access, l’information que vous obtenez sur le consentement de l’utilisateur doit être envoyée à Poool dans votre configuration
.config({ cookies_enabled: <true|false> })
Audit.js - autres configurations
Personnalisation
Dans le cas où vous utilisez les contextes et/ou groupes personnalisés, vous devez faire passer l’information dans Audit également, de la même manière que ce que vous avez fait avec Access.
Tracking des performances
La connexion avec votre Analytics réalisée dans Access doit aussi être intégrée dans la configuration d’Audit :
Tracking custom via les événements JS
Une fois l'ensemble de vos paramétrages finalisés, vous pouvez aussi consulter notre check-list pré-lancement, qui vous sera utile dans le cadre des derniers tests.
Nos équipes CS et Opérations sont disponibles pour vous aider tout au long de votre implémentation, n'hésitez pas à nous contacter via intercom ou à l'adresse support@poool.fr 🙂