Panoramica della libreria JavaScript per la privacy di Adobe

In qualità di responsabile del trattamento dei dati, Adobe tratta i dati personali secondo le autorizzazioni e le istruzioni della tua azienda. In qualità di Titolare del trattamento dei dati, l’utente determina i dati personali che Adobe tratta e memorizza 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). Consulta il documento sulla privacy in Adobe Experience Cloud per ulteriori informazioni su come le soluzioni Experience Cloud raccolgono dati privati.

La Libreria JavaScript per la privacy degli Adobi consente ai titolari del trattamento di automatizzare il recupero di tutte le identità degli interessati 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 i dati privati appartenenti a tali soggetti.

NOTA

Il Privacy JS Library in genere deve essere installato solo su pagine relative alla privacy e non deve essere installato su tutte le pagine di un sito web o di un dominio.

Funzioni

Il 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:

Funzione Descrizione
retrieveIdentities Restituisce una matrice di identità corrispondenti (validIds) recuperate da Privacy Service, nonché una matrice di identità non trovate (failedIds).
removeIdentities Rimuove ogni identità corrispondente (valida) dal browser. Restituisce una matrice di identità corrispondenti (validIds), con ogni identità contenente un valore booleano isDeletedClientSide che indica se l'ID è stato eliminato.
retrieveThenRemoveIdentities Recupera un array di identità corrispondenti (validIds) e quindi rimuove tali identità dal browser. Anche se questa funzione è simile a removeIdentities, è preferibile utilizzarla quando la soluzione di Adobe che stai utilizzando richiede una richiesta di accesso prima che sia possibile eliminarla (ad esempio quando è necessario recuperare un identificatore univoco prima di fornirlo in una richiesta di cancellazione).
NOTA

removeIdentities e rimuovi retrieveThenRemoveIdentities solo le identità dal browser per specifiche soluzioni di Adobe che le supportano. Ad esempio, Adobe Audience Manager non elimina gli ID demdex memorizzati nei cookie di terze parti, mentre Adobe Target elimina tutti i cookie che memorizzano gli ID.

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 seguenti metodi:

Creare un'istanza del 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, un’istanza per Adobe Analytics avrà un aspetto simile al seguente:

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

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

Esempi di codice

Gli esempi di codice seguenti mostrano come utilizzare Privacy JS Library per diversi scenari comuni, purché non si utilizzi Platform Launch.

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 di 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);
Variable Descrizione
validIds Un oggetto JSON contenente tutti gli ID recuperati correttamente.
failedIDs Un oggetto JSON contenente tutti gli ID non recuperati da Privacy Service o altrimenti non è stato possibile trovarli.

Risultato

Se il codice viene eseguito correttamente, validIDs viene compilato 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 di 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)…
Variabile Descrizione
validIds Un oggetto JSON contenente tutti gli ID recuperati correttamente.
failedIDs Un oggetto JSON contenente tutti gli ID non recuperati da Privacy Service o altrimenti non è stato possibile trovarli.

Risultato

Se il codice viene eseguito correttamente, validIDs viene compilato 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

Leggendo questo documento, sei stato introdotto alle funzionalità principali di Privacy JS Library. Dopo aver utilizzato la libreria per recuperare un elenco di identità, puoi utilizzarle per creare le richieste di accesso e di cancellazione dei dati per l’ API Privacy Service . Per ulteriori informazioni, consulta la Guida per gli sviluppatori di Privacy Service .

Appendice

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

Adobe di parametri di configurazione della soluzione

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

Adobe Analytics

Parametro Descrizione
cookieDomainPeriods Il numero di periodi in un dominio per il tracciamento dei cookie (il valore predefinito è 2).
dataCenter Adobe data center di raccolta dati. Deve essere incluso solo se è specificato nel beacon web JavaScript. I valori potenziali sono:
  • "d1": Centro dati San Jose.
  • "d2": Centro dati di Dallas.
reportSuite ID suite di rapporti come specificato nel beacon web JavaScript (ad esempio, "s_code.js" o "dtm").
trackingServer Dominio di raccolta dati (non SSL). Deve essere incluso solo se è specificato nel beacon web JavaScript.
trackingServerSecure Dominio di raccolta dati (SSL). Deve essere incluso solo se è specificato nel beacon web JavaScript.
visitorNamespace Spazio dei nomi utilizzato per raggruppare i visitatori. Deve essere incluso solo se è specificato nel beacon web JavaScript.

Adobe Target

Parametro Descrizione
clientCode Codice client che identifica un client in Adobe Target System.

Adobe Audience Manager

Parametro Descrizione
aamUUIDCookieName Nome del cookie di prime parti contenente l’ID utente univoco restituito da Adobe Audience Manager.

Servizio Adobe ID (ECID)

Parametro Descrizione
imsOrgID L’ID organizzazione IMS.

In questa pagina

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now