Använda identityMap i datainsamling

Nyttolastobjektet identityMap är det sätt som du talar om för Edge Network vilka besökare som befinner sig utanför sin enhetsnivå, ECID. När en besökare loggar in, slutför ett köp eller på annat sätt blir känd, kan du skicka identifierare på personnivå (CRM-ID, hashad e-post, lojalitets-ID osv.) tillsammans med ECID. Dessa identifierare på personnivå ger värdefull information till tjänster i senare led så att de kan

På den här sidan beskrivs hur du skapar identityMap-nyttolaster, väljer rätt inställningar för varje identitet och hanterar vanliga implementeringsscenarier.

Nyttolaststruktur structure

identityMap är ett JSON-objekt där varje nyckel på den översta nivån är ett namnutrymme och värdet är en array med identitetsbeskrivare. Du kan inkludera ett eller flera namnutrymmen i en enskild nyttolast och varje beskrivning innehåller tre fält: id, authenticatedState och primary.

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

Avsnitten nedan täcker varje del av nyttolasten i detalj.

Namnutrymmesnycklar namespace-keys

Varje nyckel på den översta nivån i identityMap är ett identitetsnamnutrymme - en sträng som klassificerar typen av identifierare (till exempel CRMID, Email, Phone eller LoyaltyId). Namnutrymmen måste finnas i identitetstjänsten innan du refererar till dem i en nyttolast. Du kan inkludera flera namnutrymmesnycklar i samma händelse om du har mer än en identifierare för besökaren.

Du behöver inte inkludera ECID som namnutrymmesnyckel. Edge Network lägger automatiskt till ECID till identitetsnyttolasten. Om du inkluderar ECID explicit ska du inte markera det som primary när det också finns en identitet på personnivå.

id id

Fältet id är själva identifierarsträngen - det värde som talar om för Experience Platform vilken specifik person eller enhet den här identiteten representerar. Varje identitetsnamnområde förväntar sig ett specifikt värdeformat, och om du skickar ett värde i fel format skapas en distinkt identitet som inte kan sammanfogas med rätt formaterad version, vilket resulterar i fragmenterade profiler.

Innan du tar med ett värde i identityMap förbereder du det enligt det format som målnamnutrymmet förväntar sig:

En fullständig lista över standardnamnutrymmen och definitioner av dessa finns i Översikt över identitetsnamnrymden.

Samlar in id vid körning collect-id

Den identifierare du behöver är sällan tillgänglig direkt på sidan. Gemensamma strategier för insamling innefattar:

authenticatedState authenticated-state

Fältet authenticatedState anger för underordnade tjänster hur mycket förtroende som ska placeras i en viss identitet. Följande värden är giltiga för det här fältet:

primary primary-identity

Varje identityMap-nyttolast måste ha exakt en identitet markerad som primary: true. Den primära identiteten avgör vilken identitet som används som ankarpunkt för händelsen i Experience Platform.

Följ de här riktlinjerna när du anger primär identitet:

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

Skicka identityMap i implementeringen send-identity

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

Vanliga scenarier 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
      }
    ]
  }
}

Hur identityMap påverkar identitetsdiagrammet identity-graph

Varje identityMap-nyttolast som når Experience Platform behandlas av identitetstjänsten som länkar de identiteter som du skickar till ett identitetsdiagram. Vilka namnutrymmen du inkluderar, hur du anger authenticatedState och vilken identitet du markerar som primary, skapar och sammanfogar identitetstjänsten dessa diagram direkt.

Viktiga beteenden att vara medveten om:

Om din implementering använder länkningsregler för identitetsdiagram (till exempel namnområdesprioritet eller algoritmen för identitetsoptimering) kan du läsa implementeringsguiden för att förstå hur dessa regler interagerar med de identiteter du skickar via identityMap.