Identiteitsgegevens in Web SDK

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

Dit document biedt een overzicht van het beheren van ECIDs en CORE IDs met de SDK van het Web.

ECID's bijhouden met Web SDK tracking-ecids-web-sdk

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

Wanneer een nieuwe gebruiker op uw website aankomt, probeert de Dienst van de Identiteit van Adobe Experience Cloudom een koekje van de apparatenidentificatie voor die gebruiker te plaatsen.

Nadat het cookie met 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 manieren om te werken 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.

CORE-id's bijhouden met Web SDK tracking-coreid-web-sdk

Als u Google Chrome gebruikt en cookies van derden hebt ingeschakeld en er geen kndctr_{YOUR-ORG-ID}_AdobeOrg_identity -cookie is ingesteld, wordt het eerste verzoek om Edge Network uitgevoerd via een demdex.net -domein, dat een demdex-cookie instelt. Deze cookie bevat een CORE ID . Dit is een unieke gebruiker-id die afwijkt van de ECID .

Afhankelijk van uw implementatie, zou u tot CORE ID kunnen willen toegang hebben.

Gegevensverzameling van eerste partijen first-party

Voor het eerst verzamelen van gegevens moet u cookies instellen via een CNAME -lus in uw eigen domein dat naar adobedc.net wijst.

Hoewel browsers cookies die door CNAME eindpunten zijn ingesteld lang op dezelfde manier hebben verwerkt als de cookies die door de eindpunten van de site worden ingesteld, hebben recente wijzigingen die door browsers zijn geïmplementeerd, een verschil gemaakt in de manier waarop CNAME -cookies worden verwerkt. Hoewel er momenteel 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.

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 het gebruiken van derdegegevensinzameling, beperken sommige en blokkeerders verkeer tot eindpunten van de gegevensinzameling van de Adobe.

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

Ongeacht of u eerste-partij of derdegegevensinzameling kiest, kan de tijdsduur een koekje een directe invloed op bezoekersaantallen in Adobe Analyticsen Customer Journey Analyticsaanhouden. Ook, kunnen de eindgebruikers inconsistente verpersoonlijkingservaringen ervaren wanneer Adobe Targetof Offer decisioningop de plaats 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.

FPID's (First-party device ID's) fpid

Als u rekening wilt houden met de effecten van de levensduur van cookies zoals hierboven beschreven, kunt u uw eigen apparaat-id's instellen en 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.
  });

De CORE-id voor de huidige gebruiker ophalen retrieve-coreid

Als u de CORE-id voor een gebruiker wilt ophalen, gebruikt u de opdracht getIdentity() , zoals hieronder wordt weergegeven.

alloy("getIdentity",{
  "namespaces": ["CORE"]
});

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 migrating-visitor-api-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.