Verwenden von identityMap in der Datenerfassung

Mit dem identityMap Payload-Objekt können Sie dem Edge Network mitteilen, wer ein Besucher ist, der über die Geräteebene () ​. Wenn sich ein Besucher anmeldet, einen Kauf abschließt oder anderweitig bekannt wird, können Sie neben der ECID Kennungen auf Personenebene (CRM-ID, gehashte E-Mail, Treueprogramm-ID usw.) senden. Diese Kennungen auf Personenebene bieten nachgelagerten -Services wertvolle Informationen, damit sie:

Auf dieser Seite wird beschrieben, wie Sie identityMap Payloads erstellen, die richtigen Einstellungen für jede Identität auswählen und gängige Implementierungsszenarien behandeln.

Payload-Struktur structure

Der identityMap ist ein JSON-Objekt, bei dem jeder Schlüssel der obersten Ebene ein Namespace und der Wert ein Array von Identitätsdeskriptoren ist. Sie können einen oder mehrere Namespaces in eine einzige Payload einbeziehen, wobei jeder Deskriptor drei Felder enthält: id, authenticatedState und primary.

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

Die folgenden Abschnitte behandeln jeden Teil der Payload im Detail.

Namespace-Schlüssel namespace-keys

Jeder Schlüssel der obersten Ebene in identityMap ist ein Identity-Namespace - eine Zeichenfolge, die den Typ der Kennung klassifiziert (z. B. CRMID, Email, Phone oder LoyaltyId). Namespaces müssen in Identity Service vorhanden sein, bevor Sie in einer Payload auf sie verweisen. Sie können mehrere Namespace-Schlüssel in dasselbe Ereignis einbeziehen, wenn Sie mehr als eine Kennung für den Besucher haben.

Sie müssen die ECID nicht als Namespace-Schlüssel einschließen. Edge Network fügt die ECID automatisch zur Identity-Payload hinzu. Wenn Sie die ECID explizit einschließen, markieren Sie sie nicht als primary, wenn auch eine Identität auf Personenebene vorhanden ist.

id id

Das id Feld ist die Kennungszeichenfolge selbst - der Wert, der Experience Platform mitteilt, welche bestimmte Person oder Gerät diese Identität darstellt. Jeder Identity-Namespace erwartet ein bestimmtes Wertformat, und das Senden eines Werts im falschen Format erstellt eine eindeutige Identität, die nicht mit der korrekt formatierten Version zusammengeführt werden kann, was zu fragmentierten Profilen führt.

Bevor Sie einen Wert in identityMap aufnehmen, bereiten Sie ihn entsprechend dem Format vor, das Ihr Ziel-Namespace erwartet:

Eine vollständige Liste der Standard-Namespaces und ihrer Definitionen finden Sie unter Übersicht zu Identitäts-Namespaces.

Erfassen von id zur Laufzeit collect-id

Die benötigte Kennung ist selten direkt auf der Seite verfügbar. Zu den gängigen Sammelstrategien gehören:

authenticatedState authenticated-state

Das Feld authenticatedState gibt den nachgelagerten Services an, wie viel Vertrauen einer bestimmten Identität gesetzt werden soll. Die folgenden Werte sind für dieses Feld gültig:

primary primary-identity

Jede identityMap-Payload muss genau eine als primary: true markierte Identität aufweisen. Die primäre Identität bestimmt, welche Identität als Anker für das Ereignis in Experience Platform verwendet wird.

Befolgen Sie beim Festlegen der primären Identität die folgenden Richtlinien:

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

Senden von identityMap in Ihrer Implementierung send-identity

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

Häufige Szenarien 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
      }
    ]
  }
}

Auswirkungen von identityMap auf das Identitätsdiagramm identity-graph

Jede identityMap-Payload, die Experience Platform erreicht, wird von Identity Service verarbeitet, der die von Ihnen gesendeten Identitäten in einem Identitätsdiagramm verknüpft. Welche Namespaces Sie einbeziehen, wie Sie authenticatedState festlegen und welche Identität Sie als primary markieren, bestimmt direkt, wie Identity Service diese Diagramme erstellt und zusammenführt.

Wichtige Verhaltensweisen, die zu beachten sind:

Wenn Ihre Implementierung Regeln zur Verknüpfung von Identitätsdiagrammen verwendet (z. B. Namespace-Priorität oder Algorithmus zur Identitätsoptimierung), lesen Sie das Implementierungshandbuch um zu verstehen, wie diese Regeln mit den Identitäten interagieren, die Sie über identityMap senden.