Kann ich die Payload einer Anfrage validieren, bevor ich sie an Experience Platform sende?
Payloads von Anfragen können erst ausgewertet werden, nachdem sie an Experience 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 Experience 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 Experience 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 Experience 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 Experience 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.
Experience Platform
