> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entwicklerprotokolle

> Greifen Sie auf API-Protokolle in der Topsort-Administrationsplattform zu und interpretieren Sie sie

## 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

| Umgebung       | Was Wird Protokolliert                  | Aufbewahrung |
| -------------- | --------------------------------------- | ------------ |
| **Staging**    | Alle API-Anfragen und -Antworten        | 30 Tage      |
| **Produktion** | Nur Fehler und fehlgeschlagene Anfragen | 30 Tage      |

<Note>
  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.
</Note>

## Protokolleinträge Verstehen

### Erfolgreiche Anfragen

<img src="https://mintcdn.com/topsort/oVmv62U7qVFoTD_d/en/api-reference/5a7e3e4-87895af-Schema-validator-notification.webp?fit=max&auto=format&n=oVmv62U7qVFoTD_d&q=85&s=430bfba5e57697b63ab0eaa29747322a" alt="Screenshot der Schema-Validator-Benachrichtigung" width="1278" height="951" data-path="en/api-reference/5a7e3e4-87895af-Schema-validator-notification.webp" />

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

<img src="https://mintcdn.com/topsort/1RZV69Uhic79Ylqv/en/api-reference/bcb6eb0-b5dedc7-Schema-validator-error.webp?fit=max&auto=format&n=1RZV69Uhic79Ylqv&q=85&s=1562f907c238249ec7141353afe2ab00" alt="Screenshot des Schema-Validator-Fehlers" width="1297" height="463" data-path="en/api-reference/bcb6eb0-b5dedc7-Schema-validator-error.webp" />

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](/de/api-reference)
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.