Paid Social aus Cockpit — Spec & Roadmap
Stand: 2026-09-28 · Status: Phase 1 MVP implementiert (0.1.445) — Boost pausiert, Pilot mit ZERNIO_ADS_WRITE_ENABLED
Bezug: Social unter einem Cockpit-Dach · Social Capability Registry
Was
Redaktion und Center-Marketing sollen bezahlte Reichweite für Social-Inhalte aus dem Cockpit steuern — ohne Meta Business Manager (BM) für den Standardfall zu öffnen.
| Phase | Lieferung | Priorität |
|---|---|---|
| Phase 1 | Post bewerben — einen bereits über Cockpit/Outstand veröffentlichten Beitrag auf Facebook/Instagram boosten (Budget, Laufzeit, Zielgruppe grob) | Primär (Nutzeranfrage) |
| Phase 2 | Neue Anzeige — optional später: Anzeige/Kampagne mit Creative aus Entwurf oder Mediathek, ohne vorherigen Organic-Post | Backlog |
Heute liefert cockpitOS Paid-Reporting (Meta/Google KPIs via Zernio, Read-only). Paid-Steuerung (Boost/Kampagne anlegen) fehlt.
Warum
- Ein Workflow: Post erstellen → freigeben → veröffentlichen → direkt bewerben — ohne Medienbruch.
- Governance: Budget, Freigabe und Nachvollziehbarkeit im gleichen System wie organische Freigaben.
- Skalierung: Viele Center, teils gemeinsames Portfolio-Werbekonto — Cockpit kennt bereits
center_ads_accountsundcampaignFilter.
Organisches Publishing bleibt bei Outstand; Paid-Metriken und (geplant) Paid-Writes laufen über Zernio als Backend — analog zur bestehenden Ads-Read-Architektur.
Wer ist betroffen
| Rolle | Phase 1 |
|---|---|
| Redaktion / Center-Marketing | Boost-Dialog nach Live-Post; Status „Beworben“ am Post |
| Freigabe / Org-Marketing | Optional zweite Freigabe für Paid (Budget-Schwellwert) |
| Center-Betrieb / KAM | Sicht auf laufende Boosts in Performance / Kunden-Reporting |
| Dev / Betrieb / IT | Zernio Write-API klären, Env, Mapping, MCP-Parität |
| Besucher | Keine direkte UI — mehr Reichweite auf Social-Kanälen |
Voraussetzungen
Bereits im System
| Voraussetzung | Ist-Zustand |
|---|---|
| Organischer Post via Cockpit | Outstand Publish, SocialPostDraft.outstandPostId, publishChannels |
| Meta-Post-ID pro Kanal | publishChannels.channels[].platformPostId nach erfolgreichem Publish (Facebook/Instagram) |
| Werbekonto-Mapping | center_ads_accounts (meta_ads / google_ads), Auto-Link + manuell im Social-Hub |
| Paid KPIs (Read) | Zernio GET /ads/tree, Cron zernio-ads-sync, Performance includeAds=1 |
| Capability Registry | metaAdsMetrics, googleAdsMetrics, Boost via MCP cockpit_social_boost_post |
| Boost Write (0.1.445+) | POST /ads/boost, social_paid_promotions, Dialog „Beitrag bewerben“, Start PAUSED |
platformAdAccountId | Backfill + Auflösung aus Portfolio-Kampagnen-Filter (0.1.446) |
Phase 1.1 — nächste sinnvolle Schritte (Okt 2026 API-Review)
- Geo-Targeting — Zernio Boost
targeting.cities/ Radius um Center-Adresse (Roadmap, noch nicht im Dialog). instagramAccountId— optional aus ZernioGET /accounts/{id}/facebook-page(Pages mit mehreren IG-Identities).- Boost-Status async — Poll bis 5 Min (Env
ZERNIO_BOOST_POLL_TIMEOUT_MS); bei Timeout Status „In Prüfung“ und Cron-Nachzug. Meta-Review-Feedback (0.1.915):GET /v1/ads/{adId}/reviewim Panel „Beitrags-Bewerbung“ bei Ablehnung / Placement-Ausschluss. - Rechtliches / Meta-Richtlinien — Wer darf Budget binden? Payment Method bleibt in Meta BM.
- Phase 2 —
POST /ads/create(neue Anzeigen, nicht nur Boost).
Scope Phase 1 — Post bewerben (Boost)
Produktziel
Nach erfolgreichem Publish (Status published, mindestens ein Kanal facebook oder instagram mit platformPostId) kann Redaktion „Beitrag bewerben“ wählen.
Minimaler Funktionsumfang (MVP)
- Boost nur für Posts, die über Cockpit/Outstand live sind (kein Boost fremder Kanal-Inbox-Posts in Phase 1).
- Ein Kanal pro Boost-Vorgang (Facebook oder Instagram — je nachdem, wo der Post live ist).
- Parameter (Vorschlag MVP):
- Tagesbudget oder Gesamtbudget (EUR)
- Laufzeit (z. B. 3 / 7 / 14 Tage oder Enddatum)
- Ziel (Vorschlag: Reichweite oder Interaktionen — keine volle Ads-Manager-Zielgruppe in MVP)
- Optional: Geo-Radius um Center (Adresse aus Stammdaten)
- Status im Cockpit:
draft→pending_approval→submitted→active|completed|failed - Anzeige in Social → Performance (Paid-Anteil) und Verknüpfung zum Organic-Post
Explizit nicht in Phase 1
- Google Ads, TikTok Ads
- Boost für Story/Reel ohne klare Meta-Boost-API-Unterstützung ( erst nach API-Check )
- A/B-Creative, Custom Audiences, Pixel-Conversions
- Automatischer Boost nach Publish ohne menschliche Bestätigung
Scope Phase 2 — Neue Anzeige (optional)
- Anzeige aus Entwurf-Medien/Caption (ohne vorherigen Organic-Post) oder aus Mediathek
- Kampagnen-Name nach Center-Konvention (
campaignFilter.prefixes) - Freigabe-Workflow analog Phase 1, ggf. höhere Budget-Schwellen
- Google Ads nur wenn Zernio Write + Center-Mapping ausgereift
Empfehlung: Phase 2 erst nach Phase-1-Pilot und stabilen Zernio-Write-Verträgen.
User-Flows (Redaktion)
Flow A — Boost nach Publish (Happy Path)
- Social → Neuer Post — Entwurf erstellen, Kanäle wählen, Freigabe (bestehender Workflow).
- Nach Freigabe: Veröffentlichung über Outstand → Webhook/Cron setzt
publishChannelsinkl.platformPostId. - Social → Freigaben oder Performance — beim Live-Post erscheint Aktion „Beitrag bewerben“ (nur wenn
center_ads_accounts.meta_adsbereit undplatformPostIdvorhanden). - Dialog: Budget, Laufzeit, Ziel, Vorschau Center/Post → Zur Paid-Freigabe oder Direkt starten (Rolle abhängig).
- Freigeber bestätigt → Cockpit ruft Zernio Write → Status Aktiv.
- Redaktion sieht Boost-KPIs neben Organic (Snapshot + optional Sync-Button).
Flow B — Abgelehnt / fehlende Voraussetzung
- Kein Mapping → Hinweis im Social-Hub Werbung + Link Auto-Zuordnung (
POST /api/social/center-ads/complete). - Publish ohne
platformPostId→ „Boost erst nach Live-Sync verfügbar“ + manueller Refresh Outstand-Status. - Budget über Org-Limit → Freigabe an Org-Marketing.
Flow C — Agent / MCP (später)
- Agent listet publishierte Posts → schlägt Boost vor → Mensch freigibt im Dashboard (kein Auto-Spend ohne Freigabe in MVP).
Technik
Datenmodell (Vorschlag)
Neue Tabelle social_paid_promotions (additiv, kein Datenverlust):
| Feld | Typ | Zweck |
|---|---|---|
id | UUID | PK |
centerId | FK | Center |
socialPostDraftId | FK | Quell-Entwurf |
type | enum | boost (Ph1) | ad (Ph2) |
channel | string | facebook | instagram |
platformPostId | string | Meta Post-ID (aus publishChannels) |
outstandPostId | string? | Referenz Outstand |
zernioAccountId | string | Aus center_ads_accounts |
platformAdAccountId | string? | Meta act_… falls nötig |
budgetCents | int | Budget in Cent |
currency | string | default EUR |
durationDays | int? | Laufzeit |
objective | string | reach, engagement, … |
targeting | JSON? | Geo, Alter grob |
status | string | draft, pending_approval, active, completed, failed, cancelled |
zernioJobId / externalAdId | string? | Rückreferenz Zernio/Meta |
submittedById, approvedById | FK User | Audit |
errorMessage | string? | Fehler |
createdAt, updatedAt | timestamps |
Optional: Denormalisiertes JSON am SocialPostDraft nur für UI-Badge — SSOT = eigene Tabelle.
Post-ID-Verknüpfung (Outstand → Meta)
Bereits vorhanden in social-publish-channels.ts:
- Nach Publish:
publishChannels.channels[]mitnetwork,status,platformPostId - Boost-Eligible:
status === 'published'&&network in ('facebook','instagram')&&platformPostIdgesetzt - Story-Serien:
outstandPostIds[]— pro Slide prüfen; Boost MVP ggf. nur Feed-Post (postType === 'feed')
Fallback-Enrichment (falls Webhook fehlt): Outstand Post-Details nachladen (channelsFromOutstandPost) und publishChannels backfillen — vor Boost-Dialog.
API-Routen (Vorschlag)
| Methode | Pfad | Zweck |
|---|---|---|
GET | /api/social/paid-promotions?centerId= | Liste Boosts/Ads |
GET | /api/social/paid-promotions/eligibility?draftId= | Kann Post geboostet werden? |
POST | /api/social/paid-promotions | Boost anlegen (type: boost, draftId, budget, …) |
POST | /api/social/paid-promotions/{id}/submit | Zur Freigabe |
POST | /api/social/paid-promotions/{id}/review | Freigabe / Ablehnung |
POST | /api/social/paid-promotions/{id}/cancel | Abbrechen (wenn API unterstützt) |
| AgencyOS | POST /api/agencyos/v1/social/paid-promotions | Parität Read/Write für Agenten |
Cron (optional): Status-Sync aktiver Boosts von Zernio → social_paid_promotions.status + KPI-Snapshot.
UI-Pfade
| Ort | Phase 1 |
|---|---|
| Social → Freigaben — Detail/Live-Post | Primary CTA Beitrag bewerben |
| Social → Performance — Zeile publishter Post | Sekundär CTA + Badge „Beworben“ |
| Social-Hub → Werbung | Readiness unverändert; Hinweis „Paid-Steuerung: Pilot“ |
| Center → Social Media → Erweitert | Budget-Limit Org/Center (Phase 1.1) |
Keine Vendor-Namen in UI — „Beitrag bewerben“, „Werbebudget“, nicht „Zernio Boost“.
Capability Registry (Erweiterung)
Neue Einträge in social-capability-registry.ts:
| Capability-ID | userLabel | module | primary |
|---|---|---|---|
metaAdsBoost | Beitrag bewerben | social-performance | zernio |
metaAdsCreate | Anzeige schalten | social-post | zernio (Phase 2) |
resolveChannelProvisioning / Hub: Chip Beitrag bewerben nur wenn meta_ads mapping ready und Zernio Write konfiguriert (Feature-Flag).
MCP-Parität-Checkliste (bei Implementierung)
-
SOCIAL_CAPABILITY_REGISTRY—metaAdsBoost(+ Ph2metaAdsCreate) - AgencyOS-Doku
api-agencyos-integration.md— neue Routen - MCP-Tools:
cockpit_social_paid_promotion_create,_list,_review(Parameter: centerId, draftId, budgetCents, …) -
exports/cockpitos-tools.json— Export aktualisieren - MCP-Tab-Hints nur falls Website-Config-Felder (Budget-Limits) — ggf. Center-Settings JSON
- Nutzer-Doku:
social-unter-cockpit.md,social-media-freigabe.md(Paid-Abschnitt) - Changelog
plattform/changelog.mdbei Go-Live
Zernio-Client — dokumentierte vs. fehlende Endpoints
Im Repo implementiert (Stand Code-Review 2026-09-28):
| Endpoint | Methode | Client | Zweck |
|---|---|---|---|
/accounts | GET | zernio-client.ts | Konten listen |
/ads/tree | GET | zernio-client.ts | Kampagnen-KPIs (Read) |
/posts | GET | zernio-posts-client.ts | Externe Posts |
/accounts/{id}/posts | GET | zernio-posts-client.ts | Live Posts |
/posts/sync-external | POST | zernio-posts-client.ts | Sync anstoßen |
/inbox/comments/{postId} | POST | zernio-inbox-client.ts | Antwort |
/inbox/comments/.../hide | POST | zernio-inbox-client.ts | Verbergen |
/inbox/comments/.../like | POST | zernio-inbox-client.ts | Liken |
/analytics | GET | zernio-organic-analytics-client.ts | Organic KPIs |
/accounts/follower-stats | GET | zernio-organic-analytics-client.ts | Follower |
Nicht im Repo — für Paid Social nötig (Cockpit-Client fehlt; Zernio-Doku vorhanden):
| Endpoint | Methode | Zweck | Zernio-Doku |
|---|---|---|---|
/ads/boost | POST | Published Post → Paid Ad (behält Likes/Kommentare) | Boost a Post |
/ads/create | POST | Standalone Ad / volle Kampagne (Creative, Budget, Targeting) | Create standalone ad |
/ads/create (validateOnly: true) | POST | Dry-Run ohne Spend (Meta-only) | Duplicate & Lifecycle |
/ads/tree | GET | Hierarchie + Metriken (bereits im Repo) | — |
/ads | GET | Ad-Status nach Boost (Polling) | — |
Weitere Writes (noch nicht im Cockpit): Campaign/AdSet/Ad Update (pause, cancel, budget), Webhooks für Review-Status.
→ Neues Modul vorgeschlagen: zernio-ads-write-client.ts (nach Zernio OpenAPI/SDK).
Phase 0 Ergebnis (Discovery 2026-09-28)
Fazit: Write-API verfügbar?
Ja — dokumentiert bei Zernio, nicht im Cockpit-Repo implementiert.
Zernio bietet seit Sep 2026 eine Ads Write API (POST /v1/ads/boost, POST /v1/ads/create) über denselben Bearer-Token wie Read/Inbox/Posts. Im Cockpit existiert kein Client dafür — nur Read (GET /accounts, GET /ads/tree) plus Inbox/Posts-Writes.
Repo-Scan (alle Zernio-Clients)
| Client | Endpoints | Write? |
|---|---|---|
zernio-client.ts | GET /accounts, GET /ads/tree | Nein |
zernio-posts-client.ts | GET /posts, GET /accounts/{id}/posts, POST /posts/sync-external | Sync only |
zernio-inbox-client.ts | GET/POST /inbox/comments/… (reply, hide, like) | Ja (Engage) |
zernio-organic-analytics-client.ts | GET /analytics, GET /accounts/follower-stats | Nein |
Kein Treffer im Repo für boost, promote, POST /ads, ads/create, ads/boost.
Zernio Boost-API (Kernfelder für Phase 1)
POST https://zernio.com/api/v1/ads/boost — Body (Auszug):
- Pflicht:
accountId(Zernio Social/Meta-Connection),adAccountId(Metaact_…),name,goal,budget(amount,type:daily|lifetime) - Post-Referenz:
postId(Zernio) oderplatformPostId(MetapageId_postId/ IG media id) — für Outstand-Publish eignet sichplatformPostIdauspublishChannels - Optional:
schedule(startDate,endDate),targeting(Geo, Alter, Interests),linkUrl+callToAction,status: "PAUSED"(Review vor Spend) - Idempotenz: Header
Idempotency-Key— ohne Key:409bei Duplikat in Flight; Replay innerhalb 10 Min liefert bestehende Ad - Response:
201mitad._id,platformAdId,reviewStatus,status
Goals: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion.
Zernio Create-API (Phase 2)
POST /v1/ads/create — Standalone Ad mit Creative (headline, body, imageUrl, …), flat body oder adSetId-Attach. validateOnly: true für Meta Dry-Run ohne Persistenz.
Offene Fragen an Zernio-Team (SMG)
- API-Zugang: Ist Ads Write für unseren Org-Key (
ZERNIO_API_KEY) freigeschaltet? (Legacy-Pläne →403laut Doku.) - Boost mit Outstand-Post: Reicht
platformPostId(FB/IG) +accountIdauscenter_ads_accounts, oder muss der Post vorher via Zernio/Outstand sync sein? adAccountId-Auflösung: Liefert Zernioact_…prozernioAccountId, oder muss CockpitplatformAdAccountIdincenter_ads_accountspflegen?- Portfolio-Kampagnen: Sollen Boosts eigene „Cockpit Boost“-Kampagne bekommen oder an bestehendes ILG-Portfolio (
campaignFilter.prefixes) andocken (adSetId)? - PoC-Umgebung: Test-Boost mit
status: PAUSED+ Minimalbudget — wer trägt Meta-Spend-Risiko? - Webhooks: Gibt es Events für
reviewStatus/ Ad-Approval, oder nur Polling viaGET /v1/ads? - Rate Limits: Boost kann Minuten dauern (IG-Video-Rehost) — empfohlene Client-Timeouts?
Nächster Schritt (Phase 0 → 1)
- Zernio-Fragen klären (Liste oben).
- PoC-Skript
zernio-ads-write-client.ts+ ein Test-Boost (PAUSED, Idempotency-Key). - Feature-Flag
ZERNIO_ADS_WRITE_ENABLEDin Render-Env.
Security & Governance
| Thema | Vorschlag |
|---|---|
| Auth | Session + Center-Zugriff; mutierende Routes nie public |
| Rollen | Boost anlegen: Redaktion mit Center-Zugang; freigeben: Org-Marketing / Center-Admin / konfigurierbarer Paid-Approver-Pool |
| Budget-Limits | Org- und Center-Caps (maxDailyBoostCents, maxActiveBoosts) — Überschreitung → Freigabe |
| Idempotenz | Ein aktiver Boost pro (draftId, channel) — Doppelklick verhindern |
| Audit | social_paid_promotions + Center-Audit-Log (social_paid_promotion) |
| Secrets | Nur ZERNIO_API_KEY serverseitig; keine Meta-Tokens im Frontend |
| SSRF | Keine user-supplied URLs an Zernio — nur gespeicherte IDs |
AgencyOS/MCP: Kein Auto-Spend ohne explizite Freigabe-Regel in MVP.
Abgrenzung — was in Meta BM bleibt
| In Meta BM / Agentur | In Cockpit (Phase 1) |
|---|---|
| Zahlungsmethode, Rechnungsadresse | — |
| Werbekonto-Struktur, Pixel, CAPI | — |
| Komplexe Zielgruppen, Lookalikes, Catalog Ads | — |
| Policy-/Ad-Review-Eskalation | Status-Anzeige + Fehlertext |
| Portfolio-Kampagnen-Naming (ILG-Präfixe) | Weiterhin campaignFilter für Reporting; Boost evtl. eigene „Cockpit Boost“-Kampagne (Klärung Zernio) |
Mapping-Verifikation (Dry-Run 2026-09-28)
Skript
cd apps/dashboard && DOTENV_CONFIG_PATH=.env.local pnpm exec tsx scripts/auto-link-zernio-ads.ts --dry-run
Alternativ: POST /api/integrations/zernio/auto-link mit { "dryRun": true } (SUPER_ADMIN, ZERNIO_API_KEY gesetzt).
Ergebnis Auto-Link-Dry-Run (2026-09-28)
| Metrik | Wert |
|---|---|
ZERNIO_API_KEY lokal (.env.local, Root .env) | Nicht gesetzt |
| Skript | cd apps/dashboard && DOTENV_CONFIG_PATH=.env.local pnpm exec tsx scripts/auto-link-zernio-ads.ts --dry-run |
| Fehler | ZERNIO_API_KEY fehlt |
zernioAccounts / campaignsScanned | 0 |
pendingPrefixes / unmatchedPrefixes | leer (kein Zernio-Scan) |
links (would create) | 0 |
Production-API POST /api/integrations/zernio/auto-link nicht aufgerufen (keine Session-Creds). Render-Env nicht abgefragt.
DB-Snapshot (Live-DB via Prisma, unabhängig vom Dry-Run)
Quelle: DATABASE_URL aus .env.local · center_ads_accounts (channel = meta_ads, isActive = true) · Center ohne Slugs demomall/test.
| Metrik | Wert |
|---|---|
| Gemappte Center (meta_ads) | 121 |
| Center gesamt | 154 |
| Unmapped | 33 |
Anhang: 33 Center ohne center_ads_accounts (meta_ads)
| # | Name | Slug | Center-ID |
|---|---|---|---|
| 1 | Activ-Arkaden Horb | activ-arkaden-horb | cbe52e14-4188-4001-ade1-6678e14d908c |
| 2 | Bensheimcenter | bensheimcenter | 28c2f850-2f8c-4732-bef7-07e2c28d299d |
| 3 | Brandt-Quartier | brandt-quartier | 663a1149-359e-4ca4-a86e-33e2bc62fd95 |
| 4 | City Galerie Aschaffenburg | city-galerie-aschaffenburg | 450dc22e-e052-44a4-80f6-fe363df7e6b0 |
| 5 | Claudius Fachmarktzentrum | claudius-fachmarktzentrum | d34745c4-75b3-4d12-82d9-d9063baa681b |
| 6 | Cottbus Center | cottbus-center | 880109ef-f6da-4399-a7f9-6bca88377d0d |
| 7 | Donau-Einkaufszentrum | donau-einkaufszentrum-1 | c5400bf0-f48a-4e6b-8310-d198ee54d213 |
| 8 | Donau Meile | donaumeile | ec3c37dc-efc0-4d9d-8f5e-531f4834927f |
| 9 | Flensburg Galerie | flensburg-galerie | 675d9f74-c46f-444e-b5c9-022f906b7612 |
| 10 | FLORAPARK Magdeburg | florapark-magdeburg | 16aa88aa-b4ab-4e79-b776-32ef2c815440 |
| 11 | Forum Hanau | forum-hanau | 3d4f4bcd-0a3c-4aa0-a825-dfd0c4d57e37 |
| 12 | Forum Hitzbleck Heiligenhaus | forum-hitzbleck-heiligenhaus | 000ed937-7f4f-4ece-8a12-49468867ecec |
| 13 | Frankenberger Tor | frankenberger-tor | e80b1124-b5d6-4b8f-aa4c-a7251c350a70 |
| 14 | Giesler Galerie | giesler-galerie-1 | 1f25a829-8496-4c6c-8928-5b987820064a |
| 15 | Griesheim Center | griesheim-center | da73d985-282f-4d8e-8272-f8523041d390 |
| 16 | Handelscentrum Strausberg | handelscentrum-strausberg | 05a7512c-6e3f-42c1-92ae-7b9767e440e4 |
| 17 | Intro Bergheim | intro-bergheim | 5178324c-51da-4fa4-9dd8-90c804f81cf7 |
| 18 | Krohnstieg Center Hamburg | krohnstieg-center-hamburg | a3040c5f-f46d-45c8-a92b-236b1c64cdfd |
| 19 | Landskron Galerie | landskron-galerie | 9b642c5d-52be-4372-8e46-473667bef5b2 |
| 20 | LOOP5 Weiterstadt | loop5-weiterstadt | ee68ecc5-ac32-4932-9bc3-32cfbf8caa3e |
| 21 | Mercaden Dorsten | mercaden-dorsten | 2719cc6f-9f40-425e-bacf-928c89c44ef7 |
| 22 | Neustadt Centrum Halle | neustadt-centrum-halle | 9f0cdeca-4b9f-441a-8c8f-6f3cb126d492 |
| 23 | Nordpark Alzenau | nordpark-alzenau | b11e85db-16ff-4ccd-bc2c-c6d504615b7a |
| 24 | QUARREE Wandsbek | quarree-wandsbek | 58675bbf-c778-4eea-bb71-50b46f5aa572 |
| 25 | RemsGalerie | remsgalerie | 09b64b45-8087-40a5-9a5c-6e16d9bb9152 |
| 26 | Saalbachcenter Bruchsal | saalbachcenter-bruchsal | 81a6207e-ee82-4788-9861-8d0edc517f2b |
| 27 | Schlössle-Galerie | schloessle-galerie | 5d60f788-455d-46d3-b4fa-a8d774bedf77 |
| 28 | Schönwalde-Center Greifswald | schoenwalde-center-greifswald | 33484da0-b9ae-4218-b3d5-3d7d9b057a58 |
| 29 | Theresien Center Straubing | theresien-center-straubing | 6cecad5e-f7c5-46e4-9e73-c8067abed90b |
| 30 | Tierpark Center | tierpark-center | e1d6c08f-1c7b-4060-921c-7c56af807b18 |
| 31 | Traunpassage | traunpassage | 4a75c95a-66d2-460d-ac0a-993e2ea88543 |
| 32 | Vita Center Chemnitz | vita-center-chemnitz-1 | b5a320fa-be7e-4879-b55b-41cef8c1f894 |
| 33 | Wiesencenter Jena | wiesencenter-jena | 590d739b-ca33-469e-9954-9e7c513a0d48 |
Hinweis: Vollständiger Auto-Link-Dry-Run inkl. pendingPrefixes erfordert ZERNIO_API_KEY (Production Render oder lokales .env.local). Nach Setzen: Skript erneut ausführen und Auto-Link-Sektion aktualisieren.
Implementierungsphasen (Roadmap)
| Phase | Lieferung | Abhängigkeit |
|---|---|---|
| 0 — Discovery | Zernio Write-API Spec, Meta Boost via Zernio PoC, Feature-Flag | Zernio Partner |
| 1.0 — Boost MVP | DB, API, UI an Live-Post, Zernio Write (PAUSED), MCP | Live (0.1.445) |
| 1.1 — Limits & Reporting | Budget-Caps, Boost-KPIs in Performance, Audit | 1.0 |
| 2.0 — Neue Anzeige | Creative aus Entwurf, Kampagnen-Naming | 1.x stabil |
Kein VERSION-Bump allein für diese Spec — erst bei implementiertem Feature apps/dashboard/VERSION anheben.
So testen (nach Implementierung)
- Center mit
center_ads_accounts.meta_ads(Social-Hub → Werbung → Bereit). - Feed-Post veröffentlichen → in DB/UI
platformPostIdfür Facebook oder Instagram prüfen. - Beitrag bewerben — Minimalbudget, 3 Tage, Reichweite.
- Freigabe durch Org-Marketing → Status Aktiv; Zernio/Meta zeigt Ad.
- Performance / Kunden-Reporting — Paid-Metriken steigen im Snapshot.
- MCP:
cockpit_social_paid_promotion_create+_review(Dry-Run-Modus falls angeboten).
Siehe auch
- Client-Reporting — Ads
- Social Capability Registry
- Social-Agent-Modus — Freigabe-Pools auch für Paid denkbar
- Migration:
packages/database/migrations/20260708120000_add_zernio_ads_SAFE.md
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/plattform/roadmap-paid-social-aus-cockpit