` + `` + `

` SVG + `

` SVG. - [ ] **Use site-NATIVE classes** (не copy 8148 `vdo-blk-lmtr`/`vdo-blk-vdo`). Map до існуючих сайту: 8161 → `vi-limiter`/`vi-player`. Foreign classes створюють **footprint** і CSS дублі. - [ ] **Inline styles target NATIVE classes** теж (``). Без дзеркал sed. - [ ] **Timeline click handler:** `` (НЕ legacy `player.setTime`). - [ ] **Poster touch handler script:** localStorage `_pw` mark на `touchstart`/`mousedown` для tabunder pre-detect. ### CSS site-side (адаптивні правки) - [ ] **Tooltip overlap:** `.{position:relative;z-index:5001}` — підняти actions row над `.asg-container{z-index:5000}`. Plus `.{z-index:10000}` як defense. - [ ] **Timeline thumb hover-play:** `. .. a:hover .:after{display:block}` + mobile `@media(max-width:768px){. ... :after{transform:translate(-50%,-50%) scale(.6)}}`. - [ ] **Title wrap (`.heading-2` truncation):** `. .{white-space:normal;overflow-wrap:anywhere;...}` — override будь-який single-line ellipsis. - [ ] **`.` mobile scaling** — adapt 8148 patterns до native classes site-у. ### Verification - [ ] **`ad-test ""`** → 6/6 PASS. - [ ] **Empirical Playwright probe:** capture `pageerror` array — має бути empty. Перевірити specifically `c is not defined`, `lazyLoadFunc is not defined`, `c2.min.js Unexpected identifier 'o'`. - [ ] **Validate `c2.min.js` syntax:** `node --check views/static/js/c2.min.js` — passing. Якщо source `c2.js` edited без re-minify → broken `let` declarations у comma-sequence; fix: `terser views/static/js/c2.js -c -m -o views/static/js/c2.min.js`. - [ ] **Banner DOM uniqueness:** `await page.evaluate(() => Array.from(document.querySelectorAll('iframe[src*="api/spots"]')))` collect → no duplicate parent IDs (`#thmb1` 2× = bug). - [ ] **VAST endpoint probe:** `curl 'https://a5.g--o.info/api/users/?v2=1&fill=0&url='` returns `` (не empty `` — no-fill). - [ ] **Popunder endpoint probe:** `curl 'https://a5.g--o.info/api/users/?host=&...'` returns `window.__NA.renderSpot({...})`. - [ ] **t1 CDN serves fresh bundle:** `curl -sL "https://t1./static/js/ad-bundle.min.js" | grep -oE 'spot:"[0-9]+"'` — bundle reflects новий config. - [ ] **Real-browser smoke:** click play → VAST shows (after popunder cooldown set), click like → tooltip opens above player chrome, hover related thumb → play icon, hover timeline scene → smaller play icon (mobile) / regular (desktop). ### Post-deploy - [ ] **Monitor adspyglass dashboard** після prod deploy — graph має продовжувати ріст; падіння = регресія. - [ ] **Update site row у [SITES.md](SITES.md)** з generation tag (`v3 PlayerJS`). - [ ] **Update memory `project_player_roadmap.md`** — додати site до v3 list. ## ASG SDK filename patterns (anti-footprint) `a5.g--o.info/.js` server tolerates **будь-який filename matching pattern per type** — content однаковий. Use unique per site щоб diluteти footprint (adblock fingerprints). **Patterns** (verified 2026-05-05, refined post-bug): - **POPUNDER**: 7 chars total, `^[A-Za-z0-9]{6}[13579]$` — last char must be **ODD DIGIT** only. Even digits return DIFFERENT SDK content (different ad type, will break renderSpot). - **VAST**: 7 chars total, `^[A-Za-z0-9]{6}[abcdABCD]$` — last char must be **a-d** (8 chars). e-h returns different VAST sub-type (incompatible). - **Verify content size** post-generation: popunder=250844b, vast=323450b. Different size → wrong SDK fetched. - **BANNER `tb_config.banner_source`**: локальний файл у `views/static/js/.js` per site, не ASG endpoint — окремий footprint layer (rename файла + update reference) **Workflow:** generate per-site filenames → verify via `curl -sI` → apply mass-replace у `ad-config.js` (popunder.sdk, vast.sdk) → rebuild bundle → update `?v=` cache-bust у layout. Detail: memory `reference_ad_filename_patterns` (15-site mapping applied 2026-05-05). ## Monitoring ### adspyglass dashboard — best diagnostic signal `https://app.adspyglass.com/dashboard` **Чому це best signal:** - Live графік показу реклами per site - **Падіння графіка** = реклама не показується = ймовірно поломка (frontend/template/JS error / banned mirror / CDN cache stale) - **Ріст** = трафік підріс або UX покращився Юзер каже: "більший показник саме для мене це лайв графік реклами від АСГ" — реклама падає миттєво коли щось не так, ще до того як прийдуть алерти. ### Інші alerts - **Telegram + email** — критичні (downtime, errors) - Billing dashboard `https://billing.g--o.info/cs/oursites/dashboard/` — статистика (зазвичай не дивимось) ### Template patterns **Pattern A (8148 modern):** ```etlua ... <% render("views.modules.banners.header_mobile_adspy") %> <% render("views.modules.banners.footer_mobile_adspy") %> <% render("views.modules.banners.footer_descktop_adspy") %> ``` **Pattern C (8112 legacy inline):** ```etlua ... ... tb.load_frame_baner_v2("//surstrom.com/api/spots/72437?p=1","#tb0",{...},{...}); ``` ## Що треба з'ясувати + задокументувати ### Architecture migration - [ ] Чи планується мігрувати pattern C → B/A (legacy → modern)? - [ ] 8148 — pilot для bundle-architecture, чи поширюватиметься? ### CSP / Security - [ ] CSP exceptions для зеркал — як підтримуються? - [ ] Mirror swap — чи треба update CSP при заміні? ### Performance impact - [ ] PSI вплив реклами — % LCP / TBT (per pattern)? - [ ] Lazy-load ads below-fold — реалізовано (видно `loading="lazy"` на iframes)? ## VAST flow (8148 detailed) ### User experience 1. Користувач клацає play на `pjs_play_btn` (PlayerJS player) 2. `asgInVideoImpression` event від ASG SDK → `_decideAndApply` ловить → запускає `VastPreroll.show()` 3. ASG іnject-ить `.asg-container` з video preroll 4. `MutationObserver` ловить container → pin pointer + z-index 5000, добавляє progress bar (`.vast-progress` yellow #ffd000) 5. Coordinated mute: video у container синхронізується з `_vastMuted` localStorage (per-tab persist) 6. Після VAST done (video.ended OR `currentTime >= duration - 0.2`) → callback `window._asgAdDone()` → main video starts via `window._revealPjs()` 7. `enableMediaPlayHijack: true` блокує race у HTMLMediaElement.play() якщо `_adsLocked` — попереджає 1-frame audio artifact коли VAST стартує над main video ### Cooldown management - ASG локальне сховище: `localStorage.asgsl` — pipe-separated `=:` записи. Ключі що використовуються нашим bundle: - `global_rr:` — `_readCooldowns` parse-ить це як cooldown end time - `n:` — impression handler копіює це у `_popRr` / `_vastRr` cookies+LS - Дублюючі cookies: `_popRr`, `_vastRr`. Реплікуються з asgsl при impression event. - Декрипт пам'яті: дві ключові події з ASG — `asgPopunderImpression`, `asgInVideoImpression` — тригерять запис cooldown. ### ⚠️ ASG spot config gotcha — frequency-capping mandatory **Bug 2026-05-02 (8148, after account recreation):** popunder spot 514208 у новому ASG account-і був налаштований з `shows_limit:1` без frequency-capping rotation. Симптоми: - popunder СПрацьовує (видно `asgPopunderImpression`) - Але `asgsl` локально вигляд: `=keep_looping:false,tabunder:false,uuid:...,noloop:true,shows_limit:1` - **Нема `n:`** → impression handler виходить без write `_popRr` - **Нема `global_rr:`** → `_readCooldowns` повертає `popActive=false` - → mode завжди "pop" → popunder fires кожен pageload → VAST SDK ніколи не loadиться **Fix у ASG admin** (на стороні юзера, не у нас): - Відкрити spot config → знайти "Global rotation" / "Frequency capping" / "Cooldown" / "Time-based capping" / "Show frequency" - Встановити, наприклад, "once per 2 hours per user" — це додасть `n:` / `global_rr:` поля в asgsl - **Те саме для VAST spot** — інакше після популярного pop firing, VAST mode triggered але cooldown поломаний **Як перевірити:** після popunder fire відкрий DevTools → `localStorage.getItem('asgsl')` → шукай `global_rr:` або `n:`. Якщо нема → не налаштовано. ### ⚠️ ASG no-fill diagnostic — VAST returns empty `` **Bug 2026-05-02 (8148, VAST never visible):** Mode перемикався у "vast", VAST SDK loaded, але реклама не з'являлась візуально. Перевірка endpoint напряму: ```bash curl 'https://a5.g--o.info/api/users/?v2=1&fill=0&url=' ``` Якщо response: ```xml ``` — це **VAST no-fill**. ASG не має inventory для цього spot. **Порівняй з popunder endpoint** який повертає повний JSON-like config з `creative_id`, `behavior`, тощо: ```js window.__NA.renderSpot({ spot_id: ..., creative_id: 83660, config: {...} }); ``` **Можливі причини no-fill (по пріоритету):** 1. Spot **type ≠ "In-video VAST"** — створено як Banner/Popunder/etc → VAST endpoint не має чого serve 2. Spot **Status pending review** — створено, чекає approval 3. **Creative не attached** — VAST потребує специфічний ад чи bidder pool 4. **Bidder / network не linked** — VAST джерело мережі (ExoClick VAST / TS / etc) не призначено 5. Budget / cap exhausted **Як остаточно verify:** через playwright headless + manual inject `_popRr` форсити VAST mode → click play → дивитися чи з'являється `.asg-container`. Якщо ні + curl показує empty VAST → no-fill. ### Mode decision (`AdCore._decide`) ``` mode = popActive ? (vastActive || skipPattern ? "none" : "vast") : "pop" ``` | popunder | vast | mode | |----------|------|------| | available (cooldown OFF) | — | **pop** (priority) | | у cooldown (recent fire) | available + не skip-pattern | **vast** | | у cooldown | у cooldown OR skip-pattern | none | **Implicit dependency:** VAST показується **тільки після того як popunder уже спрацював** і поставив cooldown. На свіжій сесії (нема `_popRr` у localStorage / cookies) → mode завжди "pop", VAST SDK навіть не завантажується. ⚠️ Це **gotcha при тестуванні**: якщо щойно фікснули popunder spot — VAST не з'явиться поки popunder не спрацює хоча б раз. Юзер має думати що "VAST зламаний", а він просто заблокований mode logic. **Force VAST testing**: `?clearAds=1` URL param очищає `_popRr/_vastRr/_vastPatternIdx/_pw/asgsl/_pjsLog` — фрешний state. Тоді: page load → pop fires → cooldown set → refresh → mode=vast → VAST SDK loaded. `vastPolicy "show-1-skip-1"` додатково: idx=0 → SHOW, idx=1 → SKIP (incremented per VAST impression). На свіжій сесії idx=0 → перша VAST показується, друга skip-неться. ### Policy choice `pop-priority` policy + `show-1-skip-1` для VAST — **навмисний баланс ревеню vs UX**: - Popunder показується відносно рідко (cap від ASG високий) - VAST спрацьовує часто, тому штучно скачуємо до 50% (`show-1-skip-1`) — менше тиску на юзера, не вбиває engagement - Якщо колись треба максимізувати ревеню → `vastPolicy: 'show-always'` ## Open questions for developer 1. Як здійснюється mirror swap — sed-replace у всіх template/JS файлах через Адміна, runtime config, чи інший механізм? 2. Які pattern використовується для НЕ-77 сайтів (17 без adspy banner modules) — special-case structure, "no ads" сайти, чи щось інше? 3. SDK URLs (`nDNVal3.js`, `9iO21Eb.js`) — чи стабільні чи можуть змінитися при mirror rotation?