Panoramica della libreria JavaScript di Adobe Privacy

In qualità di responsabile del trattamento dei dati, Adobe tratta i dati personali in conformità alle autorizzazioni e alle istruzioni dell’azienda. In qualità di titolare del trattamento dei dati, l’utente determina i dati personali che Adobe tratta e archivia per suo conto. A seconda delle informazioni che scegli di inviare tramite le soluzioni Adobe Experience Cloud, Adobe può memorizzare informazioni private applicabili alle normative sulla privacy come General Data Protection Regulation (RGPD) e California Consumer Privacy Act (CCPA). Per ulteriori informazioni sulla raccolta di dati privati da parte delle soluzioni Experience Cloud, consulta il documento sulla privacy in Adobe Experience Cloud.

La Adobe Privacy JavaScript Library consente ai titolari del trattamento dei dati di automatizzare il recupero di tutte le identità delle persone interessate generate dalle soluzioni Experience Cloud per un dominio specifico. Utilizzando l'API fornita da Adobe Experience Platform Privacy Service, queste identità possono quindi essere utilizzate per creare richieste di accesso ed eliminazione per dati privati appartenenti a tali interessati.

Funzioni

Privacy JS Library fornisce diverse funzioni per la gestione delle identità in Privacy Service. Queste funzioni possono essere utilizzate solo per gestire le identità memorizzate nel browser per un visitatore specifico. Non possono essere utilizzati per inviare informazioni direttamente a Experience Cloud Central Service.

La tabella seguente illustra le diverse funzioni fornite dalla libreria:

Poiché tutte e tre le funzioni rappresentano processi asincroni, tutte le identità recuperate devono essere gestite utilizzando callback o promesse.

Installazione

Per iniziare a utilizzare Privacy JS Library, è necessario installarlo nel computer utilizzando uno dei metodi seguenti:

Puoi anche installare la libreria tramite un’estensione tag. Per ulteriori informazioni, consulta la panoramica sull'estensione tag Adobe Privacy.

Crea istanza di Privacy JS Library

Tutte le app che utilizzano Privacy JS Library devono creare un'istanza di un nuovo oggetto AdobePrivacy, che deve essere configurato per una soluzione di Adobe specifica. Ad esempio, la creazione di un’istanza per Adobe Analytics sarà simile alla seguente:

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

Per un elenco completo dei parametri supportati per le diverse soluzioni Adobe, consulta la sezione dell'appendice sui parametri di configurazione della soluzione Adobe supportati.

Esempi di codice samples

Negli esempi di codice seguenti viene illustrato come utilizzare Privacy JS Library per diversi scenari comuni, purché non si utilizzino i tag.

Recupera identità

Questo esempio illustra come recuperare un elenco di identità da Experience Cloud.

JavaScript

Il codice seguente definisce una funzione, handleRetrievedIDs, da utilizzare come callback o promessa per gestire le identità recuperate da 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);

Risultato

Se il codice viene eseguito correttamente, validIDs viene popolato con un elenco di identità recuperate.

{
    "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"
}

Rimuovi le identità

Questo esempio illustra come rimuovere un elenco di identità dal browser.

JavaScript

Il codice seguente definisce una funzione, handleRemovedIDs, da utilizzare come callback o promessa per gestire le identità recuperate da removeIdentities dopo che sono state rimosse dal browser.

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

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

// If using promises:
adobePrivacy.removeIdentities().then(handleRemovedIDs)…

Risultato

Se il codice viene eseguito correttamente, validIDs viene popolato con un elenco di identità recuperate.

{
    "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
}

Passaggi successivi

Dopo aver letto questo documento, potrai conoscere le funzionalità principali di Privacy JS Library. Dopo aver utilizzato la libreria per recuperare un elenco di identità, è possibile utilizzare tali identità per creare richieste di accesso e di eliminazione dei dati per l'API Privacy Service. Per ulteriori informazioni, consulta la guida dell'API Privacy Service.

Appendice

Questa sezione contiene informazioni supplementari per l'utilizzo di Privacy JS Library.

Adobe di parametri di configurazione della soluzione config-params

Di seguito è riportato un elenco dei parametri di configurazione accettati per le soluzioni Adobe supportate, utilizzati durante la creazione di un'istanza di un oggetto AdobePrivacy🔗.

Tutte le soluzioni

Adobe Analytics

Adobe Audience Manager

Servizio Adobe Experience Cloud Identity (ECID)

Adobe Target