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 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) Vedi il documento su privacy in Adobe Experience Cloud per ulteriori informazioni su come le soluzioni Experience Cloud raccolgono dati privati.
Il Libreria JavaScript di Adobe Privacy consente ai titolari del trattamento dei dati di automatizzare il recupero di tutte le identità delle persone interessate generate da Experience Cloud soluzioni 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 di dati privati appartenenti a tali persone interessate.
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 al Experience Cloud Central Service direttamente.
La tabella seguente illustra le diverse funzioni fornite dalla libreria:
retrieveIdentities
validIds
) recuperati da Privacy Service, nonché un array di identità che non sono state trovate (failedIds
).removeIdentities
validIds
), con ogni identità contenente un isDeletedClientSide
booleano che indica se questo ID è stato eliminato.retrieveThenRemoveIdentities
validIds
) e rimuove tali identità dal browser. Questa funzione è simile a removeIdentities
, è indicato quando la soluzione di Adobe in uso 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 eliminazione).removeIdentities
e retrieveThenRemoveIdentities
rimuovi le identità dal browser solo 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 i loro 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:
- Eseguire l'installazione utilizzando npm eseguendo il comando seguente:
npm install @adobe/adobe-privacy
- Scarica da Experience Cloud archivio GitHub
Puoi anche installare la libreria tramite un’estensione tag. Consulta la panoramica su Estensione tag Adobe Privacy per ulteriori informazioni.
Crea un'istanza di Privacy JS Library
Tutte le app che utilizzano Privacy JS Library deve creare un'istanza di un nuovo AdobePrivacy
oggetto, 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 relativa ai parametri supportati Adobe di parametri di configurazione della soluzione.
Esempi di codice samples
Gli esempi di codice seguenti mostrano 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 che segue definisce una funzione, handleRetrievedIDs
, da utilizzare come callback o promessa per la gestione delle 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);
validIds
failedIDs
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 che segue definisce una funzione, handleRemovedIDs
, da utilizzare come callback o promessa per la gestione delle identità recuperate da removeIdentities
dopo che sono stati rimossi 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)…
validIds
failedIDs
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
Una volta letto questo documento, potrai conoscere le funzionalità principali di Privacy JS Library. Dopo aver utilizzato la libreria per recuperare un elenco di identità, puoi utilizzarle per creare richieste di accesso e di cancellazione dei dati a Privacy Service API. Consulta la Guida all’API di Privacy Service per ulteriori informazioni.
Appendice
Questa sezione contiene informazioni supplementari sull'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 quando creazione di un'istanza di un oggetto AdobePrivacy.
Tutte le soluzioni
key
Adobe Analytics
cookieDomainPeriods
2
, ad es. .domain.com
). Non definirlo qui a meno che non sia specificato nel beacon web JavaScript.dataCenter
L’Adobe di data collection center. Questo deve essere incluso solo se è specificato nel beacon web JavaScript. I valori potenziali sono:
d1
: data center di San Josed2
: datacenter di Dallas
reportSuite
s_code.js
o dtm
).trackingServer
trackingServerSecure
visitorNamespace
Adobe Audience Manager
aamUUIDCookieName
Servizio Adobe Experience Cloud Identity (ECID)
imsOrgID
Adobe Target
clientCode