{"id":9359,"date":"2026-08-10T15:40:00","date_gmt":"2026-08-10T13:40:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=9359"},"modified":"2026-08-10T13:46:58","modified_gmt":"2026-08-10T11:46:58","slug":"meta-marketing-api-v26-0-version-pin-27-oktober-de","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/de\/digital-marketing-de\/meta-marketing-api-v26-0-version-pin-27-oktober-de\/","title":{"rendered":"Meta Marketing API v26.0: Der 27.10.2026 hebelt Ihren Version-Pin aus"},"content":{"rendered":"\n
Meta hat die Graph API v26.0 am 29.07.2026 ausgeliefert. Wer Ad-Automatisierung betreibt, greift jetzt reflexhaft zu dem Vorgehen, das seit Jahren tr\u00e4gt: Changelog lesen, die Integration auf der Version pinnen, die heute l\u00e4uft, und die Migration auf eine ruhige Woche im Fr\u00fchjahr legen. Dieser Reflex versagt diesmal. Am 27.10.2026 werden die zentralen v26.0-\u00c4nderungen in jeder noch unterst\u00fctzten Version wirksam. Der Pin kauft Ihnen nach diesem Datum nichts mehr. Sie haben etwa elf Wochen, und die Arbeit ist ein Inventarproblem, kein Programmierproblem.<\/p>\n\n\n\n
1. Warum der Version-Pin am 27.10.2026 aufh\u00f6rt zu wirken<\/h2>\n\n\n\n
Der \u00fcbliche Vertrag mit einer versionierten API ist einfach. Eine neue Version bringt Breaking Changes, die alte Version beh\u00e4lt ihr Verhalten bis zum End of Life, und Sie entscheiden, wann Sie wechseln. Genau daf\u00fcr gibt es die Versionsnummer.<\/p>\n\n\n\n
Der 27. Oktober bricht diesen Vertrag mit Absicht. Die zentralen v26.0-\u00c4nderungen gelten f\u00fcr alle Versionen, die an diesem Tag noch unterst\u00fctzt werden, nicht nur f\u00fcr Aufrufe, die v26.0<\/code> im Pfad tragen. Der Satz, den Sie im n\u00e4chsten Planungsmeeting h\u00f6ren und in der H\u00e4lfte aller Beitr\u00e4ge zu diesem Release lesen werden, ist deshalb falsch: Nein, Sie sind nicht sicher, nur weil Sie noch auf einer \u00e4lteren Version stehen. Es gibt keine Version, auf der Sie sitzen bleiben k\u00f6nnen und die die entfernten Placements und Felder am Leben h\u00e4lt. Behandeln Sie das Datum als Plattform\u00e4nderung mit Frist, und behandeln Sie die Versionsnummer als irrelevant f\u00fcr Ihre Betroffenheit.<\/p>\n\n\n\n
2. Was laut bricht, und was leise<\/h2>\n\n\n\n
Sechs \u00c4nderungen z\u00e4hlen. Sortieren Sie sie danach, wie sie bei Ihnen ankommen.<\/p>\n\n\n\n
\n
Instagram Explore Feed placement:<\/strong> entfernt, und Requests, die es weiterhin referenzieren, laufen in einen harten Fehler. Das merken Sie innerhalb von Minuten.<\/li>\n
Drei delivery estimate fields:<\/strong> entfernt. Nehmen Sie die exakten Feldnamen aus dem Changelog und aus keiner anderen Quelle, auch nicht aus diesem Artikel, und gleichen Sie sie gegen die Feldlisten ab, die Ihr Code tats\u00e4chlich anfordert.<\/li>\n
Web-only destination:<\/strong> f\u00e4llt weg. Jedes Ad Set, das darauf aufgebaut ist, braucht eine neue Entscheidung \u00fcber das Ziel, keine Konfigurationskosmetik.<\/li>\n
Poll creatives:<\/strong> blockiert. Die Creative-Erstellung schl\u00e4gt fehl.<\/li>\n
Special Ad Category:<\/strong> Ad Sets in den Kategorien Housing, Employment und Financial m\u00fcssen sie ab jetzt explizit setzen. Implizit oder vererbt gen\u00fcgt nicht mehr.<\/li>\n
Messenger Stories:<\/strong> verschwinden still aus messenger_positions<\/code>. Kein Fehler, keine Warnung, kein ver\u00e4nderter Statuscode.<\/li>\n<\/ul>\n\n\n\n
Der letzte Punkt ist der teure. Ihr Alerting h\u00e4ngt mit ziemlicher Sicherheit an Fehlerraten und fehlgeschlagenen Jobs, und die Fehlerrate dieser \u00c4nderung bleibt bei null. Ihre Ad Sets melden weiterhin Erfolg, Ihr Delivery-Mix verschiebt sich, und das erste Signal erreicht Sie Wochen sp\u00e4ter als unerkl\u00e4rlicher Knick in einer Performance-Kurve. Alles, was hart fehlschl\u00e4gt, kostet einen Dienstagvormittag. Ein still entferntes Placement kostet ein Quartal mit tr\u00fcber Attribution.<\/p>\n\n\n\n\nVier Spuren laufen auf ein Datum zu. Bis zum 27. Oktober antwortet eine gepinnte Version noch nach altem Muster, danach verhalten sich alle gleich \u2014 und die \u00c4nderung, die eine Platzierung ohne Fehlermeldung entfernt, geh\u00f6rt zuerst gepr\u00fcft.<\/figcaption>\n<\/figure>\n\n\n
3. Pr\u00fcfen Sie Ihre eigene Konfiguration, nicht die API<\/h2>\n\n\n\n
Beginnen Sie nicht mit Aufrufen gegen die API. Beginnen Sie mit der Konfiguration, die Sie ohnehin speichern, denn dort liegen die kritischen Strings: exportierte Ad-Set-Definitionen, die Templates, die Ihr Kampagnengenerator rendert, die Feldlisten in Ihrem Reporting-Extraktor. Halten Sie die Herstellerfakten in einer einzigen, von Hand gepflegten watchlist.json<\/code>, einmal aus dem Changelog \u00fcbernommen, damit im Skript nichts geraten ist. Alles \u00dcbrige geh\u00f6rt Ihnen.<\/p>\n\n\n\n
#!\/usr\/bin\/env python3\n# audit_v26.py - pr\u00fcft IHRE gespeicherte Ad-Set-Konfiguration auf v26.0-Betroffenheit.\nimport json, pathlib, sys\n\nWATCH = json.loads(pathlib.Path(\"watchlist.json\").read_text())\nCONFIG_DIR = pathlib.Path(\"\/srv\/adops\/adset_configs\")\nREGULATED = {\"housing\", \"employment\", \"financial\"}\n\ndef flatten(node, path=\"\"):\n if isinstance(node, dict):\n for k, v in node.items():\n yield from flatten(v, f\"{path}.{k}\" if path else k)\n elif isinstance(node, list):\n for i, v in enumerate(node):\n yield from flatten(v, f\"{path}[{i}]\")\n else:\n yield path, node\n\nfindings = []\nfor f in sorted(CONFIG_DIR.glob(\"*.json\")):\n doc = json.loads(f.read_text())\n flat = dict(flatten(doc))\n for path, value in flat.items():\n if value in WATCH[\"hard_fail_placements\"]:\n findings.append((f.name, \"HARD_FAIL\", path, value))\n elif \"messenger_positions\" in path and value in WATCH[\"silent_drops\"]:\n findings.append((f.name, \"SILENT\", path, value))\n elif value in WATCH[\"blocked_creatives\"]:\n findings.append((f.name, \"BLOCKED\", path, value))\n for field in WATCH[\"removed_fields\"]:\n hits = [p for p in flat if p.endswith(field)]\n if hits:\n findings.append((f.name, \"REMOVED_FIELD\", hits[0], field))\n if doc.get(\"vertical\") in REGULATED and not doc.get(\"special_ad_category\"):\n findings.append((f.name, \"MISSING_SAC\", \"special_ad_category\", doc[\"vertical\"]))\n\nfor row in findings:\n print(\"\\t\".join(str(c) for c in row))\nsys.exit(1 if any(r[1] == \"HARD_FAIL\" for r in findings) else 0)<\/code><\/pre>\n\n\n\n
Lassen Sie es bis zum Stichtag w\u00f6chentlich laufen, und verdrahten Sie denselben Exit-Code in den Job, der Ihre Kampagnen-Templates ausrollt. Ein HARD_FAIL-Fund nach dem 27.10.2026 ist ein kaputtes Deployment. Lassen Sie also lieber jetzt den Build scheitern als sp\u00e4ter die Kampagne.<\/p>\n\n\n\n
4. Die Checkliste je Endpoint, und der Comscore-Umstieg, den niemand eingeplant hat<\/h2>\n\n\n\n\n
Ad set create und update:<\/strong> Entfernen Sie das Explore Feed placement, setzen Sie messenger_positions<\/code> explizit, statt sich auf Defaults zu verlassen, und setzen Sie die Special Ad Category f\u00fcr jedes Ad Set in Housing, Employment und Financial.<\/li>\n
Creative create:<\/strong> Weisen Sie poll creatives in Ihrer eigenen Validierungsschicht zur\u00fcck, und planen Sie jedes Ad Set neu, das die web-only destination genutzt hat.<\/li>\n
Delivery estimate reads:<\/strong> Streichen Sie die drei Felder aus der Feldliste des Requests, und verfolgen Sie sie danach flussabw\u00e4rts durch Ihre Staging-Tabellen, Transformationsmodelle und Dashboard-Spalten. Die API liefert sie nicht mehr; Ihr Schema beh\u00e4lt eine nullable Spalte klaglos f\u00fcr immer.<\/li>\n
Reporting:<\/strong> Pr\u00fcfen Sie die Geo-Dimension erneut, siehe unten.<\/li>\n
Verifikation:<\/strong> Spielen Sie den gesamten Pfad gegen ein Test-Werbekonto mit kleinem Budget durch, das Sie selbst kontrollieren, einmal vor dem 27.10.2026 und einmal am Morgen danach.<\/li>\n<\/ol>\n\n\n\n
Der Reporting-Punkt h\u00e4ngt nicht am Oktober-Datum, er ist bereits scharf. Am 22.06.2026 hat Meta die geografische Aufl\u00f6sung im Reporting von DMA auf Comscore Markets umgestellt. Wenn Ihr Warehouse Meta-Geo-Zeilen gegen eine DMA-Dimensionstabelle joint, verliert dieser Join seit sieben Wochen stillschweigend Zeilen, und jedes Dashboard, das diesen Sommer mit dem letzten vergleicht, vergleicht zwei verschiedene Geografien. Ermitteln Sie zuerst den Schaden, entscheiden Sie danach \u00fcber das neue Mapping.<\/p>\n\n\n\n
-- Zeilen, die sich nicht mehr gegen die alte DMA-Dimension aufl\u00f6sen lassen.\nSELECT f.report_date, f.geo_name, SUM(f.impressions) AS impressions\nFROM meta_geo_daily f\nLEFT JOIN dim_dma d ON d.dma_name = f.geo_name\nWHERE f.report_date >= DATE '2026-06-01'\n AND d.dma_code IS NULL\nGROUP BY 1, 2\nORDER BY impressions DESC\nLIMIT 25;<\/code><\/pre>\n\n\n\n
5. Fazit<\/h2>\n\n\n\n
Sie haben zwei kleine Dinge gebaut: ein Audit-Skript, das Ihre eigene gespeicherte Ad-Set-Konfiguration gegen eine von Hand kopierte Watchlist liest und bei allem, was hart fehlschlagen wird, mit einem Exit-Code ungleich null endet, und eine Checkliste, die jede v26.0-\u00c4nderung dem Endpoint und der nachgelagerten Tabelle zuordnet, die sie ber\u00fchrt. Keines von beidem h\u00e4ngt an geratenen API-Antworten.<\/p>\n\n\n\n
Was Ihnen das einbringt, ist der Unterschied zwischen es am 27.10.2026 zu erfahren und es heute zu wissen. Die lauten \u00c4nderungen h\u00e4tten Sie ohnehin eingeholt. Der Wert liegt in den beiden, die das nicht tun: Messenger Stories, die ohne Fehler aus messenger_positions<\/code> verschwinden, und der Wechsel von DMA auf Comscore, der Ihr Geo-Reporting seit Juni verzerrt. Und es bringt Ihnen die eine Korrektur, die man jeder Quartalsplanung wiederholen sollte: Das Pinnen auf eine \u00e4ltere Version ist hier keine Absicherung. Pr\u00fcfen Sie jeden Feldnamen und jeden Placement-String gegen die Prim\u00e4rquelle, bevor Sie eine Zeile \u00e4ndern: Graph API Changelog, version 26.0<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"
![\"Vier](\"https:\/\/www.lukaswojcik.com\/blog\/wp-content\/uploads\/diagrams\/hand-metav26-de.png\")
\n