...
Il est convenu ici que vous disposez des connaissances suffisantes de l’environnement javascript et du développement web. Il est aussi considéré que vous connaissez la terminologie de la solution Right Consents de FairAndSmart et des outils mis à disposition. Si tel n’est pas le cas, référez vous à notre documentation avant de poursuivre.
Importer Fairandsmart.js
via HTML script tag
| Code Block | ||
|---|---|---|
| ||
<script src="https://link.to.assets/consent.js" sha-256="hash" type="text/javascript" /> |
Le SDK sera disponible dans la variable window.FairAndSmart
Exemple:
| Code Block | ||
|---|---|---|
| ||
const collector = new FairAndSmart.ConsentCollector(); |
via npm (recommandé)
| Code Block | ||
|---|---|---|
| ||
npm i @fairandsmart/consent-manager |
Vous pourrez alors importer les composants du SDK avec import
Exemple:
| Code Block |
|---|
import { ConsentCollector } from '@fairandsmart/consent-manager'; |
Initialisation
Le SDK a besoin d'être initialisé avant de pouvoir être utilisé. Selon la configuration de vos offres et ce que vous voulez effectuer avec fairandsmart.js, vous devrez spécifier les différents points d’accès aux services FairAndSmart.
| Info |
|---|
Si vous préférez utiliser FairAndSmart uniquement pour les types, interfaces et énumérations mises à disposition, vous pouvez passer cette étape. |
Avant de pouvoir utiliser les fonctionnalités de collecte du SDK, vous devez appeler la méthode RightConsents.init :
| Code Block | ||
|---|---|---|
| ||
import { RightConsents } from '@fairandsmart/consent-manager';
import { defaultHttpClient } from '@fairandsmart/consent-manager/http';
RightConsents.init({
apiRoot: 'https://consent-manager.fairandsmart.com',
catalogRoot: 'https://catalog.fairandsmart.com',
httpClient: defaultHttpClient,
}); |
Cette méthode prend en paramètre un objet de configurations comportant les champs suivants :
...
Champ
...
Description
...
Valeur par défaut
...
apiRoot
...
Il s’agit du point d’accès de votre Consent Manager FairAndSmart. Le SDK utilisera cette URI pour interroger la base de consentement de vos utilisateurs.
...
‘no_endpoint’
...
catalogRoot
...
Il s’agit du point d’accès du catalogue de donnée de FairAndSmart. Cette option n’est a spécifier que si vous avez souscrit à l’offre Right Data - permettant de collecter des données utilisateur.
...
‘no_endpoint’
...
httpClient
...
Il s’agit d’un client http par lequel tous les appels http du SDK passeront. La fonction doit être du type RcHttpClient. Vous pouvez choisir d’utiliser le client http fourni par le SDK (defaultHttpClient) ou implémenter le vôtre.
...
defaultHttpClient