Handbuch zur Fehlerbehebung bei der Streaming-Erfassung

In diesem Dokument finden Sie Antworten auf häufig gestellte Fragen zur Streaming-Erfassung in Adobe Experience Platform. Weitere Informationen zu Fragen und zur Fehlerbehebung in Zusammenhang mit anderen Platform-Diensten, einschließlich solcher, die in allen Platform-APIs gefunden werden, finden Sie im Handbuch Experience Platform Fehlerbehebung.

Adobe Experience Platform Data Ingestion stellt RESTful-APIs bereit, mit denen Sie Daten in Experience Platform erfassen können. Die erfassten Daten dienen zur nahezu echtzeitbasierten Aktualisierung einzelner Kundenprofile, sodass Sie kanalübergreifend für personalisierte, relevante Erlebnisse sorgen können. Weiterführende Informationen zu dem Dienst und zu den verschiedenen Erfassungsmethoden finden Sie in der Datenerfassung – Übersicht. Anweisungen zur Verwendung von Streaming-Erfassungs-APIs finden Sie in der Streaming-Erfassung – Übersicht.

FAQs

Im Folgenden finden Sie eine Liste von Antworten auf häufig gestellte Fragen zur Streaming-Erfassung.

Wie weiß ich, ob die Payload, die ich versenden möchte, richtig formatiert ist?

Data Ingestion nutzt Experience Data Model (XDM)-Schema zur Validierung des Formats eingehender Daten. Das Senden von Daten, die nicht mit der Struktur eines vordefinierten XDM-Schemas übereinstimmen, führt dazu, dass die Erfassung fehlschlägt. Weitere Informationen zu XDM und seiner Verwendung in Experience Platform finden Sie unter XDM-Systemübersicht.

Die Streaming-Erfassung unterstützt zwei Validierungsmodi: synchron und asynchron. Bei jeder Validierungsmethode werden fehlerhafte Daten anders behandelt.

Synchrone Validierung sollte während der Entwicklung genutzt werden. Datensätze, bei denen die Validierung fehlschlägt, werden entfernt; außerdem wird eine Fehlermeldung mit Informationen dazu ausgegeben, warum sie fehlgeschlagen sind (z. B. „Ungültiges XDM-Nachrichtenformat“).

Asynchrone Validierung sollte in der Produktion verwendet werden. Fehlerhafte Daten, die keine Validierung übergeben, werden als Stapeldatei an das Data Lake gesendet, wo sie später zur weiteren Analyse abgerufen werden können.

Weiterführende Informationen zur synchronen und asynchronen Validierung finden Sie in der Übersicht zur Streaming-Validierung. Anweisungen zum Anzeigen von Batches, die die Validierung nicht bestehen, finden Sie im Handbuch zum Abrufen fehlgeschlagener Batches.

Kann ich eine Anforderungs-Nutzlast überprüfen, bevor ich sie an Platform senden kann?

Anforderungs-Nutzlasten können erst ausgewertet werden, nachdem sie an Platform gesendet wurden. Bei Nutzung der synchronen Validierung geben gültige Payloads ausgefüllte JSON-Objekte zurück, während ungültige Payloads Fehlermeldungen zurückgeben. Während der asynchronen Überprüfung erkennt und sendet der Dienst fehlerhafte Daten an das Data Lake, wo sie später zur Analyse abgerufen werden können. Weiterführende Informationen dazu finden Sie in der Übersicht zur Streaming-Validierung.

Was geschieht, wenn eine synchrone Validierung an einem Edgeserver angefordert wird, der sie nicht unterstützt?

Wenn synchrone Validierung am angeforderten Ort nicht unterstützt wird, wird eine Fehlerantwort vom Typ 501 zurückgegeben. Weiterführende Informationen zur synchronen Validierung finden Sie in der Übersicht zur Streaming-Validierung.

Wie stelle ich sicher, dass Daten nur aus vertrauenswürdigen Quellen erfasst werden?

Experience Platform unterstützt die sichere Datenerfassung. Wenn authentifizierte Datenerfassung aktiviert ist, müssen Clients ein JSON Web Token (JWT) und ihre IMS-Organisations-Kennung als Anfragekopfzeilen senden. Weitere Informationen zum Senden authentifizierter Daten an Platform finden Sie im Handbuch Authentifizierte Datenerfassung.

Wie lange dauert das Streaming von Daten auf Real-time Customer Profile?

Streaming-Ereignis werden im Allgemeinen in Real-time Customer Profile in weniger als 60 Sekunden angezeigt. Reale Latenzwerte können aber je nach Datenvolumen, Nachrichtengröße und Bandbreiteneinschränkungen davon abweichen.

Kann ich in eine API-Anfrage mehrere Nachrichten einschließen?

Sie können mehrere Nachrichten innerhalb einer einzigen Anforderungsnutzlast gruppieren und sie an Platform streamen. Bei richtiger Verwendung stellt das Gruppieren mehrerer Nachrichten in einer Anfrage eine hervorragende Möglichkeit zur Optimierung Ihrer Datenvorgänge dar. Lesen Sie das Tutorial zum Senden mehrerer Nachrichten in einer Anfrage, um mehr zu erfahren.

Wie weiß ich, ob meine gesendeten Daten empfangen werden?

Alle Daten, die (erfolgreich oder anderweitig) an Platform gesendet werden, werden als Stapeldateien gespeichert, bevor sie in den Datensätzen beibehalten werden. Der Verarbeitungsstatus von Batches erscheint in dem Datensatz, an den sie gesendet wurden.

Sie können überprüfen, ob Daten erfolgreich erfasst wurden, indem Sie die Datensatzaktivität mit der Benutzeroberfläche von Experience Platform überprüfen. Klicken Sie dazu im linken Navigationsbereich auf Datensätze, um eine Liste der Datensätze anzuzeigen. Wählen Sie in der angezeigten Liste den Datensatz aus, an den Sie streamen, um die zugehörige Seite Datensatzaktivität zu öffnen und alle Batches anzuzeigen, die in einem bestimmten Zeitraum gesendet wurden. Weitere Informationen zur Verwendung von Experience Platform zur Überwachung von Datenströmen finden Sie im Handbuch Überwachung von Streaming-Datenströmen.

Wenn Ihre Daten nicht erfasst werden konnten und Sie sie von Platform wiederherstellen möchten, können Sie die fehlgeschlagenen Stapel abrufen, indem Sie ihre IDs an Data Access API senden. Weiterführende Informationen finden Sie im Handbuch zum Abrufen fehlgeschlagener Batches.

Warum sind meine Streaming-Daten im Data Lake nicht verfügbar?

Es gibt eine Reihe von Gründen, warum die Stapelverarbeitung möglicherweise nicht die Werte von Data Lake erreicht, z. B. ungültige Formatierungen, fehlende Daten oder Systemfehler. Um festzustellen, warum der Stapel fehlgeschlagen ist, müssen Sie den Stapel mit dem Data Ingestion Service API abrufen und die zugehörigen Details Ansicht vornehmen. Ausführliche Anweisungen zum Abrufen eines fehlgeschlagenen Batches finden Sie im Handbuch zum Abrufen fehlgeschlagener Batches.

Wie analysiere ich die Antwort, die für die API-Anfrage zurückgegeben wurde?

Prüfen Sie zunächst den Antwort-Code des Servers, um zu ermitteln, ob Ihre Anfrage akzeptiert wurde. Wenn ein erfolgreicher Antwort-Code zurückgegeben wurde, können Sie als Nächstes das Array-Objekt responses prüfen, um den Status der Erfassungsaufgabe zu ermitteln.

Eine erfolgreiche API-Anfrage mit einer Nachricht gibt den Status-Code 200 zurück. Eine erfolgreiche (oder teilweise erfolgreiche) API-Anfrage mit Batch-Nachricht gibt den Status-Code 207 zurück.

Die folgende JSON ist ein Beispielantwortobjekt für eine API-Anfrage mit zwei Nachrichten: einer erfolgreichen und einer fehlgeschlagenen. Nachrichten, die erfolgreich gestreamt werden, geben eine xactionId-Eigenschaft zurück. Nachrichten, die nicht gestreamt werden, geben eine statusCode-Eigenschaft und eine Antwort-message mit zusätzlichen Informationen zurück.

{
    "inletId": "9b0cb233972f3b0092992284c7353f5eead496218e8441a79b25e9421ea127f5",
    "batchId": "1565638336649:1750:244",
    "receivedTimeMs": 1565638336705,
    "responses": [
        {
            "xactionId": "1565650704337:2124:92:3"
        },
        {
            "statusCode": 400,
            "message": "inletId: [9b0cb233972f3b0092992284c7353f5eead496218e8441a
                79b25e9421ea127f5] 
                imsOrgId: [{IMS_ORG}] 
                Message has unknown xdm format"
        }
    ]
}

Warum werden meine gesendeten Nachrichten nicht von Real-time Customer Profile empfangen?

Wenn Real-time Customer Profile eine Nachricht ablehnt, ist dies höchstwahrscheinlich auf falsche Identitätsinformationen zurückzuführen. Der Grund dafür kann sein, dass für eine Identität ein ungültiger Wert oder Namespace angegeben wurde.

Es gibt zwei Arten von Identitäts-Namespaces: standardmäßige und benutzerdefinierte. Wenn Sie benutzerdefinierte Namensraum verwenden, stellen Sie sicher, dass der Namensraum in Identity Service registriert wurde. Weiterführende Informationen zur Verwendung von standardmäßigen und benutzerdefinierten Namespaces finden Sie in der Übersicht zu Identitäts-Namespaces.

Sie können Experience Platform UI verwenden, um weitere Informationen darüber anzuzeigen, warum eine Nachricht fehlgeschlagen ist. Klicken Sie im linken Navigationsbereich auf Monitoring und dann auf den Tab Streaming End-to-End, um die in einem bestimmten Zeitraum gestreamten Nachrichten-Batches anzuzeigen.

Auf dieser Seite