Zum Hauptinhalt springen

Schemas, Validierung und Auslieferung

Discovery: die Struktur kennenlernen​

Vor dem ersten veröffentlichten Schema helfen repräsentative Events dabei, Eventnamen und Felder zu erkennen. Prüfe die Beobachtungen und entscheide, welche Felder ins Schema gehören. Discovery ist ein Einrichtungsschritt und keine reguläre Warehouse-Auslieferung.

Veröffentlichte Schemas: den Vertrag festlegen​

Eine veröffentlichte Schema-Version definiert die angenommene Eventstruktur. Dein Sender muss seine veröffentlichte Version verwenden. Änderungen werden im Entwurf vorbereitet und als neue Version veröffentlicht. Ein geänderter Entwurf verändert somit nicht stillschweigend einen bestehenden Vertrag.

Prüfe gemeinsame Base-Schema-Felder, eventspezifische Felder, Typen und Pflichtwerte. Feld-Mappings ordnen Eigenschaften wie Eventname und Zeitstempel zu.

Validierungsmodus: prüfen, ohne zu sammeln​

Ein neues Environment mit veröffentlichtem Schema startet im Validierungsmodus, solange seine Destination noch nie bereit war. Validation mode active bedeutet, dass gültige Events geprüft, aber nicht gespeichert oder gequeued werden. Sie werden später nicht nachgeliefert.

So kannst du den Sender vor dem Sammelbetrieb prüfen. Ein Validierungsergebnis ist kein Nachweis, dass das Event im Warehouse liegt.

Sammelbetrieb: neue Events annehmen und ausliefern​

Ein erfolgreich getestetes und gespeichertes Ziel aktiviert den Sammelbetrieb. Neue gültige Events können entsprechend den Destination-Einstellungen gequeued und ausgeliefert werden. Collection active beschreibt den Environment-Modus und bestätigt nicht die Auslieferung jedes einzelnen Events. Consent- und Bot-Einstellungen können Events herausfiltern.

Lies die Ergebnisse der einzelnen Events auch bei erfolgreichen Requests. Ein gequeuetes Event ist zur Verarbeitung angenommen. Prüfe die Auslieferung im Warehouse, bevor du dich in Reports darauf verlässt.

Wenn eine Destination ausfällt​

Ein Environment im Sammelbetrieb wechselt nicht still in den Validierungsmodus zurück. Collection needs attention fordert dich auf, die Destination wiederherzustellen und zu testen. Prüfe den gemeldeten Fehler vor erneuten Sendeversuchen.

Bei fehlenden Daten prüfst du nacheinander Environment, veröffentlichte Schema-Version, Einzelergebnisse, Destination-Status und Verarbeitungsregeln.

Die Tracking-Diagnose erklärt Event-Status, Debug-Header und Wiederholungen.