{"id":12898,"date":"2026-09-06T11:15:00","date_gmt":"2026-09-06T09:15:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=12898"},"modified":"2026-10-24T06:23:55","modified_gmt":"2026-10-24T04:23:55","slug":"meta-insights-api-breakdowns-nur-nach-freischaltung-des-werbekontos","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/de\/digital-marketing-de\/meta-insights-api-breakdowns-nur-nach-freischaltung-des-werbekontos\/","title":{"rendered":"Meta Insights API: Verf\u00fcgbarkeit und Vollst\u00e4ndigkeit von Breakdowns pr\u00fcfen"},"content":{"rendered":"

Eine erfolgreiche Antwort der Insights API belegt weder die Verf\u00fcgbarkeit noch die Vollst\u00e4ndigkeit eines Breakdowns. Seit dem 6. August 2026 beschr\u00e4nkt Meta bestimmte Aufschl\u00fcsselungen auf einigen Werbekonten bis zur Aktivierung der entsprechenden Funktion. Leere Ergebnisse ben\u00f6tigen deshalb eine ausdr\u00fcckliche Diagnose statt einer automatischen Umwandlung in null.<\/p>\n

\"Breakdowns
Vier getrennte Pr\u00fcfschritte; eine passende Summe erg\u00e4nzt die Kontrollen, ersetzt die Pr\u00fcfungen aber nicht.<\/figcaption><\/figure>\n

Welche Aufschl\u00fcsselungen sind betroffen?<\/h2>\n

Metas Ank\u00fcndigung nennt impression_device<\/code>, hourly_stats_aggregated_by_audience_time_zone<\/code> und frequency_value<\/code>. Die Einschr\u00e4nkung der Ger\u00e4tedimension betrifft auch Kombinationen mit dieser Dimension. Das ist keine allgemeine Sperre s\u00e4mtlicher Breakdowns oder Werbekonten. Die Aufschl\u00fcsselung nach Zeitzone des Werbekontos ist eine andere Dimension.<\/p>\n

Weitere Kompatibilit\u00e4tsregeln gelten weiterhin. Beispielsweise wird frequency_value<\/code> zusammen mit Reichweite f\u00fcr Reservation-Kampagnen verwendet. St\u00fcndliche Aufschl\u00fcsselungen unterst\u00fctzen keine Unique-Metriken, Reichweite oder Frequenz; dokumentierte Nullwerte nicht unterst\u00fctzter Metriken belegen keine ausgebliebene Aktivit\u00e4t. Au\u00dferdem reicht die Historie st\u00fcndlicher Daten nur 13 Monate zur\u00fcck. Bestimmte Aktionen au\u00dferhalb von Meta sind mit einzelnen Aufschl\u00fcsselungen nicht verf\u00fcgbar.<\/p>\n

Funktionsstatus, Anfangsdatum und historische Daten<\/h2>\n

Der lesende Endpunkt GET \/act_<ID>\/insights\/feature-settings\/list-features<\/code> listet verf\u00fcgbare Funktionen auf. GET \/act_<ID>\/insights\/feature-settings<\/code> liefert aktivierte Funktionen. Zu den betreffenden Funktionsnamen geh\u00f6ren impression_device<\/code>, time_of_day_viewer_tz<\/code> und frequency_value<\/code>. Diese Namen stimmen nicht immer mit dem jeweiligen Breakdown-Parameter \u00fcberein.<\/p>\n

Ein fehlender Eintrag in einer vollst\u00e4ndigen, autorisierten Antwort \u00fcber aktivierte Funktionen bedeutet einen deaktivierten Funktionsstatus. Eine fehlgeschlagene Anfrage, unvollst\u00e4ndige Seitennavigation oder fehlende Berechtigung liefert diesen Nachweis nicht. Falls vorhanden, kennzeichnet insights_effective_date<\/code> das erste verf\u00fcgbare Datum. Ein fehlendes Anfangsdatum bedeutet laut Dokumentation Verf\u00fcgbarkeit f\u00fcr alle Daten, vorbehaltlich der geltenden Historien- und Metrikgrenzen.<\/p>\n

Meta dokumentiert die Aktivierung im Ads Manager und \u00fcber die Feature-Settings-API. Der API-Aufruf ver\u00e4ndert die Kontokonfiguration, besitzt keine entsprechende Deaktivierungsoperation und kann ungef\u00e4hr 24 Stunden bis zur Wirksamkeit ben\u00f6tigen. Eine erfolgreiche Aktivierungsantwort best\u00e4tigt noch keine verf\u00fcgbaren Berichtsdaten; entscheidend sind der anschlie\u00dfende Funktionsstatus und die tats\u00e4chlichen Ergebnisse.<\/p>\n

Die offiziellen Dokumentationsseiten formulieren die Rolle asynchroner Anfragen unterschiedlich.<\/strong> Hinweise auf der Breakdown-Seite nennen einen asynchronen Abruf als Alternative zur Aktivierung durch die Administration. Die speziellere \u00c4nderungsank\u00fcndigung vom 8. Mai mit Wirkung zum 6. August erkl\u00e4rt dagegen, dass ohne Aktivierung sowohl synchrone als auch asynchrone Anfragen ohne Ergebnisse bleiben k\u00f6nnen. Diese Ank\u00fcndigung beschreibt den asynchronen Abruf historischer Daten nach der Aktivierung mit einer t\u00e4glichen Quote von min(10, number_of_ad_groups)<\/code>. Ein asynchroner Auftrag ist deshalb kein garantiert funktionierender Umweg. Funktionsstatus, Anfangsdatum, zul\u00e4ssige Historie und tats\u00e4chliche Auftragsergebnisse ben\u00f6tigen eine Pr\u00fcfung f\u00fcr das betreffende Konto.<\/p>\n

Der Summenabgleich ist ein Alarm, kein Vollst\u00e4ndigkeitsnachweis<\/h2>\n

Angenommen, ein vergleichbarer Kontogesamtwert enth\u00e4lt 184.300 Impressionen, die abgerufene Aufschl\u00fcsselung dagegen 121.940. Die Differenz betr\u00e4gt 62.360 beziehungsweise rund 33,8 Prozent des Gesamtwerts. Bei einer unterst\u00fctzten, \u00fcberschneidungsfreien und vollst\u00e4ndigen Aufteilung einer additiven Metrik ist diese Abweichung untersuchungsbed\u00fcrftig. Der Prozentsatz bestimmt weder die Ursache noch beweist die Zahl eine fehlende Aktivierung.<\/p>\n

Ein Abgleich ben\u00f6tigt dasselbe Konto, dieselbe Berichtsebene, Datumsgrenzen, Zeitzone, Filter, Metrikdefinition und tats\u00e4chlich wirksame Attributionseinstellungen. Auch unterschiedliche Abrufzeitpunkte k\u00f6nnen wegen nachtr\u00e4glicher Daten\u00e4nderungen Abweichungen verursachen. Berechtigungen, API-Version, nicht unterst\u00fctzte Kombinationen, fehlende Seiten und unvollst\u00e4ndige asynchrone Auftr\u00e4ge bleiben m\u00f6gliche Ursachen.<\/p>\n

Nicht jede Metrik ist additiv. Reichweite kann dieselbe Person in mehreren Gruppen z\u00e4hlen: Zwei Gruppen mit Reichweite 80 und 70 k\u00f6nnen zusammen eine Reichweite von 100 besitzen. Auch die Addition aller Aktionstypen kann hierarchische Kategorien doppelt z\u00e4hlen. Quoten und Durchschnittswerte ben\u00f6tigen passende Bezugsgr\u00f6\u00dfen. Meta beschreibt Breakdown-Werte zudem als Sch\u00e4tzungen; eine angemessene Toleranz h\u00e4ngt deshalb von Metrik und dokumentiertem Verhalten ab.<\/p>\n

Selbst exakte Gleichheit gen\u00fcgt nicht. Die erwarteten Zeilen A=60 und B=40 ergeben dieselbe Summe wie die falsch zugeordneten Zeilen A=40 und B=60. Doppelte Zeilen k\u00f6nnen ausgelassene Zeilen rechnerisch ausgleichen. Ein Summenvergleich belegt weder die korrekte Zuordnung noch eindeutige Schl\u00fcssel oder s\u00e4mtliche angeforderten Dimensionen.<\/p>\n

Eine praktische Pr\u00fcfreihenfolge<\/h2>\n
    \n
  1. Abfragevertrag:<\/strong> Kontozugriff, Berechtigungen, API-Version, unterst\u00fctzte Felder und Breakdown-Kombinationen, Funktionsstatus und verf\u00fcgbarer Zeitraum werden festgehalten.<\/li>\n
  2. Transport und Auftragsstatus:<\/strong> Fehler bleiben sichtbar. Bei asynchronen Berichten werden ein abgeschlossener Auftragsstatus und 100 Prozent Fertigstellung vor dem Ergebnisabruf gepr\u00fcft.<\/li>\n
  3. Alle Seiten:<\/strong> Jeder Verweis in paging.next<\/code> wird verfolgt. Auch eine leere Seite kann einen Folgeverweis enthalten; die Zeilenanzahl allein ist kein Abbruchkriterium.<\/li>\n
  4. Zeilen und Schema:<\/strong> Pflichtfelder, angeforderte Dimensionen, eindeutige Zeilenschl\u00fcssel und fehlende Werte werden gepr\u00fcft. Fehlende Daten bleiben von einer gemessenen null unterscheidbar.<\/li>\n
  5. Geeigneter Summenabgleich:<\/strong> Nur kompatible additive Metriken werden mit einem separat abgerufenen Gesamtwert verglichen. Eine Abweichung l\u00f6st eine Untersuchung aus; Gleichheit erg\u00e4nzt die \u00fcbrigen Pr\u00fcfungen.<\/li>\n<\/ol>\n

    Ein fehlgeschlagener oder ungekl\u00e4rt leerer Abruf sollte keine bisher g\u00fcltige Datenpartition mit Nullen \u00fcberschreiben. Die Pipeline kann den letzten g\u00fcltigen Stand mit sichtbarem Alter und Fehlerstatus erhalten. Best\u00e4tigte leere Ergebnisse d\u00fcrfen erst bei gekl\u00e4rtem Abfrageumfang und Verf\u00fcgbarkeitsstatus als leer gespeichert werden. Historische Nachl\u00e4ufe richten sich nach nachgewiesenem Zeitraum und Quoten, statt nach einer Aktivierung pauschal s\u00e4mtliche fr\u00fcheren Daten vorauszusetzen.<\/p>\n

    H\u00e4ufige Fragen<\/h2>\n

    Belegt HTTP 200 vollst\u00e4ndige Daten?<\/h3>\n

    Nein. Der Status best\u00e4tigt die erfolgreiche Behandlung auf HTTP-Ebene. Funktionsverf\u00fcgbarkeit, Metrikunterst\u00fctzung, Seitennavigation und Zeilenpr\u00fcfung bleiben eigenst\u00e4ndige Pr\u00fcfungen.<\/p>\n

    L\u00f6st eine zus\u00e4tzliche Gesamtwertabfrage das Problem?<\/h3>\n

    Nein. Die Abfrage erg\u00e4nzt einen n\u00fctzlichen Vergleich f\u00fcr geeignete Metriken, verursacht aber zus\u00e4tzliche Quoten- und Wartungskosten. Funktionspr\u00fcfung und Pr\u00fcfung einzelner Zeilen bleiben notwendig.<\/p>\n

    F\u00fchrt eine fehlende Aktivierung immer zu einer leeren Erfolgsantwort?<\/h3>\n

    Ein universelles Antwortmuster ist hier nicht garantiert. Die Ank\u00fcndigung beschreibt m\u00f6gliche fehlende Ergebnisse betroffener Konten; andere Fehler und Ursachen m\u00fcssen weiterhin sichtbar bleiben.<\/p>\n

    Quellen<\/h2>\n