View a markdown version of this page

Client-side integrasi pelacakan iklan - AWS Elemental MediaTailor

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Client-side integrasi pelacakan iklan

Bagian ini menjelaskan integrasi antara MediaTailor dan berbagai server pelacakan iklan sisi klien.

Buka SDK Pengukuran

Interactive Advertising Bureau (IAB) Open Measurement SDK (OM SDK) memfasilitasi keterlihatan pihak ketiga dan pengukuran verifikasi untuk iklan yang ditayangkan ke lingkungan web-video dan aplikasi asli.

Untuk dokumen VAST versi 3 yang lebih lama, kode verifikasi harus dimuat dengan simpul Ekstensi, dengan jenis ekstensiAdVerifications. Akar node ekstensi adalah AdVerifications simpul dengan skema yang sama dengan elemen VAST 4.1.

Untuk memfasilitasi adopsi SDK OM yang lebih mudah, MediaTailor telah bermitra dengan Datazoom untuk menyediakan SDK pemain gratis yang dikonfigurasi dan diverifikasi untuk Pengukuran Terbuka. Untuk informasi selengkapnya, lihat Datazoom SDK pemain gratis.

catatan

MediaTailor saat ini mendukung VAST versi 3 saja.

contoh: Node verifikasi di VAST 3, sebelum Versi 4.1
... <Extensions> <Extension type="AdVerifications"> <AdVerifications> <Verification vendor="company.com-omid"> <JavaScriptResource apiFramework="omid" browserOptional="true"> <![CDATA[https://verification.com/omid_verification.js]]> </JavaScriptResource> <TrackingEvents> <Tracking event="verificationNotExecuted"> <![CDATA[https://verification.com/trackingurl]]> </Tracking> </TrackingEvents> <VerificationParameters> <![CDATA[verification params key/value pairs]]> </VerificationParameters> </Verification> </AdVerifications> </Extension> </Extensions>

MediaTailor mengekstrak AdVerifications data dari <Extensions> node dan menempatkannya ke dalam adVerifications array dalam respons pelacakan sisi klien.

contoh: Array AdVerifications dalam respons pelacakan sisi klien
{ "avails": [ { "adBreakTrackingEvents": [], "adMarkerDuration": null, "ads": [ { "adId": "3062770", "adParameters": "", "adProgramDateTime": "2023-08-23T16:25:40.914Z", "adSystem": "2.0", "adTitle": "AD-polarbear-15", "adVerifications": [ { "executableResource": [], "javaScriptResource": [ { "apiFramework": "omid", "browserOptional": "true", "uri": "https://verification.com/omid_verification.js" } ], "trackingEvents": [ { "event": "verificationNotExecuted", "uri": "https://verification.com/trackingurl" } ], "vendor": "company.com-omid", "verificationParameters": "verification params key value pairs" } ], "companionAds": [], "creativeId": "00006", "creativeSequence": "1", "duration": "PT14.982S", "durationInSeconds": 14.982, "extensions": [ { "content": "<AdVerifications>\n\t\t\t\t\t\t<Verification vendor=\"company.com-omid\">\n\t\t\t\t\t\t\t<JavaScriptResource apiFramework=\"omid\" browserOptional=\"true\"><![CDATA[https://verification.com/omid_verification.js;]]></JavaScriptResource>\n\t\t\t\t\t\t\t<TrackingEvents>\n\t\t\t\t\t\t\t\t<Tracking event=\"verificationNotExecuted\"><![CDATA[;https://verification.com/trackingurl;]]></Tracking>\n\t\t\t\t\t\t\t</TrackingEvents>\n\t\t\t\t\t\t\t<VerificationParameters><![CDATA[verification params key/value pairs;]]></VerificationParameters>\n\t\t\t\t\t\t</Verification>\n\t\t\t\t\t</AdVerifications>", "type": "AdVerifications" } ], "mediaFiles": { "mediaFilesList": [], "mezzanine": "" }, "skipOffset": null, "startTime": "PT10.11S", "startTimeInSeconds": 10.11, "trackingEvents": [ { "beaconUrls": [ "https://n8ljfs0h09.execute-api.us-west-2.amazonaws.com/v1/impression" ], "duration": "PT14.982S", "durationInSeconds": 14.982, "eventId": "3062770", "eventProgramDateTime": null, "eventType": "impression", "startTime": "PT10.11S", "startTimeInSeconds": 10.11 } ], "vastAdId": "" } ], "availId": "3062770", "availProgramDateTime": "2023-08-23T16:25:40.914Z", "duration": "PT14.982S", "durationInSeconds": 14.982, "meta": null, "nonLinearAdsList": [], "startTime": "PT10.11S", "startTimeInSeconds": 10.11 } ], "dashAvailabilityStartTime": null, "hlsAnchorMediaSequenceNumber": null, "nextToken": "UFQxMC4xMVNfMjAyMy0wOC0yM1QxNjoyNjoyNC4yNDYxMDIxOTBaXzE%3D", "nonLinearAvails": [] }
catatan

Terlibat dengan IAB Tech Lab untuk memastikan bahwa aplikasi disertifikasi setiap tahun untuk memastikan kepatuhan.

Untuk informasi selengkapnya tentang OM SDK, lihat Open Measurement SDK di situs web IAB Tech Lab.

Datazoom SDK pemain gratis

Untuk memfasilitasi adopsi SDK pemain yang lebih mudah, MediaTailor telah bermitra dengan Datazoom untuk menyediakan SDK pemain gratis yang dikonfigurasi dan diuji dengan dan IAB Tech. Client-side AWS Elemental MediaTailor integrasi dengan Google Ad Manager Buka SDK Pengukuran

SDK pemutar Datazoom mendukung fitur-fitur ini:

  • Daftar putar langsung dan VOD

  • Spesifikasi DASH dan HLS

  • Dukungan vendor pemain untuk Bitmovin, exoplayer, pemutar media Android, Apple AVPlayer, Brightcove, Penerima Chromecast,, hls.js, JWPlayer, pemutar Shaka, pemutar THEO Dash.js,, Roku, dan lainnya Video.js

  • Sertifikasi Pengukuran Terbuka Lab Teknologi IAB, jika tersedia di perangkat tertentu

  • Click-through penanganan acara

  • Ad-event dispatcher, seperti penghitung waktu penghitung mundur iklan, hamparan iklan, dan peristiwa non-linier, awal jeda iklan, akhir jeda iklan

  • Client-side iklan beaconing

  • SDK Google Programmatic Access Library (PAL), sebagai pengaturan konfigurasi opsional

Datazoom juga menawarkan layanan analitik dan telemetri berbayar yang didukung SDK pemain. Pelanggan dapat memilih dan mengontrol telemetri SDK pemutar dari konsol manajemen Datazoom. Untuk mengakses SDK pemutar Datazoom dan mempelajari selengkapnya tentang layanan telemetri dan analitik bernilai tambah, gunakan informasi kontak di situs Datazoom.

Kerangka Periklanan Roku (RAF)

Roku Ad Framework (RAF) mempertahankan pengalaman iklan yang konsisten di seluruh platform Roku. Semua saluran, termasuk iklan video, harus memenuhi persyaratan sertifikasi Roku untuk RAF. Khususnya, aplikasi harus selalu menggunakan penembakan peristiwa sisi klien melalui RAF. MediaTailor, sebagai penyedia penyisipan iklan sisi server (SSAI), mendukung pengaktifan peristiwa sisi klien. Adaptor SSAI RAFX menyediakan antarmuka ke server manifes SSAI, atau stitcher, dan RAF. Antarmuka ini meliputi:

  • Mengurai masterURL respons dan mengekstraksiplayURL,AdURL, dan metadata iklan.

  • Mengubah metadata iklan MediaTailor SSAI menjadi metadata RAF-usable iklan, dan mengonfigurasi RAF untuk pemutaran.

  • Mengamati peristiwa aliran dan metadata berjangka waktu.

  • Mencocokkan peristiwa streaming, metadata iklan, dan piksel peristiwa penembakan tepat waktu.

  • Pinging/polling ituAdURL, seperti yang dipersyaratkan oleh server manifes MediaTailor SSAI, kemudian mengurai dan mengonfigurasi ulang RAF.

Untuk informasi selengkapnya tentang adaptor SSAI untuk RAF, lihat Menerapkan Penyisipan Server-Side Iklan Menggunakan Adaptor Roku di situs web Roku.

TheoPlayer

TheoPlayer integrasi dengan MediaTailor melakukan hal berikut:

  • Menyediakan fungsionalitas untuk mendukung pelacakan MediaTailor peristiwa sisi klien untuk HLS dan DASH untuk VOD dan alur kerja langsung.

  • Mendukung pengiriman suar pelacakan hanya untuk iklan linier.

  • Menonaktifkan pencarian selama iklan. Namun, tidak ada logika untuk memutar iklan saat pengguna mencari melewati jeda iklan.

Untuk informasi selengkapnya tentang SSAI di TheoPlayer, dan untuk meninjau SDK web, Android, iOS, dan tvOS MediaTailor, lihat MediaTailordi situs web. TheoPlayer

MediaTailor SDK

AWS Elemental memelihara kit JavaScript-based pengembangan perangkat lunak (SDK). AWS Elemental menyediakan SDK apa adanya, tanpa garansi tersirat. Gunakan SDK sebagai demonstrasi referensi untuk merampingkan orientasi Anda untuk menggunakan. MediaTailor SDK menunjukkan cara berinteraksi dengan API pelacakan MediaTailor sisi klien. SDK menerapkan pelacakan dan pelaporan iklan sisi klien untuk pemain. HTML5-based SDK menginisialisasi sesi pelaporan MediaTailor sisi klien, lalu meminta informasi pelacakan iklan secara berkala. Selama pemutaran, SDK memancarkan peristiwa pelacakan iklan saat peristiwa iklan baru terdeteksi.

MediaTailor SDK mendukung fitur-fitur ini:

  • Daftar putar langsung dan VOD

  • Spesifikasi DASH dan HLS

  • Click-through penanganan acara

  • Ad-event dispatcher

  • Kait acara khusus

  • Client-side iklan beaconing. Untuk informasi selengkapnya tentang mengirim suar iklan, lihat. Client-side beaconing

catatan

Kirim tiket AWS Support untuk menerima contoh JavaScript SDK. MediaTailor Anda akan menerima tautan unduhan untuk paket dan file-filenya.