Zum Hauptinhalt springen

​
Wo Sie Protokolle Finden

Navigieren Sie zum Tab Entwicklungstools in Ihrer Topsort-Anzeigenplattform, um auf Echtzeit-Protokolle für Ihren API-Schlüssel zuzugreifen.

​
Protokollverfügbarkeit

UmgebungWas Wird ProtokolliertAufbewahrung
StagingAlle API-Anfragen und -Antworten30 Tage
ProduktionNur Fehler und fehlgeschlagene Anfragen30 Tage
Wenn Ihre Produktions-API-Nutzung zunimmt, können erfolgreiche Anfragen aus den Protokollen gefiltert werden, um die Leistung zu verbessern. Fehler und Debugging-Informationen sind immer verfügbar.

​
Protokolleinträge Verstehen

​
Erfolgreiche Anfragen

Screenshot der Schema-Validator-Benachrichtigung Erfolgreiche API-Aufrufe zeigen:
  • Status: HTTP 200/201/204 Statuscodes
  • Zeitstempel: Wann die Anfrage gestellt wurde
  • Endpoint: Welcher API-Endpoint aufgerufen wurde
  • Antwortzeit: Wie lange die Anfrage gedauert hat
  • Anfragegröße: Größe der Anfrage-/Antwortdaten

​
Fehlereinträge

Screenshot des Schema-Validator-Fehlers Fehlgeschlagene Anfragen enthalten zusätzliche Debugging-Informationen:
  • Status: HTTP-Fehlercode (400, 401, 403, etc.)
  • Fehlerdetails: Spezifischer Fehlercode und Nachricht
  • Anfrage-Body: Welche Daten gesendet wurden (zur Fehlersuche)
  • Stack Trace: Interne Fehlerdetails (wenn verfügbar)

​
Häufige Protokollmuster

​
Authentifizierungsprobleme

401 Unauthorized - invalid_api_key
Missing Authorization header
Lösung: Fügen Sie den Header Authorization: Bearer IHR_API_SCHLÜSSEL hinzu

​
Validierungsfehler

422 Unprocessable Entity - invalid_product_id
Product 'sku_123' not found in catalog
Lösung: Überprüfen Sie, ob das Produkt existiert und korrekt geschrieben ist

​
Ratenbegrenzung

429 Too Many Requests - rate_limited
X-RateLimit-Remaining: 0
Lösung: Implementieren Sie exponentielles Backoff-Wiederholungslogik

​
Protokolle für Debugging Verwenden

​
1. Ereignisse Erscheinen Nicht im Dashboard

Suchen Sie nach:
  • Status 200 bei /events-Aufrufen
  • Validierungsfehler im Event-Payload
  • Zeitstempelproblemen (occurredAt in der Zukunft oder zu alt)

​
2. Leere Auktionsergebnisse

Überprüfen Sie:
  • Kampagnenbudgetstatus
  • Produktverfügbarkeit im Katalog
  • Auktionsanfrageformat

​
3. Attributionsprobleme

Überprüfen Sie Ereignisprotokolle auf:
  • Konsistente Verwendung der Benutzer-ID
  • Angemessene resolvedBidId aus Auktionen
  • Timing von Klick-/Kaufereignissen

​
Best Practices

​
Protokollüberwachung

  • Überprüfen Sie Protokolle nach der Bereitstellung von neuem Integrationscode
  • Überwachen Sie Fehlerraten während Zeiten mit hohem Verkehr
  • Richten Sie Warnungen für wiederkehrende Fehlermuster ein

​
Fehlerbehebungs-Workflow

  1. Reproduzieren Sie das Problem in der Staging-Umgebung
  2. Überprüfen Sie aktuelle Protokolle auf Fehlermuster
  3. Überprüfen Sie das Anfrageformat anhand der API-Dokumentation
  4. Testen Sie mit minimalem Payload um das Problem zu isolieren
  5. Kontaktieren Sie den Support mit Protokollzeitstempeln für komplexe Probleme

​
Datenschutz und Datenverarbeitung

  • Protokolle können sensible Daten aus Ihren Anfragen enthalten
  • Produktionsprotokolle laufen automatisch nach 30 Tagen ab
  • Zugriff auf Protokolle ist nur auf Administratoren beschränkt
  • Personenbezogene Daten in Protokollen folgen Standardrichtlinien zur Datenaufbewahrung

​
Brauchen Sie Hilfe?

Wenn Sie anhaltende Fehler in Ihren Protokollen sehen:
  1. Notieren Sie den Zeitstempel problematischer Anfragen
  2. Kopieren Sie die exakte Fehlermeldung und Anfragedetails
  3. Kontaktieren Sie den Support mit diesen Informationen für eine schnellere Lösung
Unser Team kann auf detaillierte serverseitige Protokolle zugreifen, um bei der Diagnose komplexer Integrationsprobleme zu helfen.