Fehlerbehebungshandbuch für Regeln zur Identitätsdiagrammzuordnung

Beim Testen und Validieren der Verknüpfungsregeln von Identitätsdiagrammen können Probleme im Zusammenhang mit der Datenerfassung und dem Verhalten von Diagrammen auftreten. In diesem Dokument erfahren Sie, wie Sie einige häufige Probleme beheben können, die bei der Arbeit mit Regeln zur Identitätsdiagrammzuordnung auftreten können.

Übersicht über den Datenerfassungsfluss data-ingestion-flow-overview

Das folgende Diagramm zeigt eine vereinfachte Darstellung des Datenflusses in Adobe Experience Platform und Anwendungen. Verwenden Sie dieses Diagramm als Referenz, um ein besseres Verständnis des Inhalts dieser Seite zu erhalten.

Es ist wichtig, die folgenden Faktoren zu beachten:

Probleme bei der Datenerfassung data-ingestion-issues

Meine Identitäten werden nicht in Identity Service erfasst my-identities-are-not-getting-ingested-into-identity-service

Es gibt verschiedene Gründe, warum dies passieren könnte, unter anderem die folgenden:

Im Kontext von Regeln zur Zuordnung von Identitätsdiagrammen kann ein Datensatz vom Identity Service abgelehnt werden, da das eingehende Ereignis zwei oder mehr Identitäten mit demselben eindeutigen Namespace, aber einem anderen Identitätswert aufweist. Dieses Szenario tritt normalerweise aufgrund von Implementierungsfehlern auf.

Betrachten Sie das folgende Ereignis mit zwei Annahmen:

Das folgende Ereignis gibt eine Fehlermeldung zurück, die angibt, dass die Aufnahme fehlgeschlagen ist.

{
  "_id": "random_string",
  "eventType": "web browsing event",
  "identityMap": {
    "ECID": [
      {
        "id": "11111111111111111111111111111111111111",
        "primary": false
      }
    ],
    "CRMID": [
      {
        "id": "Alice",
        "primary": true
      }
    ]
  },
  "CRMID": "Bob",
  "timestamp": "2024-08-17T15:22:51+00:00",
  "web": {
    "webPageDetails": {
      "URL": "https://www.adobe.com/acrobat.html",
      "name": "Adobe Acrobat"
    }
  }
}

Schritte zur Fehlerbehebung

Um diesen Fehler zu beheben, müssen Sie zunächst die folgenden Informationen erfassen:

Verwenden Sie als Nächstes Adobe Experience Platform Query Service und führen Sie die folgende Abfrage aus:

  SELECT key, col.id as identityValue, timestamp, _id, identityMap, *
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id = 'identity_value'

Suchen Sie nach der Ausführung Ihrer Abfrage den Ereignisdatensatz, von dem Sie erwartet haben, dass er ein Diagramm generiert, und überprüfen Sie dann, ob die Identitätswerte in derselben Zeile unterschiedlich sind. Sehen Sie sich das folgende Bild für ein Beispiel an:

ExperienceEvents nach der Authentifizierung werden dem falschen authentifizierten Profil zugeordnet

Die Namespace-Priorität spielt eine wichtige Rolle bei der Bestimmung der primären Identität durch Ereignisfragmente.

Damit authentifizierte Benutzerereignisse an den Personen-Namespace gebunden werden können, müssen alle authentifizierten Ereignisse den Personen-Namespace (CRMID) enthalten. Das bedeutet, dass der Personen-Namespace auch nach der Anmeldung eines Benutzers bei jedem authentifizierten Ereignis vorhanden sein muss.

Wenn Sie ein Profil in der Profilansicht suchen, wird möglicherweise weiterhin die Markierung primary=true 'events' angezeigt. Dies wird jedoch ignoriert und vom Profil nicht verwendet.

AAIDs werden standardmäßig blockiert. Wenn Sie daher den Quell-Connector Adobe Analyticsverwenden, müssen Sie sicherstellen, dass die ECID höher als die ECID priorisiert ist, damit die nicht authentifizierten Ereignisse die primäre Identität ECID aufweisen.

Schritte zur Fehlerbehebung

Meine Erlebnisereignisfragmente werden nicht in das Profil aufgenommen my-experience-event-fragments-are-not-getting-ingested-into-profile

Es gibt verschiedene Gründe, warum Ihre Erlebnisereignisfragmente nicht in das Profil aufgenommen werden, darunter:

Im Zusammenhang mit der Namespace-Priorität lehnt das Profil Folgendes ab:

Schritte zur Fehlerbehebung

Wenn Ihre Daten an den Data Lake gesendet werden, jedoch nicht an das Profil, und Sie glauben, dass dies auf das Senden von zwei oder mehr Identitäten mit der höchsten Namespace-Priorität in einem einzelnen Ereignis zurückzuführen ist, können Sie die folgende Abfrage ausführen, um zu überprüfen, ob für denselben Namespace zwei verschiedene Identitätswerte gesendet werden:

  SELECT identityMap, key, col.id as identityValue, _testimsorg.identification.core.email, _id, timestamp
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id != _testimsorg.identification.core.email and key = 'Email'

Sie können auch die folgende Abfrage ausführen, um zu überprüfen, ob die Aufnahme in das Profil aufgrund des höchsten Namespace mit einer leeren Zeichenfolge nicht erfolgt:

  SELECT identityMap, key, col.id as identityValue, _testimsorg.identification.core.email, _id, timestamp
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE (col.id = '' or _testimsorg.identification.core.email = '') and key = 'Email'

Bei diesen beiden Abfragen wird davon ausgegangen, dass:

Probleme mit dem Diagrammverhalten graph-behavior-related-issues

In diesem Abschnitt werden häufig auftretende Probleme bezüglich des Verhaltens des Identitätsdiagramms beschrieben.

Nicht authentifizierte ExperienceEvents werden an das falsche authentifizierte Profil angehängt

Der Identitätsoptimierungsalgorithmus berücksichtigt die zuletzt eingerichteten Links und entfernt die ältesten Links. Daher ist es möglich, dass ECIDs nach Aktivierung dieser Funktion von einer Person zu einer anderen neu zugeordnet (neu verknüpft) werden können. Gehen Sie wie folgt vor, um den Verlauf der Verknüpfung einer Identität im Zeitverlauf zu verstehen:

Schritte zur Fehlerbehebung

Zunächst müssen Sie die folgenden Informationen erfassen:

Bei Identitätssymbolen (namespaceCode) wird zwischen Groß- und Kleinschreibung unterschieden. Um alle Identitätssymbole für einen bestimmten Datensatz in der identityMap abzurufen, führen Sie die folgende Abfrage aus:

SELECT distinct explode(*)FROM (SELECT map_keys(identityMap) FROM dataset_name)

Wenn Sie den Identitätswert Ihrer Cookie-ID nicht kennen und nach einer Cookie-ID suchen möchten, die mit mehreren Personen-IDs verknüpft wäre, müssen Sie die folgende Abfrage ausführen. Bei dieser Abfrage wird ECID als Cookie-Namespace und CRMID als Personen-Namespace angenommen.

  SELECT identityMap['ECID'][0]['id'], count(distinct identityMap['CRMID'][0]['id']) as crmidCount FROM dataset_name GROUP BY identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

  SELECT identityMap['ECID'][0]['id'], count(distinct personID) as crmidCount FROM dataset_name group by identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

Nachdem Sie nun die mit mehreren Personen-IDs verknüpften Cookie-Werte identifiziert haben, verwenden Sie eine aus den Ergebnissen in der folgenden Abfrage, um eine chronologische Übersicht darüber zu erhalten, wann dieser Cookie-Wert mit einer anderen Personen-ID verknüpft wurde:

  SELECT identityMap['CRMID'][0]['id'] as personEntity, *
  FROM dataset_name
  WHERE identitymap['ECID'][0].id ='identity_value'
  ORDER BY timestamp desc

SELECT _experience.analytics.customDimensions.eVars.eVar10 as personEntity, *
FROM dataset_name
WHERE identitymap['ECID'][0].id ='identity_value'
ORDER BY timestamp desc

Der Identitätsoptimierungsalgorithmus funktioniert nicht erwartungsgemäß

Schritte zur Fehlerbehebung

Weitere Informationen finden Sie in der Dokumentation zum Identitätsoptimierungsalgorithmus sowie in den Typen der unterstützten Diagrammstrukturen.

Sie können auch das Tool zur Diagrammsimulation in der Benutzeroberfläche verwenden, um Ereignisse zu simulieren und Ihre eigenen eindeutigen Namespace- und Namespace-Prioritätseinstellungen zu konfigurieren. Dies kann Ihnen dabei helfen, ein grundlegendes Verständnis dafür zu erhalten, wie sich der Identitätsoptimierungsalgorithmus verhalten sollte.

Wenn Ihre Simulationsergebnisse mit Ihren Erwartungen an das Diagrammverhalten übereinstimmen, können Sie überprüfen, ob Ihre Identitätseinstellungen mit den Einstellungen übereinstimmen, die Sie in Ihrer Simulation konfiguriert haben.

Selbst nach dem Konfigurieren von Identitätseinstellungen werden in meiner Sandbox ausgeblendete Diagramme angezeigt.

Identitätsdiagramme entsprechen Ihrem konfigurierten eindeutigen Namespace und Ihrer Namespace-Priorität nach der Speicherung der Einstellungen. Alle "ausgeblendeten"Diagramme, die vor vorhanden sind, wenn Sie Ihre neuen Einstellungen speichern, sind davon nicht betroffen, bis neue Daten so erfasst werden, dass das ausgeblendete Diagramm aktualisiert wird. Die primäre Identität von Ereignisfragmenten im Echtzeit-Kundenprofil wird nicht aktualisiert, selbst wenn sich die Namespace-Priorität ändert.

Schritte zur Fehlerbehebung

Mit dem Viewer für Identitätsdiagramme 🔗 können Sie überprüfen, ob Ihr Diagramm vor oder nach Ihren Einstellungen erfasst wurde. Überprüfen Sie den letzten aktualisierten Zeitstempel unter Link-Eigenschaften , um zu sehen, wann der Identity Service das Diagramm erfasst hat. Wenn der Zeitstempel vor der Konfiguration liegt, deutet dies darauf hin, dass das "reduzierte"Diagramm erstellt wurde, bevor die Funktion aktiviert wurde.

Ich möchte wissen, wie viele "reduzierte"Diagramme in meiner Sandbox vorhanden sind.

Verwenden Sie das Identitäts-Dashboard , um Einblicke in den Status Ihres Identitätsdiagramms zu erhalten, z. B. die Anzahl der Identitäten und Diagramme. Siehe Metrik "Diagrammanzahl mit mehreren Namespaces"für eine Anzahl von Diagrammen, die reduziert wurden. Hierbei handelt es sich um Diagramme, die zwei oder mehr Identitäten mit demselben Namespace enthalten. Wenn die Sandbox keine Daten enthält und Sie einen Namespace (z. B. CRMID) als eindeutig konfiguriert haben, wird erwartet, dass es keine Diagramme mit zwei oder mehr CRMIDs gibt. Im folgenden Beispiel sind zwei Diagramme mit zwei oder mehr E-Mail-Adressen enthalten.

Sie können eine detaillierte Aufschlüsselung des Profil-Snapshot-Exportdatensatzes im Data Lake finden, indem Sie die folgende Abfrage ausführen:

  SELECT key, identityCountInGraph, count(identityCountInGraph) as graphCount
  FROM (SELECT key, cardinality(value) as identityCountInGraph
  FROM (SELECT explode(identityMap)
  FROM dataset_name
  WHERE cardinality(identityMap) > 1)) /* by definition, graphs have 2 or more identities */
  WHERE key not in ('ecid', 'aaid', 'idfa', 'gaid') /* filter out common device/cookie namespaces */
  GROUP BY 1, 2
  ORDER BY 1, 2 asc

Sie können die folgende Abfrage im Datensatz zum Exportieren von Profilmomentdaten verwenden, um Beispielidentitäten aus "reduzierten"Diagrammen zu erhalten.

  SELECT identityMap
  FROM dataset_name
  WHERE cardinality(identityMap['CRMID'])>1 /* any graphs with 2+ CRMID. Change CRMID namespace if needed */

Häufig gestellte Fragen faq

In diesem Abschnitt finden Sie eine Liste von Antworten auf häufig gestellte Fragen zu Regeln zur Identitätsdiagrammverlinkung.

Identitätsoptimierungsalgorithmus identity-optimization-algorithm

In diesem Abschnitt finden Sie Antworten auf häufig gestellte Fragen zum Identitätsoptimierungsalgorithmus.

Ich habe eine CRMID für jede meiner Geschäftseinheiten (B2C CRMID, B2B CRMID), aber ich habe keinen eindeutigen Namespace für alle meine Profile. Was geschieht, wenn ich B2C CRMID und B2B CRMID als eindeutig markiere und meine Identitätseinstellungen aktiviere?

Dieses Szenario wird nicht unterstützt. Daher können Diagramme in Fällen reduziert werden, in denen sich ein Benutzer mit seiner B2C-CRMID anmeldet und ein anderer Benutzer seine B2B-CRMID zur Anmeldung verwendet. Weitere Informationen finden Sie im Abschnitt Namespace-Anforderung für einzelne Personen auf der Implementierungsseite.

Korrigiert der Identitätsoptimierungsalgorithmus vorhandene reduzierte Diagramme?

Vorhandene reduzierte Diagramme werden vom Diagrammalgorithmus nur betroffen ('fixed'), wenn diese Diagramme nach dem Speichern Ihrer neuen Einstellungen aktualisiert werden.

Was passiert mit den Ereignissen, wenn sich zwei Personen mit demselben Gerät anmelden und abmelden? Werden alle Ereignisse an den letzten authentifizierten Benutzer übertragen?

Weitere Informationen finden Sie in der Anleitung zum Ermitteln der primären Identität für Erlebnisereignisse.

Wie werden die Journey in Adobe Journey Optimizer beeinflusst, wenn die ECID von einer Person zur anderen übertragen wird?

Die CRMID des letzten authentifizierten Benutzers wird mit der ECID (freigegebenes Gerät) verknüpft. ECIDs können basierend auf dem Benutzerverhalten von einer Person zu einer anderen neu zugewiesen werden. Die Auswirkungen hängen davon ab, wie die Journey erstellt wird. Daher ist es wichtig, dass Kunden die Journey in einer Entwicklungs-Sandbox-Umgebung testen, um das Verhalten zu überprüfen.

Die wichtigsten Punkte sind:

Namespace-Priorität

In diesem Abschnitt finden Sie Antworten auf häufig gestellte Fragen zu Namespace-Priorität.

Ich habe meine Identitätseinstellungen aktiviert. Was passiert mit meinen Einstellungen, wenn ich einen benutzerdefinierten Namespace hinzufügen möchte, nachdem die Einstellungen aktiviert wurden?

Es gibt zwei "Behälter"mit Namespaces: Personen-Namespaces und Geräte-/Cookie-Namespaces. Der neu erstellte benutzerdefinierte Namespace hat in jedem "Bucket"die niedrigste Priorität, sodass dieser neue benutzerdefinierte Namespace keine Auswirkungen auf die vorhandene Datenerfassung hat.

Wenn das Echtzeit-Kundenprofil das "primäre"Flag auf identityMap nicht mehr verwendet, muss dieser Wert dennoch gesendet werden?

Ja, das "primäre"Flag auf identityMap wird von anderen Diensten verwendet. Weitere Informationen finden Sie im Handbuch zu Auswirkungen der Namespace-Priorität auf andere Experience Platform-Dienste.

Wird die Namespace-Priorität auf Profildatensätze im Echtzeit-Kundenprofil angewendet?

Nein. Die Namespace-Priorität gilt nur für Experience Event-Datensätze, die die XDM ExperienceEvent-Klasse verwenden.

Wie funktioniert diese Funktion zusammen mit den Limits von 50 Identitäten pro Diagramm? Beeinflusst die Namespace-Priorität dieses systemdefinierte Limits?

Der Identitätsoptimierungsalgorithmus wird zuerst angewendet, um die Darstellung der Entität der Person sicherzustellen. Wenn das Diagramm anschließend versucht, den Limits des Identitätsdiagramms (50 Identitäten pro Diagramm) zu überschreiten, wird diese Logik angewendet. Die Namespace-Priorität wirkt sich nicht auf die Löschlogik des 50-Identitäts-/Diagrammschutzes aus.

Testen

In diesem Abschnitt finden Sie Antworten auf häufig gestellte Fragen zu Test- und Debugging-Funktionen in Identitätsdiagramm-Verknüpfungsregeln.

Welche Szenarien sollten in einer Entwicklungs-Sandbox-Umgebung getestet werden?

Im Allgemeinen sollten Tests an einer Entwicklungs-Sandbox die Anwendungsfälle imitieren, die Sie in Ihrer Produktions-Sandbox ausführen möchten. In der folgenden Tabelle finden Sie einige zu validierende Schlüsselbereiche bei der Durchführung umfassender Tests:

Wie kann ich überprüfen, ob diese Funktion erwartungsgemäß funktioniert?

Verwenden Sie das Diagrammsimulationswerkzeug, um zu überprüfen, ob die Funktion auf einer einzelnen Diagrammebene funktioniert.

Informationen zum Validieren der Funktion auf Sandbox-Ebene finden Sie im Abschnitt Diagrammanzahl mit mehreren Namespaces im Identitäts-Dashboard.