Handbuch zur Fehlerbehebung bei Echtzeit-Kundenprofilen

Dieses Dokument enthält Antworten auf häufig gestellte Fragen zum Echtzeit-Kundenprofil sowie eine Anleitung zur Fehlerbehebung bei häufigen Fehlern. Fragen und Informationen zur Fehlerbehebung bei anderen Diensten in Adobe Experience Platform finden Sie im Handbuch zur Fehlerbehebung bei Experience Platformen.

Das Real-time Customer Profile ermöglicht Ihnen eine ganzheitliche Sicht auf jeden einzelnen Kunden, indem es Daten aus Online- und Offline-Kanälen ebenso wie aus CRMs und Drittanbieter-Datenquellen sowie anderen Kanälen miteinander kombiniert. Dadurch können Marketing-Experten koordinierte, konsistente und relevante Erlebnisse für Kunden über mehrere Kanäle hinweg bereitstellen.

FAQs

Im Folgenden finden Sie eine Liste von Antworten auf häufig gestellte Fragen zum Echtzeit-Kundenprofil.

Welche Daten werden für das Echtzeit-Kundenprofil akzeptiert?

Das Profil akzeptiert sowohl record- als auch Zeitreihen-Daten, sofern die betreffenden Daten mindestens einen Identitätswert enthalten, der die Daten mit einer eindeutigen Person verknüpft.

Wie alle Platform-Dienste erfordert Profil, dass seine Daten semantisch unter einem Experience-Datenmodell (XDM)-Schema strukturiert sind. Dieses Schema muss wiederum eine primäre Identität definieren und für die Verwendung in Profil aktiviert sein.

Wenn Sie XDM nicht kennen, beginnen Sie mit der XDM-Übersicht , um mehr zu erfahren. Als Nächstes finden Sie im XDM-Benutzerhandbuch Anweisungen dazu, wie Sie Identitätsfelder festlegen und ein Schema für Profil aktivieren.

Wo werden Profildaten gespeichert?

Das Echtzeit-Kundenprofil unterhält einen eigenen Datenspeicher (der als "Profilspeicher"bezeichnet wird), der vom Data Lake getrennt ist, der andere aufgenommene Platform-Daten enthält.

Wenn ich bereits Daten in Platform erfasst habe, kann ich sie dann im Profilspeicher verfügbar machen?

Wenn Daten in einen Nicht-Profil-Datensatz aufgenommen wurden, müssen Sie diese Daten erneut in einen Profil-aktivierten Datensatz erfassen, um ihn im Profilspeicher verfügbar zu machen. Es ist möglich, einen vorhandenen Datensatz für Profil zu aktivieren. Daten, die vor dieser Konfiguration erfasst wurden, werden jedoch weiterhin nicht im Profilspeicher angezeigt.

Wenn Sie zuvor erfasste Daten zum Profilspeicher hinzufügen möchten, befolgen Sie das Tutorial zur Datensatzkonfiguration , um einen neuen Datensatz zu erstellen oder einen vorhandenen Datensatz zu konvertieren, der für Profil aktiviert werden soll, und dann die gewünschten Daten erneut in diesen Datensatz zu erfassen.

Wie kann ich meine erfassten Profildaten anzeigen?

Je nachdem, ob Sie die API oder die Benutzeroberfläche verwenden, gibt es mehrere Methoden zum Anzeigen von Profildaten.

Verwenden der API

Wenn Sie die IDs der Profilentitäten kennen, auf die Sie zugreifen möchten, können Sie den Endpunkt /entities (Profilzugriff) in der Profil-API verwenden, um diese Entitäten zu suchen. Weitere Informationen finden Sie im Abschnitt zu Entitäten im Entwicklerhandbuch.

Sie können auch die Adobe Experience Platform Segmentation Service-API verwenden, um auf die individuellen Profile von Kunden zuzugreifen, die sich für eine Segmentzugehörigkeit qualifiziert haben. Weitere Informationen finden Sie unter Segmentation Service - Übersicht .

Verwenden der UI

Auf der Experience Platform-Benutzeroberfläche können Sie mit dem Tab Durchsuchen im Arbeitsbereich Profile die Gesamtanzahl der Profile anzeigen und nach einzelnen Profilen anhand ihres Identitätswerts suchen. Weitere Informationen finden Sie im Profil-Benutzerhandbuch.

Sie können auch eine Liste Ihrer Segmente auf der Registerkarte Durchsuchen im Arbeitsbereich Segmente anzeigen. Nach Auswahl eines Segments wird ein Beispiel mit Profilen angezeigt, die für dieses Segment qualifiziert sind. Sie können dann eines dieser aufgelisteten Profile auswählen, um dessen Details anzuzeigen. Weitere Informationen finden Sie unter Übersicht über die Segmentierungs-Benutzeroberfläche .

Fehlercodes

Im Folgenden finden Sie eine Liste von Fehlermeldungen, die bei der Arbeit mit der Echtzeit-Kundenprofil-API auftreten können. Wenn der aufgetretene Fehler hier nicht aufgeführt ist, finden Sie ihn stattdessen im allgemeinen Handbuch zur Fehlerbehebung bei Platform .

Schema des berechneten Attributs für den angegebenen Pfad konnte nicht nachgeschlagen werden

{
  "code": "400",
  "message": "Could not lookup schema of the computed attribute for the provided path"
}

Beim Erstellen eines neuen berechneten Attributs tritt dieser Fehler auf, wenn das System das in der Anfrage-Payload bereitgestellte Schema nicht finden konnte. Stellen Sie sicher, dass Sie die richtige Mandanten-ID in der path -Eigenschaft der Payload angegeben haben und dass die Werte von schema.name ein gültiger Schemaname sind.

Wenn Sie Ihre Mandantenkennung nicht kennen, können Sie sie abrufen, indem Sie die Schritte im Entwicklerhandbuch zur Schema Registry ausführen.

Funktion mit demselben Namen ist bereits für das angegebene Schema oder definedOn vorhanden

{
  "code": "400",
  "message": "Function with the same name already exists for the specified schema or definedOn"
}

Beim Erstellen eines neuen berechneten Attributs tritt dieser Fehler auf, wenn die bereitgestellte name -Eigenschaft bereits für das unter schema.name angegebene Schema verwendet wird. Ersetzen Sie den Wert durch einen eindeutigen Namen, bevor Sie es erneut versuchen.

Das Rückgabeschema des Ausdrucks ist nicht dasselbe wie das Schema des berechneten Attributs im XDM-Schema

{
  "code": "400",
  "message": "Return schema of the expression is not same as the schema of the computed attribute in the XDM schema"
}

Beim Erstellen eines neuen berechneten Attributs tritt dieser Fehler auf, wenn die bereitgestellte name -Eigenschaft bereits für das unter schema.name angegebene Schema verwendet wird. Ersetzen Sie den Wert durch einen eindeutigen Namen, bevor Sie es erneut versuchen.

Ungültige Löschanfrage (Profilsystemauftrag)

{
  "code": "400",
  "message": "Invalid delete request (Profile System Job)"
}

Dieser Fehler tritt auf, wenn eine ungültige Payload für einen Löschsystemauftrag bereitgestellt wird. Stellen Sie sicher, dass Sie unter der Eigenschaft dataSetID bzw. batchID der Payload eine gültige Datensatz- oder Batch-ID angeben. Weitere Informationen finden Sie im Abschnitt Erstellen einer Löschanfrage im Entwicklerhandbuch für Profile.

Batch für Profildatensatz nicht gefunden

{
  "requestId":"LlTmQkhgHKFGHGHnIkmUxcIL4YTFSpQw",
  "errors":{
    "400":[
      {
        "code":"400",
        "message":"Batch not found for profile dataset '5da688d2c4e60518ad25b7b1'"
      }
    ]
  }
}

Dieser Fehler tritt auf, wenn beim Versuch, eine Löschanfrage für Profildaten zu erstellen, kein gültiger Batch gefunden werden konnte. Vergewissern Sie sich, dass Sie die richtige ID für einen Profil-aktivierten Datensatz eingegeben haben, bevor Sie es erneut versuchen.

Das Projektionsziel wurde noch nicht erstellt

{
  "status":404,
  "title":"The projection destination has not yet been created.",
  "type":"http://ns.adobe.com/adobecloud/problem/missing-entity"
}

Dieser Fehler tritt auf, wenn die in einer POST /config/projections-Anfrage angegebene destinationId ungültig ist. Vergewissern Sie sich, dass Sie eine gültige Ziel-ID angegeben haben, bevor Sie es erneut versuchen. Um ein neues Ziel zu erstellen, führen Sie die Schritte aus, die im Profil-Entwicklerhandbuch beschrieben sind.

Nicht unterstützter Medientyp

{
  "status": 415,
  "title": "HTTP 415 Unsupported Media Type",
  "type": "http://ns.adobe.com/adobecloud/problem/unsupported-media-type"
}

Dieser Fehler tritt auf, wenn eine POST- oder PUT-Anfrage mit einer ungültigen Content-Type-Kopfzeile gesendet wird. Überprüfen Sie, ob Sie einen gültigen Content-Type-Wert für den verwendeten Endpunkt angeben.

Die meisten Endpunkte des Profils akzeptieren "application/json"für ihre Kopfzeile vom Typ "Content", mit folgenden Ausnahmen: