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

Open Measurement SDK (OM SDK) Interactive Advertising Bureau (IAB) memfasilitasi pengukuran tampilan dan verifikasi pihak ketiga 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 node dengan skema yang sama dengan elemen VAST 4.1.

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

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.

SDK pemain gratis Datazoom

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 Dash.js, pemutar Shaka, pemutar THEO,, Roku dan banyak lagi Video.js

  • Sertifikasi Pengukuran Terbuka IAB Tech Lab, jika tersedia pada perangkat tertentu

  • Click-through penanganan acara

  • Ad-event operator, seperti pengatur waktu hitung mundur iklan, overlay iklan dan peristiwa non-linier, awal jeda iklan, akhir jeda iklan

  • Client-side beacon iklan

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

Datazoom juga menawarkan layanan analitik dan telemetri berbayar yang didukung oleh SDK pemain. Pelanggan dapat memilih dan mengontrol telemetri SDK pemutar dari konsol manajemen Datazoom. Untuk mengakses SDK pemutar Datazoom dan untuk mempelajari lebih lanjut tentang layanan telemetri dan analitik bernilai tambah, gunakan informasi kontak di situs Datazoom. https://www.datazoom.io/partner-aws

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 peristiwa sisi klien yang diaktifkan melalui RAF. MediaTailor, sebagai penyedia penyisipan iklan sisi server (SSAI), mendukung pembakaran peristiwa sisi klien. Adaptor RAFX SSAI 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 pembakaran tepat waktu.

  • Pinging/polling AdURL, seperti yang dipersyaratkan oleh server manif MediaTailor es SSAI, kemudian mengurai dan mengkonfigurasi ulang RAF.

Untuk informasi lebih lanjut tentang adaptor SSAI untuk RAF, lihat Menerapkan Penyisi pan Server-Side Iklan Menggunakan Adaptor Roku di situs web Roku.

TheoPlayer

TheoPlayer integrasi dengan MediaTailor melakukan hal berikut:

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

  • Mendukung pengiriman beacon pelacakan hanya untuk iklan linier.

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

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

MediaTailor SDK

AWS Elemental memelihara perangkat JavaScript-based pengembangan perangkat lunak (SDK). AWS Elemental menyediakan SDK apa adanya, tanpa jaminan tersirat. Gunakan SDK sebagai demonstrasi referensi untuk merampingkan penggunaan MediaTailor orientasi Anda. SDK menunjukkan cara berinteraksi dengan API pelacakan MediaTailor sisi klien. SDK mengimplementasikan pelacakan dan pelaporan iklan sisi klien untuk HTML5-based pemain. SDK menginisialisasi sesi pelaporan MediaTailor sisi klien, lalu secara berkala meminta informasi pelacakan iklan. 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 petugas operator

  • Pengait acara khusus

  • Client-side beacon iklan. Untuk informasi selengkapnya tentang mengirim suar iklan, lihatClient-side mercusuar.

catatan

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