Cavai Docs

Appearance

Advantage Automation: Format-dropdown og auto-initialisering ​

Konsept ​

Fjerne behovet for manuell Script-operator ved Advantage-oppsett. Brukeren velger format i en dropdown, og plattformen håndterer initialisering, scroll progress og preview automatisk.

Fullstendig plan finnes i advantage-integration-complete-guide.md Del 2. Dette dokumentet oppsummerer hva som finnes, hva som mangler, og bekrefter feasibility.

Hva som finnes i dag ​

Creative-Engine ​

  • advantageService og advantageMessenger — full implementasjon med initialize(), onScrollProgress(), støtter 5 formater
  • entry.ts kaller advantageService.initialize(stubConf.creativeType) — men creativeType er 'banner'/'expandable', ikke et Advantage-format
  • ADVANTAGE og ADVANTAGE_FORMAT allerede eksponert i Script-operatorer
  • DataStore har ingen scrollProgress-felt
  • StubConf har ingen advantageFormat-felt
  • Advantage-versjon: @get-advantage/advantage ^0.11.0

Application-Frontend ​

  • Delivery store har enableAdvantage: number toggle — ingen advantageFormat
  • CreativeTagSettings har enableAdvantage: boolean — ingen advantageFormat
  • UI har checkbox for Enable Advantage — ingen format-dropdown
  • Preview: DoubleMidscrollSingleCreative scroll-preview allerede implementert

Hva som må implementeres ​

Creative-Engine ​

  • [ ] DataStore: legg til scrollProgress: ref(0)
  • [ ] StubConf type: legg til advantageFormat: string
  • [ ] stub.ts template: legg til placeholder ADVANTAGEFORMATPLACEHOLDER
  • [ ] entry.ts: bruk stubConf.advantageFormat i stedet for stubConf.creativeType, auto-registrer scroll progress callback

Application-Frontend ​

  • [ ] Delivery store: legg til advantageFormat: string felt
  • [ ] Delivery UI: format-dropdown (Topscroll, Midscroll, DoubleMidscrollSingleCreative) som vises når Enable Advantage er på
  • [ ] BuilderDelivery.vue: samme dropdown
  • [ ] CreativeTagSettings: legg til advantageFormat
  • [ ] buildTagSettings(): ekstraher advantageFormat fra delivery data
  • [ ] makeCreativeTag(): skriv advantageFormat til script tag data-attributt
  • [ ] Preview-logikk: aktiver scroll-preview kun for DoubleMidscrollSingleCreative basert på advantageFormat

Application-Backend ​

  • [ ] Legg til advantageFormat felt i creative delivery-modellen

Composer ​

  • [ ] Inkluder advantageFormat i build-profilen så den flyter til stubConf

Bakoverkompatibilitet ​

Script-operatorer med manuell ADVANTAGE.initialize() fungerer fortsatt — Script-kallet overskriver entry.ts-initialiseringen. Eksisterende creatives trenger ingen endring.

Kompleksitet ​

Lav-middels. Alle byggesteinene finnes. Hovedjobben er å wire opp advantageFormat gjennom hele stacken (AF → Backend → Composer → CE) og legge til dropdown i UI. Ingen ny arkitektur trengs.

Referanser ​

Internal documentation

Cavai