Client-Side Ad Insertion (CSAI) na may pag-parse ng SCTE-35 Marker at Integrasyon ng Multi-Platform Player

Bumuo kami ng isang cross-platform CSAI framework na may pinag-isang ad orchestration layer na nagpa-parse ng mga SCTE-35 marker mula sa HLS/DASH manifests, nakikipag-ugnayan sa VAST/VMAP ad servers, at namamahala sa ad playback lifecycle sa buong web (Video.js/Shaka), iOS (AVPlayer), Android (ExoPlayer), at mga connected TV player.

Arkitektura

• Paghahatid ng Nilalaman: Mga HLS/DASH stream na may SCTE-35 marker sa pamamagitan ng AWS MediaPackage + CloudFront
• Ad Decision Server: Google Ad Manager (GAM) / SpotX na may suporta sa VAST 4.2 at VMAP
• Web Player: Video.js na may custom SCTE-35 cue parser at integrasyon ng Google IMA SDK
• iOS Player: AVPlayer na may AVDateRangeMetadataGroup listener at IMA iOS SDK
• Android Player: ExoPlayer na may MetadataOutput listener at IMA Android SDK
• Connected TV: Mga platform-native player (Roku RAF, Fire TV IMA, Apple TV AVKit) na may ad framework adapters
• Ad Analytics: Custom event pipeline para sa pagsubaybay ng impression, quartile, completion, click, at viewability
• Fallback: Paghahatid ng Slate/house-ad kapag hindi available ang ad fill o may natukoy na ad blocker

SCTE-35 Client-Side Parsing

HLS Manifest Markers

Lumilitaw ang mga signal ng SCTE-35 sa HLS manifests sa dalawang format, parehong pinapa-parse ng client:

EXT-X-DATERANGE (HLS v7+)

• Nakikinig ang Player para sa mga #EXT-X-DATERANGE tag na may SCTE35-OUT at SCTE35-IN attributes
• Kasama sa mga attribute ang PLANNED-DURATION para sa haba ng ad break at ID para sa event correlation
• Mas gustong format para sa mga modernong player (AVPlayer, ExoPlayer, Shaka)

EXT-X-CUE-OUT / EXT-X-CUE-IN (Legacy)

• Ang #EXT-X-CUE-OUT:DURATION= ay nagmamarka ng simula ng ad break
• Ang #EXT-X-CUE-IN ay nagmamarka ng pagbalik sa nilalaman
• Sinusuportahan para sa backward compatibility sa mga mas lumang player at encoder

DASH Manifest Markers

• Ang mga signal ng SCTE-35 ay lumilitaw bilang mga element sa DASH MPD na may schemeIdUri="urn:scte:scte35:2013:xml"
• Ang mga element ay naglalaman ng presentationTime, duration, at base64-encoded SCTE-35 binary payload
• Pinapa-parse ito ng Shaka Player at ExoPlayer nang natively sa pamamagitan ng kanilang event listener APIs

Daloy ng Pagproseso ng Marker

1. Pagtukoy — Nakikita ng Player metadata listener ang SCTE-35 cue event habang nagpa-parse ng manifest
2. Pagkuha — Kinukuha mula sa marker ang break duration, event ID, at segmentation type
3. Kahilingan sa Ad — Nagpa-fire ang VAST/VMAP request sa ad decision server na may targeting parameters (content ID, genre, device type, user segment, geo)
4. Pagpaplano ng Pod — Pinapa-parse ang ad response upang bumuo ng ad pod (nakaayos na listahan ng mga ad creative na pumupuno sa break duration)
5. Preload — Ang mga ad creative ay preloaded habang nagpe-playback ng nilalaman upang maalis ang latency sa simula ng ad break
6. Pause at Switch — Nag-pause ang content playback sa cue point, lumilipat ang player sa ad playback
7. Pag-playback ng Ad — Sunud-sunod na pine-play ang mga ad na may quartile tracking, companion banner display, at click-through handling
8. Pagpatuloy — Pagkatapos ng pagkumpleto ng pod, nagpapatuloy ang content playback mula sa eksaktong frame pagkatapos ng cue point

Mga Implementasyon na Partikular sa Platform

Web (Video.js + IMA SDK)

• Ang custom Video.js plugin ay nag-intercept ng #EXT-X-DATERANGE metadata sa pamamagitan ng textTrack cue change events
• Ang Google IMA HTML5 SDK ay namamahala sa mga kahilingan ng VAST ad, ad playback, at companion rendering
• Ang ad container overlay ay nakaposisyon sa itaas ng video element para sa click-through at suporta sa skip button
• Ad blocker detection sa pamamagitan ng canary request — nagpa-fallback sa house ads o content-resumption kapag natukoy
• Suporta sa Preroll, midroll, at postroll sa pamamagitan ng VMAP o manual cue-point scheduling

iOS (AVPlayer + IMA SDK)

• Ang AVPlayerItem.navigationMarkerGroups at AVDateRangeMetadataGroup ay ginagamit upang matukoy ang mga SCTE-35 cue
• Nagpa-fire ang AVPlayerItemMetadataOutput delegate sa bawat cue event na may parsed timing at payload
• Hinahawakan ng Google IMA iOS SDK ang VAST request at ad playback sa isang hiwalay na AVPlayer instance
• Ang Picture-in-Picture (PiP) ay naka-pause sa panahon ng ad breaks alinsunod sa ad policy ng platform
• Hinahawakan ang background audio — hindi nagpe-play ang mga ad sa background mode

Android (ExoPlayer + IMA SDK)

• Ang Player.Listener.onMetadata() na may MetadataOutput ay kumukuha ng mga SCTE-35 event mula sa HLS/DASH
• Ang Google IMA Android SDK ay isinama sa pamamagitan ng ImaAdsLoader extension ng ExoPlayer
• Ang ad playback ay gumagamit ng hiwalay na MediaSource upang maiwasan ang pagdumi sa content buffer
• Hinahawakan ang Activity lifecycle — pinapanatili ang ad state sa mga pagbabago ng configuration at backgrounding
• Ang Android TV at mobile ay may parehong ad logic na may UI-layer adaptations

Mga Connected TV Platform

Roku (RAF — Roku Ad Framework)

• Ang native RAF library ng Roku ay direktang nagpa-parse ng SCTE-35 markers mula sa HLS manifests
• Ang RAF.setAdUrl() ay naka-configure sa VAST endpoint; hinahawakan ng RAF ang kahilingan ng ad, pagbuo ng pod, at playback
• Suporta sa companion ad sa pamamagitan ng renderStitchedAd at renderTrackingEvent callbacks ng RAF
• Ang Roku certification ay nangangailangan ng paggamit ng RAF — ang mga custom ad player ay tinatanggihan sa panahon ng pagsusuri

Fire TV (IMA SDK)

• Gumagamit ng Android ExoPlayer + IMA SDK implementation na inangkop para sa Leanback UI ng Fire TV
• D-pad navigation para sa skip button at "Learn More" click-through sa ad overlays
• Ginagamit ang Fire TV Ad ID para sa ad targeting sa mga VAST request

Apple TV (AVKit + Custom)

• AVPlayerViewController na may interstitialTimeRanges para sa native ad break UI indicators
• Ang mga SCTE-35 cue ay pinapa-parse sa pamamagitan ng AVPlayerItemMetadataCollector
• Ang ad playback ay pinamamahalaan sa isang hiwalay na AVQueuePlayer para sa malinis na paghihiwalay ng content/ad
• tvOS remote click handler para sa mga interactive ad element

Pamamahala ng Ad Pod

• Pagpuno ng Pod — Maraming VAST ad ang pinagsasama-sama upang punan ang sinenyales na break duration
• Waterfall — Kung ang primary ad server ay nagbalik ng no-fill, ang secondary/tertiary demand sources ay kinukuwestiyon nang sunud-sunod
• Pagkasyang Tagal — Pinipili ng pod builder ang mga kombinasyon ng ad na akma sa loob ng break duration (±0.5s tolerance)
• Deduplication — Ang parehong ad creative ay hindi ipinapakita nang dalawang beses sa isang pod
• Frequency Capping — Ang per-user, per-session caps ay ipinatutupad client-side upang maiwasan ang ad fatigue
• Bumpering — Ang maikling bumper creatives ("We'll be right back" / "Welcome back") ay bumabalot sa mga ad pod

Pagsubaybay ng Ad Event at Analytics

• Standard VAST Events — impression, start, firstQuartile, midpoint, thirdQuartile, complete, skip, clickThrough
• Viewability — Ang MOAT/IAS viewability pixels ay nagpa-fire batay sa visibility ng ad viewport at duration thresholds
• Custom Events — Mga app-level event (simula/katapusan ng ad break, pod fill rate, preload timing, fallback triggered)
• Server Pipeline — Ang client ay nagpa-fire ng mga event sa isang lightweight event collector, na nagpapadala sa GAM, MOAT, at sa internal analytics warehouse
• Rekonsilyasyon — Server-side log reconciliation sa mga client-side event para sa discrepancy detection

Paghawak ng Ad Blocker (Web)

• Pagtukoy — Canary VAST request sa isang kilalang ad domain; ang timeout o block ay nagpapahiwatig ng ad blocker
• Fallback Strategy — Maghain ng house ads o promotional trailer mula sa first-party CDN domain
• Content Gating — Opsyonal na soft gate: I-prompt ang user na i-whitelist ang site bago mag-play ang nilalaman
• Analytics — Ang rate ng pagtukoy ng ad blocker ay sinusubaybayan kada browser, heograpiya, at pahina

Mga Pangunahing Tampok

1. Cross-Platform CSAI — Pinag-isang pag-insert ng ad sa web, iOS, Android, Roku, Fire TV, at Apple TV
2. SCTE-35 Client Parsing — HLS EXT-X-DATERANGE, CUE-OUT/IN, at DASH EventStream parsing
3. Mga Interactive na Ad — Mga clickable overlay, companion banner, at skip button sa lahat ng platform
4. Ad Pod Orchestration — Pagpuno ng multi-ad break na may waterfall, duration fitting, at deduplication
5. Preloading — Ang mga ad creative ay preloaded habang nagpe-playback ng nilalaman para sa zero-latency ad transitions
6. Viewability Tracking — Integrasyon ng MOAT/IAS para sa mga kinakailangan sa viewability ng premium ad buyer
7. Connected TV Compliance — Integrasyon ng Roku RAF, Fire TV IMA, at Apple TV AVKit na sumusunod sa mga kinakailangan sa sertipikasyon
8. Ad Blocker Resilience — Pagtukoy at fallback sa first-party house ads sa web