Developers » Android » Fonctionnalités avancées » Privacy 2.20.1
Privacy
Avant-propos
La fonctionnalité Privacy permet de contrôler le type d’informations collectées en fonction des contraintes légales propres à chaque éditeur selon les régions. Il vous offre ainsi la possibilité d’adapter votre marquage grâce à une gestion précise des différents paramètres de mesure en fonction de leur sensibilité, dans le respect de la réglementation en vigueur.
Mode de consentement
Pour son fonctionnement, la fonctionnalité Privacy s’appuie sur une liste de différents modes de consentement de l’utilisateur
optin
: pour une mesure exhaustive après consentement.optout
: pour une mesure restreinte avec idclient valant « OPT-OUT ».no-consent
: pour une mesure restreinte avec idclient valant « Consent-No ».exempt
: pour une mesure hybride avec exclusion des données jugées sensibles (soumis au process d’exemption CNIL).
Chaque mode visiteur liste une série de paramètres du Tracker à autoriser. Il est donc possible d’interagir à différents niveaux et de conserver la maîtrise complète des données à transmettre.
Lorsqu’un mode visiteur est activé, il est enregistré pour une durée de 397 jours configurable.
Méthodes de marquage
La fonctionnalité fournit une série de méthodes utiles dans la gestion du consentement :
setVisitorOptOut
setVisitorOptOut()
Activer le mode « optout »
Exemple
Privacy.setVisitorOptOut();
setVisitorOptIn
setVisitorOptIn()
Activer le mode « optin »
Exemple
Privacy.setVisitorOptIn();
setVisitorMode
setVisitorMode(visitorMode)
setVisitorMode(visitorMode, duration)
Activer un mode spécifique pour une durée déterminée (si non renseignée, 397 par défaut)
Param | Type | Description |
visitorMode | Privacy.VisitorMode | Nom du mode visiteur |
duration | int | Durée de la validité du nouveau mode (en jours) |
Exemple
Privacy.setVisitorMode(Privacy.VisitorMode.Exempt); Privacy.setVisitorMode(Privacy.VisitorMode.Exempt, 397);
getVisitorMode
getVisitorMode() ⇒ Privacy.VisitorMode
Récupérer le mode visiteur courant.
Exemple
Privacy.VisitorMode visitorMode = Privacy.getVisitorMode();
extendIncludeBuffer
extendIncludeBuffer(keys)
extendIncludeBuffer(visitorMode, keys)
Ajouter des paramètres de buffer à la liste d’inclusion du mode visiteur courant si celui ci n’est pas spécifié dans l’appel
Param | Type | Description |
visitorMode | Privacy.VisitorMode | Mode pour lequel le buffer sera étendu |
keys | String... | Paramètres de buffer |
Exemple
Privacy.extendIncludeBuffer("an"); // buffer parameter "an" Privacy.extendIncludeBuffer(Privacy.VisitorMode.Exempt, "an", "ac"); // buffer parameters "an" and "ac" for Exempt mode (even if current mode is different) Privacy.extendIncludeBuffer("stc_custom1", "stc_custom2"); // buffer parameter "stc", keys "custom1" and "custom2" Privacy.extendIncludeBuffer("stc_custom*"); // buffer parameter "stc", keys start with "custom"
Cas d’utilisation
Activation du mode hybride CNIL
L’activation du mode hybride exempt
permet une mesure très limitée par le Tracker. Seuls les paramètres jugés « strictement nécessaires » sont mesurés. Voir la liste des paramètres autorisés (par défaut) :
Arrays.asList("s", "vm", "vc", "mh", "idclient", "p", "olt", "vtag", "ptag", "ts", "click", "type", "cn", "dg", "apvr", "mfmd", "model", "manufacturer", "os", "stc_crash_*")
Bien entendu, la liste d’inclusion des paramètres peut être étendue si nécessaire. Par exemple, il est possible d’ajouter une variable personnalisée de site à cette liste si l’on considère que les données sont strictement nécessaires, en utilisant la méthode extendIncludeBuffer()
.
Exemple
Privacy.extendIncludeBuffer(Privacy.VisitorMode.Exempt, "x1"); // The site indicator "x1" is added to the inclusion list
Activation du mode « Opt-out »
L’activation du mode optout
entraîne une mesure strictement limitée par le Tracker. Voir la liste des paramètres autorisés (par défaut) :
Arrays.asList("s", "vm", "vc", "mh", "idclient", "ts", "olt", "cn", "click", "type")
L’ID client prend alors la valeur « OPT-OUT » et le trafic généré se trouve dans la catégorie de trafic exclu au niveau de l’analyse.
Exemple
Privacy.setVisitorOptout();
Par défaut, les hits générés lorsque le mode Opt-out est activé sont envoyés. Vous pouvez si vous le souhaitez bloquer ces envois en surchargeant la variable de configuration du Tracker
sendHitWhenOptOut
.
Exemple
Tracker tracker = ATInternet.getInstance().getDefaultTracker(); tracker.setSendHitWhenOptOutEnabled(false, null, true); // true by default
Activation du mode « No-consent »
L’activation du mode no-consent
entraîne une mesure strictement limitée par le Tracker. Voir la liste des paramètres autorisés (par défaut) :
Arrays.asList("s", "vm", "vc", "mh", "idclient", "ts", "olt", "cn", "click", "type")
L’identifiant client prend alors la valeur « Consent-NO » et le trafic généré peut être exclu au niveau des analyses.
Exemple
Privacy.setVisitorMode(Privacy.VisitorMode.NoConsent);
Activation du mode « Opt-in »
L’activation du mode optin
entraîne une mesure exhaustive par le Tracker. Tous les paramètres sont alors conservés et envoyés. Cette méthode doit être appelée après qu’un internaute ait donné son consentement.
Exemple
Privacy.setVisitorOptIn();
Certification ACPM (OJD)
Si votre site/app est certifié par l’ACPM (OJD), vous devez autoriser le paramètre stc_device
dans votre buffer :
Privacy.extendIncludeBuffer("stc_device");Dernière mise à jour : 05/02/2021