Overzicht Adobe Privacy JavaScript Library
Als gegevensverwerker verwerkt de Adobe persoonsgegevens volgens de toestemming en instructies van uw bedrijf. Als gegevenscontrolemechanisme, bepaalt u de persoonlijke gegevens die de Adobe verwerkt en namens u 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 General Data Protection Regulation (GDPR) en California Consumer Privacy Act (CCPA). Zie het document over privacy in Adobe Experience Cloudvoor meer informatie over hoe de oplossingen van het Experience Cloud privé gegevens verzamelen.
De Bibliotheek van JavaScript van de Privacy van de Adobe staat gegevenscontrolemechanismen toe om de terugwinning van alle die gegevensonderwerpidentiteiten te automatiseren door Experience Cloud oplossingen voor een specifiek domein worden geproduceerd. Gebruikend API die door Adobe Experience Platform Privacy Servicewordt verstrekt, kunnen deze identiteiten dan worden gebruikt om toegang tot en schrappingsverzoeken voor privé gegevens tot stand te brengen die tot die gegevenssubjecten behoren.
Functies
Privacy JS Library biedt verschillende functies voor het beheer 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. Ze kunnen niet worden gebruikt om informatie rechtstreeks naar Experience Cloud Central Service te verzenden.
In de volgende tabel worden de verschillende functies beschreven die door de bibliotheek worden geboden:
retrieveIdentities
validIds
) die zijn opgehaald uit Privacy Service en een array van identiteiten die niet zijn gevonden (failedIds
).removeIdentities
validIds
), met elke identiteit die een isDeletedClientSide
boolean bevat die aangeeft of deze id is verwijderd.retrieveThenRemoveIdentities
validIds
) op, en verwijdert dan die identiteiten uit browser. Hoewel deze functie aan removeIdentities
gelijkaardig is, wordt het best gebruikt wanneer de oplossing van de Adobe u gebruikt een toegangsverzoek vereist alvorens schrapping mogelijk is (zoals wanneer een uniek herkenningsteken moet worden teruggewonnen alvorens het in een schrappingsverzoek te verstrekken).removeIdentities
en retrieveThenRemoveIdentities
verwijderen 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 Privacy JS Library wilt gaan gebruiken, moet u de toepassing op de computer installeren met een van de volgende methoden:
- Installeer met npm door de volgende opdracht uit te voeren:
npm install @adobe/adobe-privacy
- Download van de bewaarplaats van GitHub van het Experience Cloud
U kunt de bibliotheek ook installeren met een tagextensie. Zie het overzicht op de de markeringsuitbreiding van de Privacy van de Adobevoor meer informatie.
Instantiëren van de Privacy JS Library
Alle toepassingen die het Privacy JS Library gebruiken, moeten een nieuw AdobePrivacy
-object instantiëren, dat moet worden geconfigureerd voor een specifieke Adobe. 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 de Adobe, zie de bijlage sectie over gesteunde de configuratieparameters van de oplossing van de Adobe.
Codevoorbeelden samples
In de volgende codevoorbeelden wordt getoond hoe u Privacy JS Library kunt gebruiken voor verschillende algemene scenario's, op voorwaarde dat u geen tags 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
, die moet worden gebruikt als callback of promise voor het afhandelen van de identiteiten die door retrieveIdentities
zijn opgehaald.
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, wordt validIDs
gevuld met een lijst van 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
, die als callback of promise moet worden gebruikt om de identiteiten af te handelen die removeIdentities
heeft opgehaald nadat deze 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, wordt validIDs
gevuld met een lijst van 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 geïntroduceerd. Nadat u de bibliotheek hebt gebruikt om een lijst met identiteiten op te halen, kunt u deze identiteiten gebruiken om toegang tot gegevens te maken en aanvragen naar de API van Privacy Service te verwijderen. Zie de Privacy Service API gidsvoor meer informatie.
Bijlage
Deze sectie bevat aanvullende informatie voor het gebruik van Privacy JS Library .
Configuratieparameters van de oplossing Adobe config-params
Het volgende is een lijst van de toegelaten configuratieparameters voor gesteunde Adobe oplossingen, die worden gebruikt wanneer het concretiseren van een voorwerp AdobePrivacy.
Alle oplossingen
key
Adobe Analytics
cookieDomainPeriods
2
, bijvoorbeeld .domain.com
). Definieer deze hier niet, tenzij anders aangegeven in uw JavaScript-webbaken.dataCenter
Het gegevensverzamelingsdatacenter van de Adobe. Deze mag alleen worden opgenomen als dit 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
Dienst van de Identiteit van Adobe Experience Cloud (ECID)
imsOrgID
Adobe Target
clientCode