Handbuch

Advertiser Product Roadmap

Dieses Manifest beschreibt, wie Advertiser von einfachen POIs zu marktreifen, visuell starken und AI-nutzbaren Experience Partnern im Viaora-System werden.

AdvertiserAI ConciergeMarket Ready

Produktziel

Advertiser sollen als verkaufbare Experience Partner funktionieren: sichtbar im Guest UI, kuratiert durch das Hotel, nutzbar durch den AI Concierge und messbar fuer Sales.

Aktueller Stand

Core Advertiser

Stammdaten, Status, Kategorie, Kontakt, Adresse, Koordinaten und Builder Experience leben am Advertiser Record.

Hotel-Bindung

Die echte Bindung an ein Hotel passiert ueber Memberships/Listings mit Package, Placement Areas, Priority und Status.

Hotel Builder

Recommendations und Journey-Stops kuratieren, wo ein Partner im Guest-Kontext auftaucht. Sie ersetzen keine Membership.

Advertiser Builder

Der Builder pflegt Profiltext, Medien, Kontakt, CTA, Location und einfache Brand-Felder. Publish speichert die aktuelle Advertiser-Experience.

Guest Runtime

Die Guest API merged aktive Memberships, Hotel Recommendations und die published Advertiser Experience.

AI Concierge

Der Concierge nutzt aktuell published Guest Discovery und indexiert vor allem Map Listings als Advertiser-Quellen.

Guest UI

Die aktuelle Map Card wirkt noch funktional statt verkaufsfaehig. Auf Mobile koennen Bottom Sheet, Safe Area und Navigation Inhalte sichtbar abschneiden.

Produktprinzipien

  • Advertiser sind keine einfachen POIs, sondern verkaufbare Experience Partner im Hotelkontext.
  • Jeder sichtbare Partner braucht eine eindeutige Source of Truth, eine aktive Hotel-Bindung und einen publizierten Guest-Zustand.
  • Der AI Concierge darf nur aus published, hotelgebundenen und nachvollziehbar kuratierten Quellen empfehlen.
  • Visuelle Praesenz, Concierge-Nutzbarkeit und Sales-Paket muessen im selben Datenmodell zusammenlaufen.
  • Advertiser-UI folgt der Next-Gen-Builder-Regel: keine Parallelwelten zwischen Builder Preview, Guest PWA und canonical Renderern.
  • Jede Advertiser Card muss auf einem echten iPhone-Viewport ohne abgeschnittene Inhalte, ohne verdeckte CTAs und mit sauberer Scroll-Mechanik bestehen.
  • Commercial Placement muss transparent bleiben: curated, featured und sponsored duerfen visuell hochwertig sein, aber nicht versteckt werden.

Abgleich mit Next-Gen Builder Roadmap

Die Lago Garden Next-Gen Builder Roadmap bleibt der uebergeordnete Builder-Qualitaetstrack. Fuer Advertiser uebernehmen wir die relevanten Regeln direkt, ohne den kompletten Hotel-Builder-Scope hier zu duplizieren.

Direkt in Scope

Builder/Guest-Paritaet, HUD-first Pflege, keine Hotel-Hardcodings, Lesbarkeit, Browser-QA und die Trennung von Discover, Journey und Advertiser-Detail gelten sofort fuer jeden Advertiser-Slice.

Bewusst nicht doppeln

Die Lago Garden Roadmap bleibt der Next-Gen-Builder-Track. Diese Roadmap uebernimmt nur die Advertiser-relevanten Gates und baut keine zweite Surface- oder Block-Welt.

Canonical Renderer

Neue Advertiser-Visuals muessen ueber bestehende Guest-/Design-System-Pfade laufen. Builder Preview und Guest PWA duerfen nicht auseinanderdriften.

HUD und Import

Alles, was Partner, Hotel oder OPS spaeter pflegen sollen, braucht eine Builder-/HUD-Lane oder eine saubere JSON-Import-/Export-Lane.

QA Pflicht

Mobile Safari, Android Chrome, Builder Preview und Guest PWA werden fuer Map Card, Detail Sheet, Recommendation Card und Concierge Actions als Release-Gate behandelt.

Visueller Befund

Bottom Sheet

Die Map Card braucht definierte Detents, echte Scroll-Container, Safe-Area-Abstand und eine Hoehenlogik, die Bottom Navigation und Browser-Chrome beruecksichtigt.

Content Hierarchy

Name, Kategorie, Adresse, Status, Entfernung und Haupt-CTA muessen priorisiert werden. Sekundaeraktionen duerfen die Card nicht dominieren.

Commercial Quality

Cover-Bild, Logo/Badge, kuratierter Hotel-Kontext, Fit-Chips und Trust-Signale muessen direkt sichtbar machen, warum dieser Partner empfohlen wird.

Interaction States

Collapsed, mid und expanded States brauchen eigene Layout-Regeln. Mehr/Weniger darf keine Sackgasse sein und muss langen Content robust aufnehmen.

Visual QA

Jede Iteration braucht Mobile-Screenshots fuer iPhone-Viewport, kleine Android-Viewport, Desktop und PWA/In-App-Browser inklusive Scroll- und Safe-Area-Pruefung.

Zielmodell

Identity

Name, Claim, Kategorie, Subkategorie, Logo, Cover, Gallery, Kurztext und Langtext.

Guest Fit

Best for, mood, occasion, audience, family friendly, couples, rainy day, night, quick visit und premium fit.

Operational Facts

Strukturierte Oeffnungszeiten, Reservierung, Walk-in, Sprachen, Preisniveau, Dresscode, Dauer, Saison, Accessibility und Payment.

Location Intelligence

Koordinaten, Adresse, Distanz, Gehzeit, Fahrzeit, Transfer-Hinweise, Area und Map-Sichtbarkeit.

Concierge Intelligence

AI Summary, Suchphrasen, Entscheidungshinweise, empfohlene Prompts, when to recommend und when not to recommend.

Conversion

CTA Label, CTA URL, Booking URL, Telefon, WhatsApp, E-Mail, bevorzugte Aktion und Tracking-Kontext.

Trust & Quality

Hotel-curated Badge, verified status, last reviewed, media completeness und data quality score.

Commercial Placement

Presence, Featured, Signature, Exclusive, Placement Intent, Placement Areas, Priority und Reporting.

Roadmap

Phase 1: Contract und Truth bereinigen

AdvertiserCanonicalContent wird zur einzigen published Wahrheit. Builder Publish, Core Persistence, Guest Serializer und Contracts muessen dieselbe Shape sprechen.

Keine flache Draft-Shape als published RuntimeMigration fuer bestehende Advertiser ExperienceTests fuer Guest Overlay und Builder Publish

Phase 2: Enrichment-Modell einfuehren

Guest Fit, Operations, Location Intelligence, Conversion, Trust und Concierge Intelligence werden als strukturierte Advertiser-Felder eingefuehrt.

Admin- und Builder-Felder definiertCompleteness Score sichtbarImport-Regeln fuer neue Partner aktualisiert

Phase 3: AI Concierge auf Partner-Qualitaet heben

Der Concierge indexiert Advertiser nicht mehr als einen flachen Chunk, sondern als strukturierte Quellen fuer Profil, Fit, Operations, Location, Conversion und Decision Hints.

Map Listings und Non-Map Listings werden indexiertAdvertiser Actions bleiben allowlistedRoute Actions nur bei gueltigen Koordinaten

Phase 4: Guest UI marktreif machen

Map Card, Recommendation Card, Detail Sheet und Journey Stop werden als verkaufsfaehige Experience-Flächen neu bewertet: bildstark, sauber scrollbar, mobile-safe und klar auf Conversion ausgerichtet.

Builder Preview und Guest PWA bleiben renderer-konformBottom Sheet scrollt ohne abgeschnittene InhalteSafe Area und Bottom Navigation verdecken keine CTAsMobile Map Card wirkt wie ein kuratiertes PartnerproduktDetailseite nutzt published Advertiser TruthJourney erklaert Anlass, Dauer und KontextVisual QA mit echten iPhone- und Android-Viewports

Phase 5: Sales-Produkt und Reporting

Presence, Featured, Signature und Exclusive werden als verkaufbare Pakete mit sichtbarer Leistung, Reporting und Readiness Gates operationalisiert.

Package-Matrix dokumentiertImpressions, Opens, Route Starts, CTA Clicks und Concierge Mentions messbarPartner Readiness fuer Sales sichtbar

Visuelle Zielqualitaet

  • Map Cards zeigen Cover, Logo/Badge, Kategorie, Entfernung, Oeffnungsstatus, Fit-Chips und klare Actions.
  • Recommendation Cards fuehlen sich wie kuratierte Erlebnisse an, nicht wie generische Anzeigen.
  • Detailseiten erklaeren, warum das Hotel den Partner empfiehlt und fuer wen er passt.
  • Journey-Stops bekommen Anlass, Zeitfenster, Dauer, Stimmung und konkrete naechste Aktion.
  • Bottom Sheets haben robuste Scroll-Mechanik, responsive Detents und halten CTAs oberhalb der Safe Area.
  • Lange Adressen, lange Partnernamen und mehrere Actions duerfen auf kleinen Viewports kein Layout sprengen.

AI Concierge Zielqualitaet

  • Advertiser ohne Koordinaten duerfen Concierge-Wissen liefern, bekommen aber keine Map- oder Route-Action.
  • Jeder Advertiser erzeugt mehrere Source-Chunks statt eines langen Mischtexts.
  • AI Summary und Decision Hints werden explizit gepflegt oder kontrolliert generiert.
  • Ranking darf Commercial Priority beachten, muss aber published, aktiv und hotelgebunden bleiben.

Nicht verhandelbar

Hotel Recommendations sind Praesentation. Memberships/Listings sind Bindung. Advertiser Builder Published Content ist Partner-Wahrheit. Der Concierge darf diese Grenzen nutzen, aber nicht verwischen.