DokumentationExperience PlatformDatainsamling

getIdentity

Last update: Thu Dec 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Utvecklare

När du kör kommandot sendEvent får Web SDK automatiskt besökarens identitet om det inte redan finns någon. Med kommandot getIdentity kan du hämta ett besökar-ID utan att skicka händelsedata. Om du behöver separata anrop för att generera ett besökar-ID och skicka data kan du använda det här kommandot.

Kommandot getIdentity går igenom följande flöde för att hämta ECID.

  1. Du använder Web SDK för att anropa antingen getIdentity eller appendIdentityToUrl.
  2. Web SDK väntar på medgivande.
  3. Web SDK kontrollerar om namnområdet ECID begärdes för anropet. Som standard inkluderas alltid namnutrymmet ECID.
  4. Web SDK läser cookien kndctr och returnerar dess värde som ECID, om det finns. Detta returnerar bara värdet ECID, men inte värdet regionId.
  5. Om identitetscookien kndctr inte har angetts eller namnområdet "CORE" har begärts, skickar Web SDK en begäran till Edge Network.
  6. Edge Network returnerar både ECID och regionId (och CORE ID, om det begärs).

Kör kommandot getIdentity när du anropar den konfigurerade instansen av Web SDK. Följande alternativ är tillgängliga när du konfigurerar det här kommandot:

  • namespaces: En array med namnutrymmen. Standardvärdet är ["ECID"]. Andra värden som stöds är:

    • ["CORE"]
    • ["ECID","CORE"]
    • null
    • undefined

    Du kan begära "ECID" och "CORE ID" samtidigt. Exempel: "namespaces": ["ECID","CORE"].

  • edgeConfigOverrides: Ett datastream-konfigurationsåsidosättningsobjekt.

alloy("getIdentity",{
  // This command retrieves both ECID and CORE IDs
  "namespaces": ["ECID","CORE"]
});

Svarsobjekt

Om du bestämmer dig för att hantera svar med det här kommandot är följande egenskaper tillgängliga i svarsobjektet:

  • identity.ECID: En sträng som innehåller besökarens ECID.
  • identity.CORE: En sträng som innehåller besökarens CORE ID.
  • edge.regionID: Ett heltal som representerar den Edge Network-region som webbläsaren stötte på när en identitet hämtades. Det är samma som det gamla Audience Manager positioneringstipset.
// Get the visitor's ECID
alloy('getIdentity').then(result => {
  console.log(result.identity.ECID);
});

Hämta identitet med taggtillägget Web SDK

SDK-taggtillägget för webben erbjuder inte det här kommandot via taggtilläggets användargränssnitt. Använd den anpassade kodredigeraren med JavaScript bibliotekssyntax.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1