Protokoll und Fehlersuche
Das Postback-Protokoll zeigt eingegangene Ereignisse mit Status und Fehlercode. So findest du heraus, warum etwas nicht gebucht wurde.
Das Postback-Protokoll ist der erste Ort, wenn eine Conversion fehlt. Es listet die letzten 50 Ereignisse deiner Organisation, auch abgelehnte. Hier landen Meldungen aus allen Anbindungen: Shopify, Plugins, Zahlungsanbieter, universeller Webhook, Postback und Testkonsole.
Diese Seite ist für Advertiser. Du findest das Protokoll unter Integration, Reiter Protokoll. Administratoren sehen dort die Ereignisse aller Advertiser. Creator haben kein Protokoll.
- Markierung 1: Die Filter Alle, Angenommen, Duplikat und Abgelehnt laden die Liste mit diesem Status neu. Für die Fehlersuche ist Abgelehnt am nützlichsten.
- Markierung 2: Ein Klick auf Status oder Eingang sortiert die Tabelle. Das wirkt nur auf die geladenen Einträge.
- Markierung 3: Die
event_idverrät die Herkunft eines Eintrags. Siehe Herkunft erkennen. Beim Überfahren mit der Maus erscheint der volle Wert, falls er gekürzt ist. - Markierung 4: Die Marke Test kennzeichnet Meldungen, die als Test gesendet wurden. Gebucht wurde dabei nichts.
- Markierung 5: Einträge aus den Plugins beginnen mit
wc-(WooCommerce) odersw-(Shopware).
- Weiter und ZurückBlättern durch die Tabelle, 25 Einträge je Seite.
- Filter Abgelehnt ohne TrefferEs erscheint Noch keine Postbacks eingegangen. Der Text gilt hier nur für den gewählten Filter. Wechsle zu Alle, um den Rest zu sehen.
- Markierung 1: Der Fehlercode nennt den Grund, meist mit einer kurzen Erklärung. Die Bedeutung steht in den Tabellen weiter unten.
- Markierung 2: „–“ heißt: Die Nachricht hatte keine lesbare
event_id, zum Beispiel bei einem Signaturfehler.
| Spalte | Bedeutung |
|---|---|
| Eingang | Zeitpunkt, zu dem colly das Ereignis erhalten hat. |
| Status | Ergebnis der Verarbeitung. Dazu ggf. die Marke Test. |
| Fehlercode | Der Code samt kurzer Erklärung, falls vorhanden. |
| event_id | Kennung dieser Meldung. |
| transaction_id | Bestell- oder Lead-Nummer. |
| click_id | Die gemeldete Click-ID. „–“ bei Zuordnung über einen Gutschein ohne Klick und bei Statusmeldungen. |
| goal | Das gemeldete Ziel. „–“ heißt, es wurde keins mitgeschickt. |
| Betrag | Der gemeldete Betrag. |
Am schmalen Bildschirm reicht die Tabelle eventuell nicht ganz: Schiebe sie seitlich, um die letzten Spalten zu sehen.
Die Status
| Status | Bedeutung | Fehlercode dabei |
|---|---|---|
| Angenommen | colly hat die Meldung verarbeitet: Conversion angelegt oder Status geändert. | Normal keiner. risk_review: Automatische Freigabe wegen hohem Risiko angehalten, die Conversion bleibt ausstehend. |
| Duplikat | Keine zweite Buchung. Die Bestellung war schon gemeldet oder die Conversion hatte den Status schon. | duplicate_transaction oder keiner |
| Abgelehnt | Nichts wurde gebucht. Der Fehlercode nennt den Grund. | Siehe Tabellen unten. |
Ein Eintrag mit der Marke Test hat alle Prüfungen durchlaufen, aber keine Conversion und keine Provision erzeugt. Angenommen heißt hier also nur: Eine echte Meldung wäre durchgegangen.
Herkunft erkennen
Die Tabelle hat keine Spalte für den Kanal. Am Anfang der event_id erkennst du aber, woher ein Eintrag stammt:
| Beginn der event_id | Herkunft |
|---|---|
shopify- | Shopify |
wc- | WooCommerce-Plugin |
sw- | Shopware-Plugin |
stripe-, lemonsqueezy-, paddle-, digistore24- | Zahlungsanbieter |
custom- | Universeller Webhook |
test- | Testkonsole |
| Etwas anderes | Dein eigener Postback. Die event_id hast du selbst vergeben. |
Abgelehnte Webhooks mit Signaturfehler haben keine event_id. In der Spalte steht dann „–“.
Was nicht im Protokoll steht
Fehlt ein Eintrag, heißt das nicht, dass colly nichts bekommen hat. Diese Fälle erzeugen keinen Eintrag:
| Fall | Wo du es siehst |
|---|---|
| Webhook-Nachrichten, die colly ignoriert: Bestellung ohne Click-ID und Gutschein, offene Zahlung, Abo-Verlängerung, nicht zugeordneter Ereigniswert | Nur Zuletzt: bei der Anbindung ändert sich. |
Postback mit unbekanntem oder widerrufenem Schlüssel (unknown_key), mit Creator-Schlüssel (key_not_allowed) oder ohne Schlüssel (missing_authentication) | colly kann ihn deiner Organisation nicht zuordnen. Die 401-Antwort steht in deinem System, beim WooCommerce-Plugin in der Bestellnotiz. |
Fehler im Format: invalid_json, invalid_payload, payload_too_large | Nur in der Antwort an dein System. |
replay_detected und rate_limited | Nur in der Antwort an dein System. |
Dieselbe event_id noch einmal | Kein neuer Eintrag. Die Antwort wiederholt das ursprüngliche Ergebnis. |
| Webhook an eine entfernte oder inaktive Anbindung | Nur die 404-Antwort beim Absender. |
| Sehr viele fehlerhafte Anfragen (mehr als 20 in 5 Minuten von einer Adresse) | Weitere Fehlversuche werden nicht mehr protokolliert. |
Fehlersuche Schritt für Schritt
Schritt 1: Kommt überhaupt etwas an?
Öffne Alle und suche nach der Bestellnummer in transaction_id. Bei Anbindungen zeigt die Zeile Zuletzt: im jeweiligen Abschnitt, ob Nachrichten eintreffen. Steht dort Noch keine Webhooks empfangen, prüfe die Webhook-URL und die Ereignisse beim Absender. Nachrichten mit Signaturfehler oder an eine Anbindung ohne Schlüssel ändern diese Zeile nicht, stehen aber im Protokoll.
Schritt 2: Abgelehnt? Code lesen
Filtere auf Abgelehnt und schlage den Code in den Tabellen unten nach.
Schritt 3: Angenommen, aber keine Provision sichtbar?
Prüfe die Conversion unter Conversions. Neue Conversions sind zunächst Ausstehend.
Schritt 4: Korrigieren und neu senden
Behebe die Ursache und sende mit einer neuen
event_id. Dieselbe abgelehnteevent_idliefert immer wieder dieselbe Ablehnung. Mit der Testkonsole kannst du Schlüssel und Klick prüfen.
Fehlercodes: Zuordnung
| Code | Bedeutung | Was du tun kannst |
|---|---|---|
click_not_found | Klick-ID unbekannt oder gehört nicht zu deinen Angeboten. | Prüfen, ob die Click-ID unverändert ankommt und der Klick von deinem Angebot stammt. |
attribution_window_expired | Die Conversion liegt außerhalb des Attributionsfensters des Angebots. | Fenster beim Angebot prüfen. Bereits verpasste Fälle bleiben unberührt. |
occurred_before_click | Der gemeldete Zeitpunkt liegt vor dem Klick. | Zeitangabe und Zeitzone prüfen. |
occurred_at_in_future | Der gemeldete Zeitpunkt liegt in der Zukunft. | Zeitangabe und Serverzeit prüfen. |
attribution_missing | Weder gültige Click-ID noch gültiger Gutscheincode. | Übergabe der Click-ID prüfen. |
coupon_not_found | Gutscheincode unbekannt oder abgelehnt. | Code bei Gutscheincodes anlegen. |
coupon_inactive | Der Code ist deaktiviert oder noch nicht freigegeben. | Code aktivieren oder freigeben. |
coupon_not_yet_valid, coupon_expired | Der Code war zum Zeitpunkt der Conversion noch nicht gültig oder abgelaufen. | Gültigkeit des Codes prüfen. |
Fehlercodes: Angebot und Einstellungen
| Code | Bedeutung | Was du tun kannst |
|---|---|---|
unknown_goal | Den Zielschlüssel gibt es bei diesem Angebot nicht. | Ziel korrigieren oder bei den Zielen anlegen. |
no_commission_rule | Für Ziel und Zeitpunkt gibt es keine gültige Provisionsregel. | Provision beim Ziel prüfen. |
amount_required | Bei prozentualer Provision fehlt der Betrag. | Betrag mitsenden oder zuordnen. |
currency_mismatch | Die Währung entspricht nicht der Angebotswährung. | Währungen angleichen. |
daily_cap_reached, monthly_cap_reached | Tages- oder Monatslimit des Angebots erreicht. | Limit beim Angebot prüfen. |
goal_required | Die Transaktion existiert für mehrere Ziele. | Ziel in der Statusmeldung angeben. |
conversion_not_found | Zu dieser Bestellung gibt es keine Conversion. Bei Erstattungen von Bestellungen, die nicht über colly liefen, ist das normal. | Meist nichts. Sonst transaction_id vergleichen. |
partial_refund | Teilerstattung: Der Betrag deckt den gebuchten Umsatz nicht. Nichts wurde gebucht. | Bei Bedarf von Hand unter Conversions bearbeiten. |
transition_not_allowed | Statuswechsel nicht erlaubt, zum Beispiel Storno einer ausstehenden Conversion. | refunded statt reversed senden oder Status prüfen. |
Fehlercodes: Anmeldung und Signatur
| Code | Bedeutung | Was du tun kannst |
|---|---|---|
invalid_signature | Die Signatur passt nicht. Bei Webhooks: Schlüssel stimmt nicht mit dem des Absenders überein. | Schlüssel neu eintragen. Bei Postbacks exakt den gesendeten Text signieren. |
not_configured | Bei der Anbindung ist noch kein Schlüssel hinterlegt. | Schlüssel unter Einstellungen eintragen. |
timestamp_out_of_range | Der Zeitstempel weicht mehr als die erlaubte Toleranz ab. | Serverzeit prüfen. |
Eine vollständige Liste mit HTTP-Status steht im Reiter Postback & API unter Antworten und Fehlercodes. Die Codes partial_refund, not_configured und risk_review erscheinen im Protokoll ohne erklärenden Text. Ihre Bedeutung steht hier.