Présentation de la bibliothèque JavaScript d’Adobe Privacy

En tant que responsable du traitement des données, Adobe traite les données personnelles conformément aux autorisations et aux instructions de votre entreprise. En tant que contrôleuse ou contrôleur de données, vous déterminez les données personnelles qu’Adobe traite et stocke pour vous. En fonction des informations que vous choisissez d’envoyer par le biais des solutions Adobe Experience Cloud, Adobe peut stocker des informations privées applicables aux réglementations de confidentialité, telles que la variable General Data Protection Regulation (RGPD) et California Consumer Privacy Act (CCPA). Pour plus d’informations sur la manière dont les solutions Experience Cloud collectent les données privées, consultez le document sur la confidentialité dans Adobe Experience Cloud.

La bibliothèque JavaScript d’Adobe Privacy permet aux contrôleurs de données d’automatiser la récupération de toutes les identités des titulaires de données générées par les solutions solutions pour un domaine spécifique. Experience Cloud Grâce à l’API fournie par Adobe Experience Platform Privacy Service, ces identités peuvent ensuite être utilisées pour créer des demandes d’accès et de suppression de données privées appartenant à ces titulaires de données.

REMARQUE

Le Privacy JS Library doit généralement être installé uniquement sur les pages liées à la confidentialité et ne doit pas être installé sur toutes les pages d’un site web ou d’un domaine.

Fonctions

Le Privacy JS Library fournit plusieurs fonctions pour gérer les identités dans Privacy Service. Ces fonctions ne peuvent être utilisées que pour gérer les identités stockées dans le navigateur pour un visiteur spécifique. Ils ne peuvent pas être utilisés pour envoyer des informations à la variable Experience Cloud Central Service directement.

Le tableau suivant décrit les différentes fonctions proposées par la bibliothèque :

Fonction Description
retrieveIdentities Renvoie un tableau d’identités correspondantes (validIds) qui ont été récupérés à partir de Privacy Service, ainsi qu’un tableau d’identités introuvables (failedIds).
removeIdentities Supprime chaque identité correspondante (valide) du navigateur. Renvoie un tableau d’identités correspondantes (validIds), chaque identité contenant une valeur booléenne isDeletedClientSide qui indique si cet identifiant a été supprimé.
retrieveThenRemoveIdentities Récupère un tableau d’identités correspondantes (validIds), puis supprime ces identités du navigateur. Bien que cette fonction soit similaire à removeIdentities, il est préférable de l’utiliser lorsque la solution Adobe que vous utilisez nécessite une demande d’accès avant qu’une suppression soit possible (par exemple, lorsqu’un identifiant unique doit être récupéré avant de le fournir dans une demande de suppression).
REMARQUE

removeIdentities et retrieveThenRemoveIdentities ne suppriment les identités du navigateur que pour les solutions Adobe spécifiques qui les prennent en charge. Par exemple, Adobe Audience Manager ne supprime pas les identifiants demdex stockés dans des cookies tiers, alors qu’Adobe Target supprime tous les cookies qui stockent leurs identifiants.

Puisque les trois fonctions représentent des processus asynchrones, toutes les identités récupérées doivent être gérées à l’aide de rappels ou de promesses.

Installation

Pour commencer à utiliser la variable Privacy JS Library, vous devez l’installer sur votre machine à l’aide de l’une des méthodes suivantes :

Vous pouvez également installer la bibliothèque par le biais d’une extension de balise. Consultez la présentation de la Extension de balise de confidentialité d’Adobe pour plus d’informations.

Instanciation de la variable Privacy JS Library

Toutes les applications qui utilisent la variable Privacy JS Library doit instancier une nouvelle AdobePrivacy , qui doit être configuré sur une solution d’Adobe spécifique. Par exemple, une instanciation pour Adobe Analytics pourrait se présenter comme suit :

var adobePrivacy = new AdobePrivacy({
    imsOrgID: "{ORG_ID}",
    reportSuite: "{REPORT_SUITE_ID}",
    trackingServer: "{SERVER_URL}",
    clientCode: "{TARGET_CLIENT_CODE}"
});

Pour obtenir une liste complète des paramètres pris en charge pour les différentes solutions Adobe, reportez-vous à la section de l’annexe sur les paramètres de configuration des solutions Adobe pris en charge.

Exemples de code

Les exemples de code suivants montrent comment utiliser la variable Privacy JS Library pour plusieurs scénarios courants, à condition que vous n’utilisiez pas de balises .

Récupération d’identités

Cet exemple montre comment récupérer une liste d’identités à partir de Experience Cloud.

JavaScript

Le code suivant définit une fonction, handleRetrievedIDs, à utiliser comme rappel ou promesse pour gérer les identités récupérées par retrieveIdentities.

function handleRetrievedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.retrieveIdentities(handleRetrievedIDs);

// If using promises:
adobePrivacy.retrieveIdentities().then(handleRetrievedIDs);
Variable Description
validIds Objet JSON contenant tous les identifiants récupérés avec succès.
failedIDs Objet JSON contenant tous les identifiants qui n’ont pas été récupérés à partir de Privacy Serviceou n’a pas pu être trouvé.

Résultat

Si le code s’exécute correctement, validIDs est renseigné par une liste d’identités récupérées.

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the ID Service.",
    "value": "79352169365966186342525781172209986543"
},
{
    "company": "adobe",
    "namespace": "gsurfer_id",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao"
}

Suppression d’identités

Cet exemple montre comment supprimer une liste d’identités du navigateur.

JavaScript

Le code suivant définit une fonction, handleRemovedIDs, à utiliser comme rappel ou promesse pour gérer les identités récupérées par removeIdentities après leur suppression du navigateur.

function handleRemovedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.removeIdentities(handleRemovedIDs);

// If using promises:
adobePrivacy.removeIdentities().then(handleRemovedIDs)…
Variable Description
validIds Objet JSON contenant tous les identifiants récupérés avec succès.
failedIDs Objet JSON contenant tous les identifiants qui n’ont pas été récupérés à partir de Privacy Serviceou n’a pas pu être trouvé.

Résultat

Si le code s’exécute correctement, validIDs est renseigné par une liste d’identités récupérées.

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the ID Service.",
    "value": "79352169365966186342525781172209986543",
    "isDeletedClientSide": false
},
{
    "company": "adobe",
    "namespace": "AMO",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao",
    "isDeletedClientSide": true
}

Étapes suivantes

En lisant ce document, vous avez découvert les fonctionnalités de base de Privacy JS Library. Après avoir utilisé la bibliothèque pour récupérer une liste d’identités, vous pouvez utiliser ces identités pour créer des requêtes d’accès aux données et de suppression de données à l’ Privacy Service API. Voir Guide de l’API Privacy Service pour plus d’informations.

Annexe

Cette section contient des informations supplémentaires sur l’utilisation de la variable Privacy JS Library.

Paramètres de configuration des solutions Adobe

Voici une liste des paramètres de configuration acceptés pour les solutions Adobe prises en charge, utilisés lors de l’instanciation d’un objet AdobePrivacy.

Toutes les solutions

Paramètre Description
key Identifiant unique qui identifie l’utilisateur ou le sujet de données. Cette propriété est destinée à être utilisée à des fins de suivi interne et n’est pas utilisée par Adobe.

Adobe Analytics

Paramètre Description
cookieDomainPeriods Le nombre de points dans un domaine utilisé pour le suivi des cookies (par défaut : 2, par exemple : .domain.com). Ne le définissez pas ici, sauf indication contraire de votre balise Web JavaScript.
dataCenter Centre de données de collecte de données d’Adobe. Il ne doit être inclus que s’il est spécifié dans votre balise web JavaScript. Les valeurs potentielles sont les suivantes :
  • d1: Centre de données de San Jose
  • d2: Centre de données de Dallas
reportSuite Identifiant de suite de rapports tel que spécifié dans la balise Web JavaScript (par exemple : s_code.js ou dtm).
trackingServer Domaine de collecte de données non SSL. Il ne doit être inclus que s’il est spécifié dans votre balise web JavaScript.
trackingServerSecure Un domaine de collecte de données SSL. Il ne doit être inclus que s’il est spécifié dans votre balise web JavaScript.
visitorNamespace Espace de noms utilisé pour regrouper les visiteurs. Il ne doit être inclus que s’il est spécifié dans votre balise web JavaScript.

Adobe Audience Manager

Paramètre Description
aamUUIDCookieName Nom du cookie propriétaire contenant l’ID d’utilisateur unique renvoyé par Adobe Audience Manager.

Service Adobe Experience Cloud Identity (ECID)

Paramètre Description
imsOrgID Votre identifiant d’organisation.

Adobe Target

Paramètre Description
clientCode Code client qui identifie un client dans le système Adobe Target.

Sur cette page