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. 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églementations de confidentialité telles que le General Data Protection Regulation (RGPD) et le 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 Adobe Privacy JavaScript ​​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 Experience Cloud pour un domaine spécifique. 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.

Fonctions

Le Privacy JS Library 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 Experience Cloud Central Service.

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

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 le Privacy JS Library, vous devez l’installer sur votre ordinateur en utilisant l’une des méthodes suivantes :

Vous pouvez également installer la bibliothèque par le biais d’une extension de balise. Pour plus d’informations, consultez la présentation de l’extension de balise d’accès à des informations personnelles 🔗.

Instanciation du Privacy JS Library

Toutes les applications qui utilisent le Privacy JS Library doivent instancier un nouvel objet AdobePrivacy, qui doit être configuré sur une solution 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 samples

Les exemples de code suivants montrent comment utiliser le 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);

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 Visitor 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)…

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 Visitor 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 principales fonctionnalités de la 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 demandes d’accès aux données et de suppression de données vers l’API Privacy Service. Pour plus d’informations🔗 consultez le guide de l’API Privacy Service .

Annexe

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

Paramètres de configuration des solutions Adobe config-params

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

Adobe Analytics

Adobe Audience Manager

Service d’identification des visiteurs Adobe (ECID)

Adobe Target