DocumentatieExperience PlatformDataverzameling

getIdentity

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ontwikkelaar

Wanneer u de opdracht sendEvent uitvoert, verkrijgt de Web SDK automatisch de identiteit van de bezoeker als deze nog niet aanwezig is. Met de opdracht getIdentity kunt u een bezoeker-id verkrijgen zonder gebeurtenisgegevens te verzenden. Als u afzonderlijke vraag vereist om een bezoekersidentiteitskaart te produceren en gegevens te verzenden, kunt u dit bevel gebruiken.

De opdracht getIdentity doorloopt de volgende stroom om de ECID op te halen.

  1. U gebruikt de Web SDK om getIdentity of appendIdentityToUrl aan te roepen.
  2. Web SDK wacht op informatie over toestemming.
  3. Web SDK controleert of de naamruimte ECID is aangevraagd voor de aanroep. Standaard wordt de naamruimte ECID altijd opgenomen.
  4. Web SDK leest het kndctr -cookie en retourneert de waarde ervan als ECID , als deze bestaat. Hiermee wordt alleen de waarde ECID geretourneerd, maar niet de waarde regionId .
  5. Als het kndctr identiteitscookie niet is ingesteld of als de "CORE" -naamruimte is aangevraagd, vraagt Web SDK een aanvraag in bij de Edge Network.
  6. De Edge Network retourneert zowel de ECID als de regionId (en de CORE ID , indien gevraagd).

Voer het getIdentity bevel in werking wanneer het roepen van uw gevormde instantie van het Web SDK. De volgende opties zijn beschikbaar wanneer het vormen van dit bevel:

  • namespaces: een array van naamruimten. De standaardwaarde is ["ECID"] . Andere ondersteunde waarden zijn:

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

    U kunt "ECID" en "CORE ID" tegelijkertijd aanvragen. Voorbeeld: "namespaces": ["ECID","CORE"] .

  • edgeConfigOverrides: A ​ datastream configuratieopheffingsvoorwerp ​.

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

Object Response

Als u besluit om ​ reacties ​ met dit bevel te behandelen, zijn de volgende eigenschappen beschikbaar in het reactievoorwerp:

  • identity.ECID: Een tekenreeks die de ECID van de bezoeker bevat.
  • identity.CORE: Een tekenreeks met de CORE-id van de bezoeker.
  • edge.regionID: Een geheel getal dat het Edge Network-gebied vertegenwoordigt dat de browser detecteert bij het verkrijgen van een identiteit. Dit is hetzelfde als de oude Audience Manager-locatiehint.
// Get the visitor's ECID
alloy('getIdentity').then(result => {
  console.log(result.identity.ECID);
});

Identiteit ophalen met de webtagextensie SDK

De Web SDK-tagextensie biedt deze opdracht niet via de gebruikersinterface van de tagextensie. Gebruik de aangepaste code-editor met de syntaxis van de JavaScript-bibliotheek.

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