Eerste-partij apparaat IDs in Web SDK
SDK van het Web van Adobe Experience Platform wijst Adobe Experience Cloud IDs (ECIDs)aan websitebezoekers door koekjes te gebruiken toe, om gebruikersgedrag te volgen. Als u browserbeperkingen voor de levensduur van cookies wilt compenseren, kunt u ervoor kiezen om uw eigen apparaat-id's in te stellen en te beheren. Deze worden ook wel FPID's (First-Party Device ID's) genoemd.
U kunt apparaat-id's van andere leveranciers gebruiken of cookies van andere leveranciers, maar u kunt beide functies niet tegelijkertijd gebruiken.
Dit document behandelt hoe te om eerste-partijapparaat IDs voor uw implementatie van SDK van het Web van het Platform te vormen.
Vereisten
Deze gids veronderstelt u vertrouwd met bent hoe de identiteitsgegevens voor het Web SDK van het Platform, met inbegrip van de rol van ECIDs en identityMap
werken. Zie het overzicht op identiteitsgegevens in het Web SDKvoor meer informatie.
FPID's gebruiken
FPID's volgen bezoekers met behulp van cookies van de eerste partij. De koekjes van de eerste partij zijn het meest efficiënt wanneer zij gebruikend een server worden geplaatst die een DNS verslag van A(voor IPv4) of het verslag van AAAA(voor IPv6), in tegenstelling tot een DNS CNAME of code van JavaScript gebruikt.
A
- of AAAA
-records worden alleen ondersteund voor het instellen en bijhouden van cookies. De primaire methode voor gegevensinzameling is door DNS CNAME. Met andere woorden, FPID's worden ingesteld met een A-record of AAAA-record en worden vervolgens naar de Adobe verzonden met een CNAME.Nadat een FPID-cookie is ingesteld, kan de waarde ervan worden opgehaald en naar de Adobe worden verzonden wanneer gebeurtenisgegevens worden verzameld. Verzamelde FPID's worden gebruikt als zaden om ECID's te genereren, die in Adobe Experience Cloud-toepassingen nog steeds de belangrijkste identificatoren zijn.
Als u een FPID voor een websitebezoeker naar de Edge Network Platform wilt verzenden, moet u de FPID opnemen in de identityMap
voor die bezoeker. Zie de sectie later in dit document op gebruikend FPIDs in identityMap
voor meer informatie.
Vereisten voor id-opmaak
De Edge Network van het Platform keurt slechts IDs goed die aan het formaat UIDv4voldoen. Apparaat-id's die niet de UUIDv4-indeling hebben, worden geweigerd.
Het genereren van een UUID zal bijna altijd resulteren in een unieke, willekeurige id, waarbij de kans dat een botsing optreedt verwaarloosbaar is. UUIDv4 kan niet worden verzonden gebruikend IP adressen of een andere persoonlijke identificeerbare informatie (PII). UUID's zijn alomtegenwoordig en bibliotheken kunnen voor vrijwel elke programmeertaal worden gevonden om ze te genereren.
Het plaatsen van een koekje van eerste partijidentiteitskaart in de UI van Gegevensstromen setting-cookie-datastreams
U kunt een cookienaam in de UI van Datastreams specificeren, waar FPID kan verblijven, eerder dan het moeten de koekjeswaarde lezen en FPID in de kaart van de Identiteit omvatten.
Zie de documentatie van gegevensstromenvoor gedetailleerde informatie over hoe te om een gegevensstroom te vormen.
Schakel de optie First Party ID Cookie in wanneer u de gegevensstroom configureert. Dit het plaatsen vertelt de Edge Network om naar een gespecificeerd koekje te verwijzen wanneer het opzoeken van eerste-partijapparaat identiteitskaart, eerder dan het opzoeken van deze waarde in de Kaart van de Identiteit.
Zie de documentatie op eerste-partijkoekjesvoor meer details over hoe zij met Adobe Experience Cloud werken.
benadrukt
Als u deze instelling inschakelt, moet u de naam opgeven van het cookie waarop de id moet worden opgeslagen.
Als u ID's van eerste partijen gebruikt, kunt u geen synchronisatie van id's van derden uitvoeren. Identiteitssynces van derden vertrouwen op de Visitor ID -service en de UUID
die door die service worden gegenereerd. Wanneer u de functie voor de eerste id gebruikt, wordt de ECID gegenereerd zonder gebruik te maken van de Visitor ID -service, waardoor syncs voor andere id's niet mogelijk is.
Wanneer u eerste partij IDs gebruikt, worden de mogelijkheden van de Audience Manager die op activering in partnerplatforms worden gericht niet gesteund, gegeven dat de syncs van identiteitskaart van de Partner van de Audience Manager meestal gebaseerd op UUIDs
of DIDs
zijn. De ECID die is afgeleid van een ID van de eerste partij is niet gekoppeld aan een UUID
, waardoor deze niet-adresseerbaar is.
Een cookie instellen met uw eigen server
Wanneer u een cookie instelt met een server die u bezit, kunt u verschillende methoden gebruiken om te voorkomen dat het cookie wordt beperkt door het browserbeleid:
- Cookies genereren met scripttalen op de server
- Cookies instellen als reactie op een API-aanvraag die is uitgevoerd naar een subdomein of ander eindpunt op de site
- Cookies genereren met behulp van een CMS
- Cookies genereren met behulp van een CDN
document.cookie
worden bijna nooit beschermd tegen browserbeleid dat de duur van cookies beperkt.Wanneer stelt u het cookie in
Het FPID-cookie moet idealiter worden ingesteld voordat aanvragen bij de Edge Network worden ingediend. In gevallen waarin dat niet mogelijk is, wordt een ECID echter nog steeds gegenereerd met behulp van bestaande methoden en fungeert deze als primaire id zolang het cookie bestaat.
Ervan uitgaande dat de ECID uiteindelijk wordt beïnvloed door een beleid voor het verwijderen van de browser, maar de FPID niet, wordt de FPID bij het volgende bezoek de primaire identificator en wordt deze gebruikt om de ECID bij elk volgend bezoek te bezaaien.
De vervaldatum van de cookie instellen
Het instellen van de vervaldatum van een cookie moet zorgvuldig worden overwogen wanneer u de FPID-functionaliteit implementeert. Wanneer u hierover beslist, moet u rekening houden met de landen of regio's waarin uw organisatie werkt, samen met de wetten en het beleid in elk van die regio's.
Als onderdeel van dit besluit wilt u mogelijk een beleid voor het instellen van cookies in het hele bedrijf toepassen of een beleid dat per landinstelling verschilt.
Ongeacht de instelling die u kiest voor de aanvankelijke vervaldatum van een cookie, moet u logica opnemen die de vervaldatum van de cookie verlengt telkens wanneer een nieuw bezoek aan de site plaatsvindt.
Gevolgen van cookie-vlaggen
Er zijn verschillende cookiemarkeringen die van invloed zijn op de manier waarop cookies in verschillende browsers worden verwerkt:
HTTPOnly
http-only
Cookies die zijn ingesteld met de markering HTTPOnly
, zijn niet toegankelijk met clientscripts. Dit betekent dat als u bij het instellen van de FPID een markering HTTPOnly
instelt, u een scripttaal aan de serverzijde moet gebruiken om de cookiewaarde voor opname in identityMap
te lezen.
Als u ervoor kiest om de Edge Network Platform de waarde van het FPID-cookie te laten lezen, zorgt het instellen van de markering HTTPOnly
ervoor dat de waarde niet toegankelijk is voor clientscripts, maar geen negatieve invloed heeft op de mogelijkheid van de Edge Network van het Platform om de cookie te lezen.
HTTPOnly
heeft geen invloed op het cookiebeleid dat de levensduur van cookies kan beperken. Het is echter nog steeds iets wat u moet overwegen wanneer u de waarde van de FPID instelt en leest.Secure
secure
Cookies die zijn ingesteld met het kenmerk Secure
worden alleen verzonden naar de server met een gecodeerde aanvraag via het HTTPS-protocol. Door deze markering te gebruiken, kunt u ervoor zorgen dat aanvallers van 'man in the middle' de waarde van het cookie niet gemakkelijk kunnen benaderen. Het is altijd verstandig om de markering Secure
in te stellen, als dat mogelijk is.
SameSite
same-site
Met het kenmerk SameSite
kunnen servers bepalen of cookies worden verzonden met aanvragen die verwijzen naar andere sites. Het kenmerk biedt enige bescherming tegen valsemunterij op andere locaties. Er zijn drie mogelijke waarden: Strict
, Lax
en None
. Raadpleeg uw interne team om te bepalen welke instelling geschikt is voor uw organisatie.
Als er geen kenmerk SameSite
is opgegeven, is de standaardinstelling voor sommige browsers nu SameSite=Lax
.
FPID's gebruiken in identityMap
identityMap
Hieronder ziet u een voorbeeld van hoe u een FPID instelt in de identityMap
:
{
"identityMap": {
"FPID": [
{
"id": "123e4567-e89b-42d3-9456-426614174000",
"authenticatedState": "ambiguous",
"primary": true
}
]
}
}
Net als bij andere identiteitstypen kunt u de FPID opnemen met andere identiteiten in identityMap
. Hieronder ziet u een voorbeeld van de FPID die is opgenomen in een geautoriseerde CRM-id:
{
"identityMap": {
"FPID": [
{
"id": "123e4567-e89b-42d3-9456-426614174000",
"authenticatedState": "ambiguous",
"primary": true
}
],
"EMAIL": [
{
"id": "email@mail.com",
"authenticatedState": "authenticated",
"primary": true
}
]
}
}
Als FPID in een koekje bevat dat door de Edge Network wordt gelezen wanneer de inzameling van de eerste-partijgegevens wordt toegelaten, zou u slechts voor authentiek verklaarde identiteitskaart van CRM moeten vangen:
{
"identityMap": {
"EMAIL": [
{
"id": "email@mail.com",
"authenticatedState": "authenticated",
"primary": true
}
]
}
}
De volgende identityMap
resulteert in een foutreactie van de Edge Network omdat de indicator primary
voor de FPID ontbreekt. Ten minste een van de id's in identityMap
moet zijn gemarkeerd als primary
.
{
"identityMap": {
"FPID": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"authenticatedState": "ambiguous"
}
],
"EMAIL": [
{
"id": "email@mail.com",
"authenticatedState": "authenticated"
}
]
}
}
De foutreactie die in dit geval door de Edge Network wordt gegeven, is vergelijkbaar met de volgende:
{
"type": "https://ns.adobe.com/aep/errors/EXEG-0306-400",
"status": 400,
"title": "No primary identity set in request (event)",
"detail": "No primary identity found in the input event. Update the request accordingly to your schema and try again.",
"report": {
"requestId": "{REQUEST_ID}",
"configId": "{CONFIG_ID}",
"orgId": "{ORG_ID}"
}
}
ID-hiërarchie
Wanneer zowel een ECID als een FPID aanwezig zijn, krijgt de ECID prioriteit bij het identificeren van de gebruiker. Dit zorgt ervoor dat wanneer een bestaande ECID aanwezig is in de browser cookie store, deze de primaire id blijft en dat het aantal bestaande bezoekers niet kan worden beïnvloed. Voor bestaande gebruikers wordt de FPID pas de primaire identiteit als de ECID verloopt of als gevolg van een browserbeleid of handmatig proces wordt verwijderd.
Identiteiten krijgen prioriteit in de volgende volgorde:
- ECID opgenomen in de
identityMap
- ECID opgeslagen in een cookie
- FPID opgenomen in de
identityMap
- FPID opgeslagen in een cookie
Migreren naar apparaat-id's van eerste bedrijven
Als u naar het gebruiken van FPIDs van een vorige implementatie migreert, kan het moeilijk zijn om te visualiseren hoe de overgang op een laag niveau zou kunnen kijken.
Om dit proces te illustreren, overweeg een scenario dat een klant impliceert die eerder uw plaats heeft bezocht en welke invloed een migratie FPID op hoe zou hebben die klant in de oplossingen van de Adobe wordt geïdentificeerd.
worden bijgewerkt
ECID
krijgt altijd voorrang boven FPID
.Veelgestelde vragen
Hieronder volgt een lijst met antwoorden op veelgestelde vragen over apparaat-id's van andere leveranciers.
Hoe anders zaait u een id dan eenvoudig een id genereren?
Het begrip zaaien is uniek omdat de FPID die aan Adobe Experience Cloud wordt doorgegeven, wordt omgezet in een ECID met behulp van een deterministisch algoritme. Telkens wanneer dezelfde FPID naar de Adobe Experience Platform-Edge Network wordt verzonden, wordt dezelfde ECID van de FPID verzonden.
Wanneer moet de apparaat-id van de eerste partij worden gegenereerd?
Om potentiële bezoekersinflatie te verminderen, zou FPID moeten worden geproduceerd alvorens uw eerste verzoek te maken gebruikend SDK van het Web. Als u dit echter niet kunt doen, wordt er nog steeds een ECID gegenereerd voor die gebruiker en wordt deze gebruikt als primaire id. De gegenereerde FPID wordt pas de primaire id als de ECID niet meer aanwezig is.
Welke methodes van de gegevensinzameling steunen eerste-partij apparaat IDs?
Momenteel steunt slechts Web SDK FPIDs.
Worden FPIDs opgeslagen op om het even welk platform of Experience Cloud oplossingen?
Nadat de FPID is gebruikt om een ECID te verzenden, wordt deze verwijderd uit de identityMap
en vervangen door de gegenereerde ECID. De FPID wordt niet opgeslagen in Adobe Experience Platform- of Experience Cloud-oplossingen.