Identiteitsgegevens in Web SDK

Het Web SDK van Adobe Experience Platform gebruikt Adobe Experience Cloud IDs (ECIDs)om bezoekersgedrag te volgen. Met behulp van ECID's kunt u ervoor zorgen dat elk apparaat een unieke id heeft die tijdens meerdere sessies kan blijven bestaan. Hierdoor worden alle treffers die tijdens en tussen websessies plaatsvinden, aan een specifiek apparaat gekoppeld.

Dit document biedt een overzicht van hoe u ECID's kunt beheren met de Platform Web SDK.

ECID's bijhouden met de SDK

De SDK van het Web van het Platform wijst ECIDs toe en volgt door koekjes te gebruiken, met veelvoudige beschikbare methodes om te vormen hoe deze koekjes worden geproduceerd.

Wanneer een nieuwe gebruiker op uw website arriveert, probeert de Adobe Experience Cloud Identity Service een apparaatidentificatiecookie voor die gebruiker in te stellen. Voor nieuwe bezoekers wordt een ECID gegenereerd en geretourneerd in de eerste reactie van de Adobe Experience Platform-Edge Network. Voor herhaalde bezoekers wordt de ECID opgehaald uit het kndctr_{YOUR-ORG-ID}_AdobeOrg_identity -cookie en door de Edge Network toegevoegd aan de payload.

Nadat het cookie met de ECID is ingesteld, bevat elke volgende aanvraag die door de Web SDK wordt gegenereerd, een gecodeerde ECID in het kndctr_{YOUR-ORG-ID}_AdobeOrg_identity -cookie.

Wanneer u cookies gebruikt voor apparaatidentificatie, hebt u twee opties voor interactie met de Edge Network:

Zoals in de onderstaande secties wordt uitgelegd, heeft de methode voor gegevensverzameling die u kiest, een directe invloed op de levensduur van cookies in verschillende browsers.

Gegevensverzameling van derden third-party

Bij gegevensverzameling van derden worden gegevens rechtstreeks naar het domein van de Edge Network verzonden adobedc.net .

De afgelopen jaren zijn webbrowsers steeds restrictiever geworden bij het verwerken van door derden ingestelde cookies. Sommige browsers blokkeren cookies van derden standaard. Als u cookies van derden gebruikt om sitebezoekers te identificeren, is de levensduur van deze cookies vrijwel altijd korter dan wat anders beschikbaar zou zijn in plaats daarvan met cookies van de eerste fabrikant. Soms verloopt een cookie van een andere fabrikant binnen maar liefst zeven dagen.

Ook, wanneer de derdegegevensinzameling wordt gebruikt, beperken sommige en blokkeerders verkeer tot eindpunten van de gegevensinzameling van de Adobe.

Gegevensverzameling van eerste partijen first-party

De gegevensinzameling van de eerste partij impliceert het plaatsen van koekjes door een CNAME op uw eigen domein dat aan adobedc.net richt.

Terwijl browsers lange behandelde koekjes hebben die door eindpunten van CNAME op een gelijkaardige manier aan die worden geplaatst door plaats-eigenlijke eindpunten worden geplaatst, hebben de recente veranderingen die door browsers worden uitgevoerd een onderscheid in gemaakt hoe de koekjes van CNAME worden behandeld. Hoewel er geen browsers zijn die CNAME-cookies van de eerste partij standaard blokkeren, beperken sommige browsers de levensduur van cookies die met een CNAME zijn ingesteld tot slechts zeven dagen.

Effecten van de levensduur van cookies op Adobe Experience Cloud-toepassingen lifespans

Ongeacht of u gegevensverzameling van de eerste of van de derde partij kiest, heeft de tijdsduur dat een cookie kan aanhouden een directe invloed op het aantal bezoekers in Adobe Analytics en Customer Journey Analytics. Ook kunnen eindgebruikers inconsistente personalisatieervaringen ervaren wanneer Adobe Target of Offer decisioning op de site wordt gebruikt.

Neem bijvoorbeeld een situatie waarin u een personaliseringservaring hebt gemaakt waarmee elk item op de homepage wordt bevorderd als een gebruiker dit de afgelopen zeven dagen drie keer heeft bekeken.

Als een eindgebruiker drie keer per week bezoekt en vervolgens zeven dagen niet terugkeert naar de site, kan die gebruiker worden beschouwd als een nieuwe gebruiker wanneer hij of zij terugkeert naar de site omdat de cookies zijn verwijderd door een browserbeleid (afhankelijk van de browser die hij of zij gebruikte toen hij of zij de site bezocht). Als dit gebeurt, behandelt uw Analyse-hulpprogramma de bezoeker als een nieuwe gebruiker, ook al hebben ze de site iets meer dan zeven dagen geleden bezocht. Bovendien begint elke poging om de gebruikerservaring aan te passen opnieuw.

Apparaat-id's van eerste partij

Om rekening te houden met de effecten van de bovenstaande cookie levensduur, kunt u ervoor kiezen om uw eigen apparaat-id's in te stellen en te beheren. Zie de gids op eerste-partijapparaat IDsvoor meer informatie.

De ECID en het gebied voor de huidige gebruiker ophalen retrieve-ecid

Afhankelijk van uw gebruiksgeval zijn er twee manieren waarop u toegang kunt krijgen tot ECID :

De ECID ophalen via Data Prep voor gegevensverzameling retrieve-ecid-data-prep

Het gebruik Prep van Gegevens voor de Inzameling van Gegevensom ECID aan een XDM gebied in kaart te brengen. Dit is de aanbevolen manier om toegang te krijgen tot ECID .

U doet dit door het bronveld in te stellen op het volgende pad:

xdm.identityMap.ECID[0].id

Stel het doelveld vervolgens in op een XDM-pad waar het veld van het type string is.

De ECID ophalen via de opdracht getIdentity() retrieve-ecid-getidentity

Gebruik de opdracht getIdentity om de unieke ECID voor de huidige bezoeker op te halen. Voor nieuwe bezoekers die nog geen ECID hebben, genereert deze opdracht een nieuwe ECID . getIdentity retourneert ook de regio-id voor de bezoeker.

alloy("getIdentity")
  .then(function(result) {
    // The command succeeded.
    console.log("ECID:", result.identity.ECID);
    console.log("RegionId:", result.edge.regionId);
  })
  .catch(function(error) {
    // The command failed.
    // "error" will be an error object with additional information.
  });

identityMap gebruiken using-identitymap

Gebruikend een XDM identityMap gebied, kunt u een apparaat/een gebruiker identificeren gebruikend veelvoudige identiteiten, hun authentificatiestatus plaatsen, en beslissen welke herkenningsteken als primaire wordt beschouwd. Als er geen id is ingesteld als primary , wordt standaard de waarde ECID gebruikt.

identityMap -velden worden bijgewerkt met de opdracht sentEvent .

alloy("sendEvent", {
  xdm: {
    "identityMap": {
      "ID_NAMESPACE": [ // Notice how each namespace can contain multiple identifiers.
        {
          "id": "1234",
          "authenticatedState": "authenticated",
          "primary": true
        }
      ]
    }
  }
});

Elk bezit binnen identityMap vertegenwoordigt identiteiten die tot een bepaalde identiteit namespacebehoren. De bezitsnaam zou het symbool van identiteitskaart namespace moeten zijn, die u in het gebruikersinterface van Adobe Experience Platform onder "Identities"kunt vinden. De eigenschapswaarde moet een array zijn met identiteiten die betrekking hebben op die naamruimte identity.

Elk identiteitsobject in de array identities bevat de volgende eigenschappen:

Als u het veld identityMap gebruikt om apparaten of gebruikers te identificeren, leidt dit tot hetzelfde resultaat als wanneer u de methode setCustomerIDsvan de ID Service API . Zie de API documentatie van de Dienst van identiteitskaartvoor meer details.

Migreren van Bezoeker-API naar ECID

Wanneer u migreert vanuit de Bezoeker-API, kunt u ook bestaande AMCV-cookies migreren. Als u ECID-migratie wilt inschakelen, stelt u de parameter idMigrationEnabled in de configuratie in. Bij ID-migratie zijn de volgende gebruiksgevallen mogelijk:

Functies voor migratie bijwerken

Wanneer gegevens met XDM-indeling naar Audience Manager worden verzonden, moeten deze gegevens tijdens het migreren naar signalen worden geconverteerd. Uw kenmerken moeten worden bijgewerkt om de nieuwe sleutels te weerspiegelen die XDM verstrekt. Dit proces wordt gemakkelijker gemaakt door het hulpmiddel BAAAMte gebruiken dat de Audience Manager heeft gecreeerd.

Gebruiken in gebeurtenis door:sturen

Als u momenteel gebeurtenis door:sturentoegelaten hebt en appmeasurement.js en visitor.js gebruikt, kunt u toegelaten gebeurtenis-door:sturen eigenschap houden en dit zal geen kwesties veroorzaken. Op het achterste eind, haalt de Adobe om het even welke AAM segmenten en voegt hen aan de vraag aan Analytics toe. Als de vraag aan Analytics die segmenten bevat, zal Analytics geen Audience Manager roepen om het even welke gegevens door:sturen, zodat is er geen dubbele gegevensinzameling. Er is ook geen behoefte aan de Hint van de Plaats wanneer het gebruiken van SDK van het Web omdat de zelfde segmentatie eindpunten in het achtereind worden geroepen.