Werbe-SDK

14.1 Was das Werbemodul heute ist (geprüft in D:/Claude/Werbemodul)

14.2 Technische Hürden in Godot

1. Kein MP4: [Fakt] Godot spielt Video nur als Ogg Theora (VideoStreamTheora). Die Werbevideos (H.264-MP4) müssen per ffmpeg konvertiert werden (ffmpeg -i x.mp4 -c:v libtheora -q:v 6 -c:a libvorbis x.ogv). Theora ist bei gleicher Qualität größer und braucht mehr CPU → [Vorschlag] im MVP nur Bild-Anzeigen und Platzhalter; Video ab Phase 3, nach Messung auf dem A13.
2. Keine WebView: Spielbare Anzeigen (HTML) brauchen eine WebView. Godot hat keine eingebaute → nicht im MVP. Möglich wäre später ein Android-WebView-Plugin.
3. Kein Rewarded-Modus im Kern: Es gibt kein Konzept „Anzeige auf Wunsch des Spielers, Rückmeldung bei Abschluss“. beginBlock(force=true) ist laut Doku ausdrücklich eine Testvorschau, die Zähler und Mindestabstand ignoriert – sie darf nicht als Rewarded-Ersatz missbraucht werden.
4. Kern ist TypeScript: Er muss in GDScript portiert werden (Logikanteil ≈ 900 Zeilen; der Katalog mit ≈ 1 300 Zeilen ist Daten und wird als JSON exportiert statt portiert).

14.3 AdManager – zentrale, austauschbare Schnittstelle

scripts/autoload/ads.gd ist das einzige, was das Spiel kennt. Dahinter steckt ein austauschbarer Adapter.

# ads.gd (Autoload) – öffentliche Schnittstelle
signal ad_started(placement: String)            # Spiel pausiert Simulation/Audio
signal ad_finished(placement: String, completed: bool)

func event(name: String) -> void                # meldet Spielereignisse an den Adapter (Auslöser-Logik)
func can_offer_rewarded(placement: String) -> bool
func show_rewarded(placement: String, on_done: Callable) -> void   # on_done.call(completed: bool)
func is_showing() -> bool
func set_consent(analytics_allowed: bool) -> void

# Adapter-Vertrag (scripts/services/ads/*.gd)
class_name AdAdapter extends RefCounted
func init(config: Dictionary) -> void
func on_event(name: String) -> bool             # true = Block wird jetzt gezeigt
func begin_rewarded(placement: String) -> bool
func end_block(completed: bool) -> void

14.4 Einbindung in Pocket Planet

Ereignis-Abbildung (Pocket Planet hat keine „Spiele“ mit Ende – wir bilden auf vorhandene AdEvent-Werte ab, statt neue zu erfinden):

Empfohlene Konfiguration (lockedConfig) [Vorschlag]: Modus „nach Spielen“, Zähler 2, Werbung erst beim Verlassen des Endbildschirms, frequencyCapMinutes 20 (statt 2: Pocket-Planet-Sitzungen sind kurz), graceGames so gesetzt, dass die ersten 3 Tage werbefrei sind, sequenceLength 1, excludeSelf true.

Interaktion mit der Simulation:

• ad_started → Simulation pausiert (keine Zyklen, Zeitraffer aus), Musik duck(true), Spiel speichert vorher.
• ad_finished → alles läuft weiter. Die Zeit während der Anzeige zählt nicht als Offline-Zeit.
• Eine Anzeige wird nie gezeigt, während der Spieler pinselt, eine Evolutionskarte offen ist oder ein Ereignis entschieden werden muss (canShow-Rückfrage).

Fehler & offline:

• Remote-Konfiguration nicht ladbar → letzte gespeicherte gilt, sonst lockedConfig.
• Medium fehlt/ladefehler → Platzhalter-Kachel (wie im Kern vorgesehen); bei belohnter Anzeige zählt die Platzhalter-Kachel als vollständig (Spieler darf nicht bestraft werden).
• Jede Ausnahme im Adapter wird abgefangen, protokolliert und schaltet für die Sitzung auf NullAdAdapter.

14.5 Consent, Datenschutz, Store-Richtlinien

• Keine Werbe-ID, kein Tracking: Das Werbemodul nutzt keine Geräte-IDs. com.google.android.gms.permission.AD_ID bleibt blockiert (wie in Bridge Royale).
• Messung joculus_ad_impression nur, wenn die Analytics-Einwilligung erteilt ist (Studio-Muster: Opt-in-Bildschirm, Tiefsee analytics.gd).
• Kein ATT-Dialog auf iOS nötig, solange nicht getrackt wird.
• Play-Formular: „Enthält Werbung: Ja“ (Eigenwerbung zählt als Werbung). Data-Safety: Analytics-Daten wie bisher bei Bridge Royale (Nutzungsdaten, App-Instanz-ID), nur mit Einwilligung.
• Familienrichtlinie: Pocket Planet ist nicht für Kinder unter 13 als Zielgruppe ausgewiesen [Annahme] – sonst gelten strengere Werbe- und Datenregeln. Entscheidung F7 in 17.

14.6 Was wir vom SDK-Verantwortlichen brauchen (präzise)

Bis S1–S3 geklärt sind, wird ausschließlich gegen die Schnittstelle in 14.3 und den NullAdAdapter entwickelt.