Identiteitskaart gebruiken in Gegevensverzameling

Het identityMap voorwerp van de nuttige lading is hoe u Edge Network vertelt die een bezoeker voorbij hun apparaat-niveau ​ ECID ​ is. Wanneer een bezoeker zich aanmeldt, een aankoop voltooit of anderszins bekend wordt, kunt u id's op persoonlijke niveau (CRM-id, gehashte e-mail, loyalty-id, enz.) naast de ECID verzenden. Deze personen-vlakke herkenningstekens verstrekken waardevolle informatie aan stroomafwaartse diensten zodat zij kunnen:

Op deze pagina wordt uitgelegd hoe u identityMap -ladingen kunt samenstellen, de juiste instellingen voor elke identiteit kunt kiezen en algemene implementatiescenario's kunt afhandelen.

Payloadstructuur structure

identityMap is een JSON-object waarbij elke sleutel op hoofdniveau een naamruimte is en de waarde een array van identiteitsbeschrijvingen is. U kunt een of meer naamruimten opnemen in één lading en elke beschrijver bevat drie gebieden: id, authenticatedState, en primary.

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

In de onderstaande secties wordt elk deel van de lading in detail beschreven.

Naamruimtesleutels namespace-keys

Elke top-level sleutel in identityMap is een ​ identiteit namespace ​ — een koord dat het type van herkenningsteken (bijvoorbeeld, CRMID, Email, Phone, of LoyaltyId) classificeert. Naamruimten moeten aanwezig zijn in Identiteitsservice voordat u ernaar verwijst in een payload. U kunt meerdere naamruimtetoetsen in dezelfde gebeurtenis opnemen wanneer u meerdere id's voor de bezoeker hebt.

U hoeft de ECID niet op te nemen als naamruimtesleutel. De Edge Network voegt de ECID automatisch toe aan de identiteitslading. Als u de ECID expliciet opneemt, moet u deze niet markeren als primary wanneer er ook een identiteit op persoonniveau aanwezig is.

id id

Het veld id is de id-tekenreeks zelf — de waarde die Experience Platform opgeeft welke specifieke persoon of welk apparaat deze identiteit vertegenwoordigt. Elk ​ identiteit namespace ​ verwacht een specifiek waardeformaat, en het verzenden van een waarde in het verkeerde formaat leidt tot een afzonderlijke identiteit die niet met de correct geformatteerde versie kan worden samengevoegd, resulterend in gefragmenteerde profielen.

Voordat u een waarde opneemt in identityMap , moet u deze voorbereiden volgens de indeling die uw doelnaamruimte verwacht:

Voor de volledige lijst van standaard namespaces en hun definities, zie ​ Overzicht van identiteitskaart namespace ​.

id bij uitvoering verzamelen collect-id

De vereiste id is zelden rechtstreeks beschikbaar op de pagina. De gemeenschappelijke inzamelingsstrategieën omvatten:

authenticatedState authenticated-state

Het veld authenticatedState geeft aan downstream-services door hoeveel vertrouwen een bepaalde identiteit moet krijgen. De volgende waarden zijn geldig voor dit veld:

primary primary-identity

Elke identityMap -lading moet precies één id hebben die als primary: true is gemarkeerd. De primaire identiteit bepaalt welke identiteit wordt gebruikt als anker voor de gebeurtenis in Experience Platform.

Volg deze richtlijnen bij het instellen van de primaire identiteit:

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ],
    "Email": [
      {
        "id": "user@example.com",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ]
  }
}

Identiteitskaart verzenden in uw implementatie send-identity

alloy("sendEvent", {
  xdm: {
    identityMap: {
      CRMID: [
        {
          id: "abc-123-xyz",
          authenticatedState: "authenticated",
          primary: true
        }
      ]
    },
    eventType: "web.webpagedetails.pageViews"
  }
});

Algemene scenario's common-scenarios

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "loggedOut",
        "primary": false
      }
    ]
  }
}

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ],
    "Email_LC_SHA256": [
      {
        "id": "a1b2c3d4e5f6...",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ],
    "LoyaltyId": [
      {
        "id": "LOY-98765",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ]
  }
}

Hoe identityMap van invloed is op de identiteitsgrafiek identity-graph

Elke identityMap nuttige lading die Experience Platform bereikt wordt verwerkt door ​ Dienst van de Identiteit ​, die de identiteiten verbindt u in een ​ identiteitsgrafiek ​ verzendt. Welke naamruimten u opneemt, hoe u authenticatedState instelt en welke identiteit u markeert als primary , geeft rechtstreeks de vorm hoe Identity Service deze grafieken bouwt en samenvoegt.

Belangrijk gedrag om bewust te zijn van:

Als uw implementatie ​ identiteitsgrafiek gebruikt die regels ​ verbindt (zoals namespaceprioriteit of het algoritme van de identiteitsoptimalisering), herzie de ​ implementatiegids ​ om te begrijpen hoe die regels met de identiteiten in wisselwerking staan u door identityMap verzendt.