Översikt över JavaScript-biblioteket Adobe Privacy

Som personuppgiftsbiträde behandlar Adobe personuppgifter i enlighet med ditt företags tillstånd och instruktioner. Som personuppgiftsansvarig bestämmer du vilka personuppgifter Adobe behandlar och lagrar för din räkning. 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). Visa dokumentet på sekretess i Adobe Experience Cloud om du vill ha mer information om hur Experience Cloud lösningar samlar in privata data.

The Adobe Privacy JavaScript Library gör det möjligt för registeransvariga att automatisera hämtning av alla registrerade identiteter som genererats av Experience Cloud lösningar för en viss domän. Använda API:t från Adobe Experience Platform Privacy Servicekan dessa identiteter sedan användas för att skapa begäran om åtkomst och radering av privata data som tillhör de registrerade.

Funktioner

The 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 till Experience Cloud Central Service direkt.

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

Börja använda Privacy JS Librarymåste du installera den på datorn på något av följande sätt:

Du kan också installera biblioteket via ett taggtillägg. Se översikten på Tillägget Adobe Privacy Tag för mer information.

Instansiera Privacy JS Library

Alla program som använder Privacy JS Library måste skapa en ny 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 vilka som stöds Konfigurationsparametrar för Adobe-lösningar.

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

Följande kod definierar en funktion, handleRetrievedIDs, som används som återanrop eller löfte för att hantera identiteter som hämtas 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 validIDs innehåller en lista med 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

Följande kod definierar en funktion, handleRemovedIDs, som används som återanrop eller löfte för att hantera identiteter som hämtas av removeIdentities när 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 validIDs innehåller en lista med 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 fått en introduktion till de viktigaste funktionerna 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 Privacy Service API. Se API-guide för Privacy Service för mer information.

Bilaga

Detta avsnitt 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 instansiera ett AdobePrivacy-objekt.

Alla lösningar

Adobe Analytics

Adobe Audience Manager

Adobe Experience Cloud Identity Service (ECID)

Adobe Target