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 uw eigen apparaat-id's instellen en beheren. Deze worden bedoeld als eerste-partij apparaat IDs (FPIDs).

Dit document verklaart hoe te om eerste-partijapparaat IDs voor uw implementatie van SDK van het Web 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 (First-party device ID's) gebruiken using-fpid

First-party apparaat IDs (FPIDs) houdt bezoekers door eerste-partijkoekjes te gebruiken bij. 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 DNS CNAME of JavaScript code gebruikt.

Nadat een FPID -cookie is ingesteld, kan de waarde ervan worden opgehaald en naar de Adobe worden verzonden wanneer gebeurtenisgegevens worden verzameld. Verzameld FPIDs wordt gebruikt als zaad om ECIDs te genereren. Dit blijven de primaire id's in Adobe Experience Cloud-toepassingen.

Als u een FPID voor een websitebezoeker naar de Edge Network wilt verzenden, moet u de FPID in de identityMap voor die bezoeker opnemen. Zie de sectie verderop in dit document over het gebruiken van FPIDs in identityMap voor meer informatie.

Opmaakvereisten voor eerste apparaat-id's formatting-requirements

De Edge Network 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 resulteert bijna altijd 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). UUIDs zijn alomtegenwoordig en bibliotheken zijn beschikbaar voor vrijwel elke programmeertaal om deze te genereren.

Het plaatsen van een eerstepartijkoekje van identiteitskaart in de UI van Gegevensstromen setting-cookie-datastreams

U kunt een cookienaam opgeven in de gebruikersinterface van Datastreams, waar FPID kan verblijven, eerder dan het moeten de koekjeswaarde lezen en FPID in de identiteitskaart 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 het identiteitskaart.

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 derden gebruikt, kunt u geen syncs voor id's van derden uitvoeren. Identiteitskaart van de derde baseert syncs zich op de Visitor ID dienst en UUID die door die dienst wordt geproduceerd. Wanneer u de functie voor de eerste-id gebruikt, wordt de ECID gegenereerd zonder gebruik te maken van de Visitor ID -service, waardoor syncs van andere id's niet mogelijk is.

Wanneer u eerste-partij IDs gebruikt, Audience Managermogelijkheden die aan activering in partnerplatforms worden gericht worden niet gesteund, gegeven dat de syncs van identiteitskaart van de Partner van de Audience Manager meestal op UUIDs of DIDs worden gebaseerd. De ECID die is afgeleid van een id van een eerste partij is niet gekoppeld aan een UUID , zodat deze niet-adresseerbaar is.

Een cookie instellen met uw eigen server set-cookie-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:

Wanneer stelt u het cookie in when-to-set-cookie

Het cookie FPID moet idealiter worden ingesteld voordat aanvragen bij de Edge Network worden ingediend. In situaties waarin dat niet mogelijk is, wordt een ECID echter nog steeds gegenereerd met bestaande methoden en fungeert het als de primaire id zolang het cookie bestaat.

Ervan uitgaande dat ECID uiteindelijk wordt beïnvloed door een beleid voor het verwijderen van browsers, maar FPID niet, wordt FPID de primaire id bij het volgende bezoek en wordt deze gebruikt om ECID bij elk volgend bezoek te begeleiden.

De vervaldatum van de cookie instellen set-expiration

Het instellen van de vervaldatum van een cookie moet zorgvuldig worden overwogen wanneer u de functie FPID 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 cookie-flag-impact

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 -markering een HTTPOnly -markering instelt, u een scripttaal aan de serverzijde moet gebruiken om de cookiewaarde te lezen voor opname in de identityMap .

Als u ervoor kiest dat de Edge Network de waarde van het cookie FPID leest, 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 om de cookie te lezen.

Secure secure

Cookies die zijn ingesteld met het kenmerk Secure worden alleen naar de server verzonden met een gecodeerde aanvraag via het protocol HTTPS . 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 -element in de identityMap instelt:

{
  "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 lus FPID die is opgenomen met een geverifieerde CRM ID :

{
  "identityMap": {
    "FPID": [
      {
        "id": "123e4567-e89b-42d3-9456-426614174000",
        "authenticatedState": "ambiguous",
        "primary": false
      }
    ],
    "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 authentiek moeten vangen CRM ID:

{
  "identityMap": {
    "EMAIL": [
      {
        "id": "email@mail.com",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

De volgende identityMap resulteert in een foutreactie van de Edge Network omdat deze de primary -indicator voor de FPID mist. 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}"
    }
}

FPID instellen op uw eigen domein setting-fpid-domain

Naast het instellen van de FPID in de identiteitskaart, kunt u het FPID cookie in uw eigen domein instellen als u een gegevensverzameling van de eerste partij hebt geconfigureerd CNAME .

Wanneer de inzameling van de eerste-partijgegevens gebruikend CNAME wordt toegelaten, zullen alle koekjes voor uw domein op verzoeken worden verzonden die aan het eindpunt van de gegevensinzameling worden gemaakt.

Alle cookies die niet relevant zijn voor gegevensverzamelingsdoeleinden van de Adobe, worden verwijderd. Voor FPID kunt u de naam van het FPID -cookie in de configuratie van de gegevensstroom opgeven. Wanneer u dit doet, leest de Edge Network de inhoud van het cookie FPID in plaats van naar de FPID in de identiteitskaart te zoeken.

Als u deze functionaliteit wilt gebruiken, moet u de eigenschap FPID instellen op het hoofdniveau van uw domein in plaats van op een specifiek subdomein. Als u de waarde instelt op een subdomein, wordt de waarde van het cookie niet naar de Edge Network verzonden en werkt de oplossing FPID niet naar behoren.

ID-hiërarchie id-hierarchy

Wanneer zowel een ECID als een FPID aanwezig zijn, krijgt ECID prioriteit bij het identificeren van de gebruiker. Dit zorgt ervoor dat wanneer er een bestaande ECID aanwezig is in de cookie-opslag van de browser, dit de primaire id blijft en dat het aantal bestaande bezoekers niet kan worden beïnvloed. Voor bestaande gebruikers wordt FPID pas de primaire identiteit nadat ECID is verlopen of is verwijderd als gevolg van een browserbeleid of handmatig proces.

Identiteiten krijgen prioriteit in de volgende volgorde:

Migreren naar apparaat-id's van eerste bedrijven migrating-to-fpid

Als u van een vorige implementatie naar apparaat-id's van de eerste partij migreert, kan het moeilijk zijn om te visualiseren hoe de overgang er op een laag niveau uitziet.

Om dit proces te illustreren, kunt u een scenario overwegen waarbij een klant betrokken is die eerder uw site heeft bezocht en welke invloed een FPID -migratie zou hebben op de manier waarop die klant wordt geïdentificeerd in Adobe-oplossingen.

worden bijgewerkt

Veelgestelde vragen faq

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 concept van zaaien is uniek in die zin dat 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 Edge Network wordt verzonden, wordt dezelfde ECID verzonden van de FPID .

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 nog steeds een ECID gegenereerd voor die gebruiker en wordt deze gebruikt als primaire id. De gegenereerde FPID wordt pas de primaire id wanneer ECID niet meer aanwezig is.

Welke methodes van de gegevensinzameling steunen eerste-partij apparaat IDs?

Momenteel steunt slechts Web SDK eerste-partij apparaat IDs.

Worden apparaat-id's van de eerste partij opgeslagen op een platform- of Experience Cloud-oplossing?

Nadat FPID is gebruikt om een ECID te verzenden, wordt het verwijderd uit de identityMap en vervangen door de ECID die is gegenereerd. FPID wordt niet opgeslagen in Adobe Experience Platform- of Experience Cloud-oplossingen.