CTV Integratsiya Qo'llanmasi | OMNIBOX Developer Docs

1 Umumiy ma'lumot & Strategiya

Connected TV muhitlari turlicha bo'lishiga qaramay, bizning yechimimiz barchasi uchun yagona standartni taqdim etadi.

Universal Yechim: t=app

Barcha CTV platformalarida t=app parametridan foydalanishni qat'iy tavsiya qilamiz. Bu VPAID JS o'rniga toza MP4 (VAST Wrapper) qaytaradi va native pleyerlarda muammosiz ishlaydi.

CTV So'rov Parametrlari

Parametr	Misol	Tavsif
`plc`	`tv_preroll`	Placement ID
`w`	`1920`	TV Kengligi
`h`	`1080`	TV Balandligi
`t`	`app`	MAJBURIY (MP4 rejim)
`cb`	`123...`	Cache Buster

2 Samsung Tizen & LG WebOS

Tavsiya Video.js + IMA SDK

Eslatma vpaidMode: DISABLED qiling

JavaScript

var player = videojs('tv_player');

var options = {
    id: 'tv_player',
    // t=app parametriga e'tibor bering
    adTagUrl: "https://omnibox.digital/ads/direct?plc=tizen_preroll&w=1920&h=1080&t=app&cb=" + Date.now(),
    vpaidMode: google.ima.ImaSdkSettings.VpaidMode.DISABLED, // MUHIM
    showCountdown: true,
    showControlsForAds: false
};

player.ima(options);

3 Android TV

ExoPlayer + IMA Extension eng yaxshi tanlov.

Kotlin

// t=app parametrini qo'shishni unutmang, shunda VAST XML to'g'ri qaytadi
val adUrl = "https://omnibox.digital/ads/direct?plc=atm&w=1920&h=1080&t=app&cb=$timestamp"

val player = ExoPlayer.Builder(context)
    .setMediaSourceFactory(
        DefaultMediaSourceFactory(context)
            .setLocalAdInsertionComponents({ _ -> imaAdsLoader }, playerView)
    )
    .build()

4 Apple TV

Swift

let adTagUrl = "https://omnibox.digital/ads/direct?plc=tvos&w=1920&h=1080&t=app&cb=\(timestamp)"

let request = IMAAdsRequest(
    adTagUrl: adTagUrl, 
    adDisplayContainer: container, 
    contentPlayhead: nil, 
    userContext: nil
)
adsLoader.requestAds(with: request)

5 Maxsus Native Pleyerlar

Qo'lda integratsiya qilish bo'yicha qo'llanma

1. t=app so'rovini yuboring.
2. VAST XML'dagi VASTAdTagURI (Wrapper)larni recursion qiling.
3. Eng oxirgi <MediaFile type="video/mp4"> ni toping.
4. MP4 faylni native pleyerga bering.
5. Ijro davomida <Tracking> eventlarini chaqirib turing (start, firstQuartile, complete...).

6 CTV Bannerlar

WebOS/Tizen uchun oddiy iframe ishlatish mumkin. Android TV uchun WebView. Apple TV uchun serverdan JSON orqali rasm URL olib ko'rsatish tavsiya qilinadi.

HTML (Tizen/WebOS)

<iframe src="https://omnibox.digital/ads/direct?plc=home_banner&w=300&h=250" frameborder="0"></iframe>

CTV Integration