Cloudflare SQL API: Attributauswertung in Berichten prüfen
Die Änderung vom 27. Oktober: Prüfauftrag für Entwickler, zwei Beispielsituationen und ein kontrollierter Wechsel für eigene Traffic-Berichte.
Cloudflare hat am 27. Oktober den Introspection-Parameter include_attributes und das Antwortfeld attributes angekündigt. Die bisherigen Namen funktionieren weiterhin, gelten aber als veraltet.
Für wen ist das relevant?
Für Publisher mit einem eigenen technischen Bericht, dessen Schema über die Cloudflare SQL API ermittelt wird, und für dessen Entwickler. Wer nur ein fertiges Dashboard nutzt, sollte zunächst nachfragen, ob diese API überhaupt verwendet wird. Die Meldung bedeutet weder einen Ausfall sämtlicher Berichte noch einen Anlass, Werbekampagnen umzustellen.
Was ist zu beachten?
Die Dokumentation kennzeichnet die SQL API als Beta. Die Attributerkennung berücksichtigt die letzten sieben Tage der Kontodaten. Eine leere Liste beweist deshalb nicht, dass entsprechende Ereignisse niemals vorhanden waren.
Unser Prüfvorschlag
Suchen Sie im Client nach include_custom_attributes und custom_attributes. Sichern Sie die funktionierende Version. Ändern Sie in einer Testkopie sowohl den Anfrageparameter als auch die Auswertung der Antwort. Vergleichen Sie beide Auswertungen mit einer gespeicherten, bereinigten Antwort und prüfen Sie einen verfügbaren Datensatz. Zugangstoken gehören weder ins Arbeitsblatt noch in den Artikel.
Zwei hypothetische Beispiele
Erstens: Nach der Anfrageänderung ist ein Berichtsfilter leer. Speichern Sie die bereinigte Antwort und prüfen Sie, wo der Client die Liste ausliest. Erwartet er noch das alte Feld, korrigieren Sie zunächst die Testversion, bevor Sie einen Traffic-Verlust vermuten. Zweitens: Ein Attribut kam nur in einer älteren Kampagne vor. Prüfen Sie Beobachtungszeitraum und Ausgangsdaten getrennt. Ersetzen Sie unbekannte Werte nicht durch null. Dies sind Prüfszenarien, keine Kundenergebnisse.
Übergabekarte für Entwickler
Berichtsverantwortlicher; Konto und Datensatz ohne Geheimnisse; Prüfzeit; bisheriges Feld; neues Feld; bereinigte Beispielantwort; erwarteter Filter; tatsächliches Ergebnis; Rückkehr zur Vorversion; Entscheidung und Zuständigkeit.
Abnahmekriterien
Übernehmen Sie die Änderung, wenn die geprüfte Antwort richtig angezeigt wird, fehlende Daten erkennbar sind und die Vorversion gesichert ist. Bei Abweichungen den Austausch des Clients stoppen und die Ursache untersuchen. Ein technischer Fehler allein rechtfertigt keine neue Bewertung einer Traffic-Quelle.
Bezug zur Partnerarbeit
Für die Arbeit auf unserer Plattform können Sie sich bei AffiliateCore anmelden. Technische Cloudflare-Daten und die Bestätigung eines Partnerergebnisses sind getrennte Prüfungen. Der Beitrag kündigt keine Integration an.
Quellen und Prüfdatum
Cloudflare changelog — 2026-10-27; Cloudflare SQL API: Datasets. 2026-10-28.