Handbuch zur Fehlerbehebung bei der Streaming-Aufnahme

In diesem Dokument finden Sie Antworten auf häufig gestellte Fragen zur Streaming-Aufnahme in Adobe Experience Platform. Antworten zu Fragen und Informationen zur Fehlerbehebung bei anderen Platform-Services, einschließlich solcher, die für alle Platform-APIs gelten, finden Sie im Handbuch zur Fehlerbehebung in Experience Platform.

Adobe Experience Platform Data Ingestion stellt RESTful-APIs bereit, mit denen Sie Daten in Experience Platform aufnehmen 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 Service 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)-Schemata zur Validierung des Formats der eingehenden Daten. Das Senden von Daten, die nicht mit der Struktur eines vordefinierten XDM-Schemas übereinstimmen, führt dazu, dass die Aufnahme fehlschlägt. Weiterführende Informationen zu XDM und seiner Verwendung in Experience Platform finden Sie in der Übersicht zum XDM-System.

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. Falsch formatierte Daten, die die Validierung nicht bestehen, werden als fehlgeschlagene Batch-Datei an den Data Lake gesendet, wo sie später zur genaueren 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 die Payload einer Anfrage validieren, bevor ich sie an Platform sende?

Payloads von Anfragen 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. Bei der asynchronen Validierung erkennt und sendet der Service falsch formatierte Daten an den Data Lake, wo sie später zur genaueren 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 eine sichere Datenerfassung. Wenn die authentifizierte Datenerfassung aktiviert ist, müssen Clients ein JSON Web Token (JWT) und ihre Organisations-ID als Anfragekopfzeilen senden. Weiterführende Informationen zum Senden authentifizierter Daten an Platform finden Sie im Handbuch zur Erfassung authentifizierter Daten.

Wie ist die Latenz beim Streaming von Daten an Real-Time Customer Profile?

Streaming-Ereignisse werden in der Regel nach weniger als 60 Sekunden in Real-Time Customer Profile 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 in einer Anfrage-Payload mehrere Nachrichten gruppieren und 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 nicht) an Platform gesendet werden, werden als Batch-Dateien gespeichert, bevor sie in Datensätzen persistiert 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. Weiterführende Informationen zum Verwenden von Experience Platform zur Überwachung von Datenströmen finden Sie im Handbuch zur Überwachung von Streaming-Datenströmen.

Wenn Ihre Daten nicht aufgenommen werden konnten und Sie sie aus Platform wiederherstellen möchten, können Sie die fehlgeschlagenen Batches abrufen, indem Sie ihre IDs an die 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 verschiedene Gründe dafür, warum die Batch-Aufnahme den Data Lake möglicherweise nicht erreicht, z. B. wegen ungültiger Formatierung, fehlender Daten oder vorhandener Systemfehler. Um zu ermitteln, warum ein Batch fehlgeschlagen ist, müssen Sie den Batch mithilfe der Data Ingestion Service API abrufen und die zugehörigen Details anzeigen. 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: [{ORG_ID}]
                Message has unknown xdm format"
        }
    ]
}

Warum werden meine gesendeten Nachrichten nicht vom Real-Time Customer Profile empfangen?

Wenn Real-Time Customer Profile eine Nachricht ablehnt, hängt das höchstwahrscheinlich mit fehlerhaften Identitätsdaten zusammen. 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 Namespaces verwenden, müssen Sie sicherstellen, dass der Namespace beim 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 die Experience Platform UI nutzen, um weitere Informationen zu den Gründen anzuzeigen, warum eine Nachricht nicht aufgenommen wurde. Klicken Sie im linken Navigationsbereich auf Monitoring und dann auf die Registerkarte Streaming End-to-End, um die in einem bestimmten Zeitraum gestreamten Nachrichten-Batches anzuzeigen.