Adobe Privacy JavaScript Library - översikt

Som personuppgiftsbiträde behandlar Adobe personuppgifter i enlighet med ditt företags tillstånd och instruktioner. Som personuppgiftsansvarig avgör du vilka personuppgifter som Adobe behandlar och lagrar å dina vägnar. Beroende på vilken information du väljer att skicka via Adobe Experience Cloud-lösningar kan Adobe lagra privat information som gäller sekretessregler som General Data Protection Regulation (GDPR) och California Consumer Privacy Act (CCPA). Mer information om hur Experience Cloud lösningar samlar in privata data finns i dokumentet om sekretess i Adobe Experience Cloud.

JavaScript-biblioteket för skydd av personuppgifter för Adobe gör det möjligt för personuppgiftsansvariga att automatisera hämtning av alla registrerade identiteter som genererats av Experience Cloud-lösningar för en specifik domän. Med hjälp av API:t från Adobe Experience Platform Privacy Service kan dessa identiteter sedan användas för att skapa åtkomst- och borttagningsbegäranden för privata data som tillhör de registrerade.

Funktioner

Privacy JS Library innehåller flera funktioner för att hantera identiteter i Privacy Service. Dessa funktioner kan bara användas för att hantera identiteter som lagras i webbläsaren för en viss besökare. De kan inte användas för att skicka information direkt till Experience Cloud Central Service.

Följande tabell visar de olika funktionerna i biblioteket:

Eftersom alla tre funktionerna representerar asynkrona processer måste alla hämtade identiteter hanteras med återanrop eller löften.

Installation

Om du vill börja använda Privacy JS Library måste du installera det på datorn på något av följande sätt:

Du kan också installera biblioteket via ett taggtillägg. Mer information finns i översikten för taggtillägget Adobe Privacy.

Instansiera Privacy JS Library

Alla program som använder Privacy JS Library måste skapa en instans av ett nytt AdobePrivacy-objekt, som måste konfigureras till en viss Adobe-lösning. En instans för Adobe Analytics skulle till exempel se ut ungefär så här:

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

En fullständig lista över parametrar som stöds för olika Adobe-lösningar finns i bilagan om Adobe-lösningens konfigurationsparametrar som stöds.

Kodexempel samples

I följande kodexempel visas hur du använder Privacy JS Library för flera vanliga scenarier, förutsatt att du inte använder taggar.

Hämta identiteter

I det här exemplet visas hur du hämtar en lista med identiteter från Experience Cloud.

JavaScript

I följande kod definieras en funktion, handleRetrievedIDs, som ska användas som ett återanrop eller löfte för att hantera identiteter som hämtats av 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);

Resultat

Om koden körs utan fel fylls validIDs i med en lista över hämtade identiteter.

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

Ta bort identiteter

I det här exemplet visas hur du tar bort en lista med identiteter från webbläsaren.

JavaScript

I följande kod definieras en funktion, handleRemovedIDs, som ska användas som ett återanrop eller löfte att hantera identiteter som hämtats av removeIdentities efter att de har tagits bort från webbläsaren.

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

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

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

Resultat

Om koden körs utan fel fylls validIDs i med en lista över hämtade identiteter.

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

Nästa steg

Genom att läsa det här dokumentet har du introducerats till kärnfunktionerna i Privacy JS Library. När du har använt biblioteket för att hämta en lista över identiteter kan du använda dessa identiteter för att skapa dataåtkomst och ta bort begäranden till API:t Privacy Service. Mer information finns i Privacy Service-API-handboken.

Bilaga

Det här avsnittet innehåller ytterligare information om hur du använder Privacy JS Library.

Konfigurationsparametrar för Adobe-lösningar config-params

Nedan följer en lista över godkända konfigurationsparametrar för Adobe-lösningar som stöds, som används när ett AdobePrivacy-objekt instansieras.

Alla lösningar

Adobe Analytics

Adobe Audience Manager

Adobe Experience Cloud Identity Service (ECID)

Adobe Target