Identitetsdata i Web SDK

Adobe Experience Platform Web SDK använder Adobe Experience Cloud ID (ECID) för att spåra besökares beteende. Med hjälp av ECID:n kan du se till att varje enhet har en unik identifierare som kan finnas kvar i flera sessioner och koppla alla träffar som inträffar under och mellan webbsessioner till en viss enhet.

I det här dokumentet finns en översikt över hur du hanterar ECID:n med Platform Web SDK.

Spåra ECID:n med SDK

Platform Web SDK tilldelar och spårar ECID:n med hjälp av cookies, med flera tillgängliga metoder för att konfigurera hur dessa cookies genereras.

När en ny användare kommer till din webbplats försöker Adobe Experience Cloud Identity Service att ange en cookie för enhetsidentifiering för den användaren. För förstagångsbesökare genereras ett ECID som returneras i det första svaret från Adobe Experience Platform Edge Network. För återkommande besökare hämtas ECID från kndctr_{YOUR-ORG-ID}_AdobeOrg_identity cookie och har lagts till i nyttolasten av Edge Network.

När cookie-filen som innehåller ECID har ställts in innehåller varje efterföljande begäran som genererats av Web SDK ett kodat ECID i kndctr_{YOUR-ORG-ID}_AdobeOrg_identity cookie.

När du använder cookies för enhetsidentifiering har du två alternativ för att interagera med Edge Network:

Som förklaras i avsnitten nedan har den datainsamlingsmetod som du väljer att använda en direkt inverkan på cookie-livstiden i olika webbläsare.

Datainsamling från tredje part third-party

Insamling av data från tredje part innebär att data skickas direkt till Edge Network-domänen adobedc.net.

Under de senaste åren har webbläsare blivit allt mer restriktiva när det gäller hantering av cookies som fastställs av tredje part. Vissa webbläsare blockerar cookies från tredje part som standard. Om du använder cookies från tredje part för att identifiera webbplatsbesökare är livslängden för dessa cookies nästan alltid kortare än vad som annars skulle vara tillgängligt med cookies från första part i stället. Ibland upphör en cookie från tredje part om så lite som sju dagar.

När datainsamling från tredje part används begränsar vissa annonsblockerare dessutom trafiken till slutpunkterna för datainsamling i Adobe helt och hållet.

Insamling av data från första part first-party

Första parts datainsamling innebär att cookies ställs in via en CNAME på din egen domän som pekar på adobedc.net.

Webbläsare har långa behandlade cookies som anges av CNAME-slutpunkter på ungefär samma sätt som de som anges av webbplatsägda slutpunkter, men de senaste ändringarna som implementeras av webbläsare har gjort en skillnad i hur CNAME-cookies hanteras. Det finns inga webbläsare som blockerar CNAME-cookies från första part som standard, men vissa webbläsare begränsar livstiden för cookies som anges med CNAME till endast sju dagar.

Effekter av livscykeln för cookies i Adobe Experience Cloud-program lifespans

Oavsett om du väljer datainsamling från första part eller från tredje part har den tid en cookie kan finnas kvar en direkt inverkan på antalet besökare i Adobe Analytics och Customer Journey Analytics. Slutanvändare kan dessutom uppleva inkonsekventa personaliseringsupplevelser när Adobe Target eller Offer decisioning används på webbplatsen.

Tänk dig till exempel en situation där du har skapat en personaliseringsupplevelse som befordrar ett objekt till hemsidan om en användare har visat det tre gånger under de senaste sju dagarna.

Om en slutanvändare besöker webbplatsen tre gånger i veckan och sedan inte återvänder till webbplatsen på sju dagar, kan den användaren betraktas som en ny användare när han eller hon kommer tillbaka till webbplatsen, eftersom deras cookies kan ha tagits bort av en webbläsarprincip (beroende på vilken webbläsare användaren använde när han eller hon besökte webbplatsen). Om detta inträffar behandlar analysverktyget besökaren som en ny användare även om de besökte webbplatsen för bara drygt sju dagar sedan. Alla försök att personalisera upplevelsen för användaren börjar också om.

Enhets-ID:n från första part

Om du vill ta hänsyn till effekterna av cookie-livscykler enligt ovan kan du välja att ställa in och hantera dina egna enhetsidentifierare i stället. Se guiden på enhets-ID:n från första part för mer information.

Hämtar ECID och region för den aktuella användaren

Om du vill hämta den aktuella besökarens unika ECID använder du getIdentity -kommando. För förstagångsbesökare som ännu inte har ett ECID genereras ett nytt ECID med det här kommandot. getIdentity returnerar också region-ID för besökaren.

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.
  });

Använda identityMap

Använda en XDM identityMap fältkan du identifiera en enhet/användare med flera identiteter, ange deras autentiseringstillstånd och avgöra vilken identifierare som ska vara den primära. Om ingen identifierare har angetts som primary, blir det primära standardvärdet ECID.

identityMap fälten uppdateras med sentEvent -kommando.

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

Varje egenskap i identityMap representerar identiteter som tillhör en viss namnutrymme för identitet. Egenskapsnamnet ska vara identitetssymbolen för namnutrymmet, som du hittar i användargränssnittet i Adobe Experience Platform under "Identities". Egenskapsvärdet ska vara en array med identiteter som gäller det identitetsnamnutrymmet.

Varje identitetsobjekt i identitetsarrayen innehåller följande egenskaper:

Använda identityMap fält för att identifiera enheter eller användare leder till samma resultat som om du använder setCustomerIDs metoden från ID Service API. Se API-dokumentation för ID-tjänst för mer information.

Migrera från Visitor API till ECID

När du migrerar från med Visitor API kan du även migrera befintliga AMCV-cookies. Om du vill aktivera ECID-migrering anger du idMigrationEnabled -parametern i konfigurationen. ID-migrering aktiverar följande användningsfall:

Uppdaterar egenskaper för migrering

När XDM-formaterade data skickas till Audience Manager måste dessa data konverteras till signaler vid migrering. Dina egenskaper måste uppdateras för att återspegla de nya nycklarna som finns i XDM. Den här processen blir enklare om du använder BAAAM-verktyget som Audience Manager har skapat.

Använd vid vidarebefordran av händelse

Om du har händelsevidarebefordran aktiverat och använder appmeasurement.js och visitor.jskan du behålla funktionen för vidarebefordran av händelser aktiverad och detta kommer inte att orsaka några problem. På baksidan hämtar Adobe alla AAM segment och lägger till dem i anropet till Analytics. Om anropet till Analytics innehåller dessa segment kommer Analytics inte att anropa Audience Manager för att vidarebefordra data, så det finns ingen dubbel datainsamling. Du behöver heller inte använda platstips när du använder Web SDK eftersom samma segmenteringsslutpunkter anropas i serverdelen.