Overzicht van Adobe Privacy JavaScript-bibliotheek
Als gegevensverwerker verwerkt Adobe persoonlijke gegevens volgens de toestemming en instructies van uw bedrijf. Als datacontroller bepaalt u welke persoonlijke data Adobe namens u verwerkt en opslaat. Afhankelijk van de informatie die u kiest om via Adobe Experience Cloud-oplossingen te verzenden, kan Adobe persoonlijke informatie opslaan die van toepassing is op privacyregels zoals de General Data Protection Regulation (GDPR) en California Consumer Privacy Act (CCPA). Document weergeven op privacy in Adobe Experience Cloud voor meer informatie over hoe de oplossingen van de Experience Cloud privé gegevens verzamelen.
De Adobe Privacy JavaScript-bibliotheek staat gegevensverwerkingsverantwoordelijken toe om de terugwinning van alle gegevenssubject identiteiten te automatiseren die door Experience Cloud oplossingen voor een specifiek domein. De API van Adobe Experience Platform Privacy ServiceDeze identiteiten kunnen vervolgens worden gebruikt om toegang te verkrijgen tot en verzoeken te verwijderen voor privégegevens van deze betrokkenen.
Functies
De Privacy JS Library biedt verschillende functies voor het beheren van identiteiten in Privacy Service. Deze functies kunnen alleen worden gebruikt om de identiteiten te beheren die in de browser voor een specifieke bezoeker zijn opgeslagen. Zij kunnen niet worden gebruikt om informatie aan Experience Cloud Central Service rechtstreeks.
In de volgende tabel worden de verschillende functies beschreven die door de bibliotheek worden geboden:
retrieveIdentities
validIds
) die zijn opgehaald van Privacy Serviceen een array met identiteiten die niet zijn gevonden (failedIds
).removeIdentities
validIds
), waarbij elke identiteit een isDeletedClientSide
Boolean die aangeeft of deze id is verwijderd.retrieveThenRemoveIdentities
validIds
), en verwijdert dan die identiteiten uit browser. Hoewel deze functie vergelijkbaar is met removeIdentities
, wordt het best gebruikt wanneer de oplossing van de Adobe u gebruikt vereist een toegangsverzoek alvorens schrapping mogelijk is (zoals wanneer een uniek herkenningsteken moet worden teruggewonnen alvorens het in een schrappingsverzoek te verstrekken).removeIdentities
en retrieveThenRemoveIdentities
verwijder alleen identiteiten uit de browser voor specifieke Adobe-oplossingen die deze ondersteunen. Adobe Audience Manager verwijdert bijvoorbeeld de index-id's die zijn opgeslagen in cookies van derden niet, terwijl Adobe Target alle cookies verwijdert waarin de id's zijn opgeslagen.Aangezien alle drie functies asynchrone processen vertegenwoordigen, moeten om het even welke teruggewonnen identiteiten worden behandeld gebruikend callbacks of beloftes.
Installatie
Als u het dialoogvenster Privacy JS Library, moet u het op uw computer installeren gebruikend één van de volgende methodes:
- Installeer met npm door de volgende opdracht uit te voeren:
npm install @adobe/adobe-privacy
- Downloaden vanaf de Experience Cloud GitHub-opslagplaats
U kunt de bibliotheek ook installeren met een tagextensie. Zie het overzicht op de Adobe Privacy-tagextensie voor meer informatie .
Instantiëren van de Privacy JS Library
Alle apps die gebruikmaken van de Privacy JS Library moet een nieuw AdobePrivacy
-object, dat moet worden geconfigureerd voor een specifieke Adobe-oplossing. Een instantie voor Adobe Analytics ziet er bijvoorbeeld ongeveer als volgt uit:
var adobePrivacy = new AdobePrivacy({
imsOrgID: "{ORG_ID}",
reportSuite: "{REPORT_SUITE_ID}",
trackingServer: "{SERVER_URL}",
clientCode: "{TARGET_CLIENT_CODE}"
});
Voor een volledige lijst van gesteunde parameters voor verschillende oplossingen van Adobe, zie de bijlage sectie over gesteund Adobe-configuratieparameters voor oplossing.
Codevoorbeelden samples
De volgende codesteekproeven tonen aan hoe te om het Privacy JS Library voor verschillende algemene scenario's, op voorwaarde dat u geen labels gebruikt.
Identiteiten ophalen
In dit voorbeeld wordt getoond hoe u een lijst met identiteiten ophaalt uit Experience Cloud.
JavaScript
De volgende code definieert een functie. handleRetrievedIDs
, te gebruiken als callback of belofte om de identiteiten te behandelen die door worden teruggewonnen 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
Resultaat
Als de code met succes wordt uitgevoerd, validIDs
wordt gevuld met een lijst met opgehaalde identiteiten.
{
"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"
}
Identiteiten verwijderen
In dit voorbeeld wordt getoond hoe u een lijst met identiteiten uit de browser kunt verwijderen.
JavaScript
De volgende code definieert een functie. handleRemovedIDs
, te gebruiken als callback of belofte om de identiteiten te behandelen die door worden teruggewonnen removeIdentities
nadat ze uit de browser zijn verwijderd.
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
Resultaat
Als de code met succes wordt uitgevoerd, validIDs
wordt gevuld met een lijst met opgehaalde identiteiten.
{
"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
}
Volgende stappen
Door dit document te lezen, hebt u de kernfuncties van de Privacy JS Library. Nadat u de bibliotheek hebt gebruikt om een lijst met identiteiten op te halen, kunt u die identiteiten gebruiken om toegang tot gegevens te maken en verzoeken te verwijderen voor de Privacy Service API. Zie de Handleiding Privacy Service-API voor meer informatie .
Aanhangsel
Deze sectie bevat aanvullende informatie voor het gebruik van de Privacy JS Library.
Adobe-configuratieparameters voor oplossing config-params
Hieronder volgt een lijst met de geaccepteerde configuratieparameters voor ondersteunde Adobe-oplossingen die worden gebruikt wanneer een AdobePrivacy-object instantiëren.
Alle oplossingen
key
Adobe Analytics
cookieDomainPeriods
2
, bijvoorbeeld .domain.com
). Definieer deze hier niet, tenzij anders aangegeven in uw JavaScript-webbaken.dataCenter
Het datacenter van de gegevensverzameling Adobe. Deze mag alleen worden opgenomen als deze is opgegeven in uw JavaScript-webbaken. Mogelijke waarden zijn:
d1
: San Jose datacenterd2
: Dallas, datacenter
reportSuite
s_code.js
of dtm
).trackingServer
trackingServerSecure
visitorNamespace
Adobe Audience Manager
aamUUIDCookieName
Adobe Experience Cloud Identity Service (ECID)
imsOrgID
Adobe Target
clientCode