Show Menu
SUJETS×

Présentation de la bibliothèque JavaScript Adobe Privacy

En tant que traitement de données, Adobe traite les données personnelles conformément aux instructions et autorisations de votre société. En tant que contrôleur des données, vous déterminez les données personnelles qu’Adobe traite et stocke pour vous. Selon les informations que vous choisissez d’envoyer par le biais des solutions Adobe Experience Cloud, Adobe peut stocker des informations privées applicables aux règles de confidentialité, telles que le Règlement général sur la protection des données (GDPR) et la Loi sur la protection des renseignements personnels des consommateurs (CCPA) de Californie. Pour plus d’informations sur la manière dont les solutions Experience Cloud collectent des données privées, consultez le document sur la confidentialité dans Adobe Experience Cloud .
La bibliothèque JavaScript Adobe Privacy permet aux contrôleurs de données d’automatiser la récupération de toutes les identités de sujet de données générées par les solutions Experience Cloud pour un domaine spécifique. A l’aide de l’API fournie par Adobe Experience Platform Privacy Service , ces identités peuvent ensuite être utilisées pour créer des requêtes d’accès et de suppression de données privées appartenant à ces personnes.
En règle générale, la bibliothèque Privacy JS n'a besoin d'être installée que sur les pages liées à la confidentialité et n'est pas requise pour être installée sur toutes les pages d'un site Web ou d'un domaine.

Fonctions

La bibliothèque Privacy JS fournit plusieurs fonctions de gestion des 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 directement des informations au service Experience Cloud Central.
Le tableau suivant décrit les différentes fonctions fournies par la bibliothèque :
Fonction
Description
retrieveIdentities
Renvoie un tableau d’identités ( validIds ) correspondantes qui ont été extraites 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 isDeleteClientSide valeur booléenne indiquant 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 celle utilisée, elle est préférable lorsque la solution Adobe que vous utilisez nécessite une demande d’accès avant que la suppression ne soit possible (par exemple lorsqu’un identifiant unique doit être récupéré avant de le fournir dans une demande de suppression).
removeIdentities et retrieveThenRemoveIdentities uniquement supprimer des identités du navigateur pour des solutions Adobe spécifiques qui les prennent en charge. Par exemple, Adobe Audience Manager ne supprime pas les ID demdex stockés dans des cookies tiers, tandis qu’Adobe Cible supprime tous les cookies qui stockent leurs ID.
Puisque les trois fonctions représentent des processus asynchrones, toute identité récupérée doit être gérée à l’aide de rappels ou de promesses.

Installation

Pour début à l’aide de la bibliothèque Privacy JS, vous devez l’installer sur votre ordinateur à l’aide de l’une des méthodes suivantes :

Instanciation de la bibliothèque Privacy JS

Toutes les applications qui utilisent la bibliothèque JS Privacy doivent instancier un nouvel AdobePrivacy objet, qui doit être configuré pour une solution Adobe spécifique. Par exemple, une instanciation pour Adobe Analytics se présenterait comme suit :
var adobePrivacy = new AdobePrivacy({
    imsOrgID: "{IMS_ORG}",
    key: "{DATA_SUBJECT_ID}",
    reportSuite: "{REPORT_SUITE_ID}",
    trackingServer: "{SERVER_URL}",
    clientCode: "{TARGET_CLIENT_CODE}"
});

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

Exemples de code

Les exemples de code suivants montrent comment utiliser la bibliothèque JS Privacy pour plusieurs scénarios courants, à condition que vous n’utilisiez pas Launch ou DTM.

Récupération d’identités

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

JavaScript

Le code suivant définit une fonction, handleRetrievedIDs à utiliser comme rappel ou promesse de 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
Un objet JSON contenant tous les ID qui ont été récupérés avec succès.
failedIDs
Un objet JSON contenant tous les identifiants qui n’ont pas été récupérés de Privacy Service, ou qui n’ont pas été trouvés.

Résultats

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 de gérer les identités récupérées 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
Un objet JSON contenant tous les ID qui ont été récupérés avec succès.
failedIDs
Un objet JSON contenant tous les identifiants qui n’ont pas été récupérés de Privacy Service, ou qui n’ont pas été trouvés.

Résultats

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 été initié aux fonctionnalités de base de la bibliothèque JS Privacy. 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 l’accès aux données et supprimer des requêtes à l’API Privacy Service. Consultez le guide du développeur Privacy Service pour plus d’informations.

Annexe

Cette section contient des informations supplémentaires sur l’utilisation de la bibliothèque JS Privacy.

Paramètres de configuration de la solution 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.
Adobe Analytics
Paramètre
Description
cookieDomainPeriods
Nombre de points dans un domaine pour le suivi des cookies (la valeur par défaut est 2).
dataCenter
Centre de données de collecte de données Adobe. Ceci ne doit être inclus que s’il est spécifié dans la 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). Ceci ne doit être inclus que s’il est spécifié dans la balise Web JavaScript.
trackingServerSecure
Domaine de collecte de données (SSL). Ceci ne doit être inclus que s’il est spécifié dans la balise Web JavaScript.
visitorNamespace
Espace de nommage utilisé pour regrouper des visiteurs. Ceci ne doit être inclus que s’il est spécifié dans la balise Web JavaScript.
Adobe Target
Paramètre
Description
clientCode
Code client qui identifie un client dans Adobe Cible System.
Adobe Audience Manager
Paramètre
Description
aamUUIDCookieName
Nom du cookie propriétaire contenant l’identifiant utilisateur unique renvoyé par Adobe Audience Manager.
Adobe ID Service (ECID)
Paramètre
Description
imsOrgID
Votre ID d’organisation IMS.