Pelacakan sisi klien

Menggunakan API pelacakan AWS Elemental MediaTailor sisi klien, Anda dapat menggabungkan kontrol pemutar selama jeda iklan dalam alur kerja streaming. Dalam pelacakan sisi klien, pemain atau klien memancarkan peristiwa pelacakan, seperti tayangan dan suar iklan kuartil, ke Server Keputusan Iklan (ADS) dan entitas verifikasi iklan lainnya. Untuk informasi selengkapnya tentang tayangan dan suar iklan kuartil, lihat. Beaconing sisi klien Untuk informasi selengkapnya tentang ADS dan entitas verifikasi iklan lainnya, lihatIntegrasi pelacakan iklan sisi klien.

Pelacakan sisi klien memungkinkan fungsionalitas seperti berikut:

• Penghitung waktu mundur jeda iklan - Untuk informasi lebih lanjut, lihat. Penghitung waktu mundur iklan

• Klik iklan - Untuk informasi lebih lanjut, lihat. Klik-tayang iklan

• Tampilan iklan pendamping - Untuk informasi selengkapnya, lihatIklan Pendamping.

• Iklan yang dapat dilewati - Untuk informasi lebih lanjut, lihat. Iklan yang dapat dilewati

• Tampilan ikon VAST untuk kepatuhan privasi - Untuk informasi selengkapnya, lihatIkon untuk Google Mengapa Iklan Ini (WTA).

• Kontrol penggosokan pemain selama iklan - Untuk informasi selengkapnya, lihatMenggosok.

Dengan menggunakan API pelacakan MediaTailor sisi klien, Anda dapat mengirim metadata ke perangkat pemutaran yang memungkinkan fungsionalitas selain pelacakan sisi klien:

Topik

• Mengaktifkan pelacakan sisi klien
• Parameter server iklan
• Parameter kueri interaksi asal
• Fitur yang dikonfigurasi sesi
• Praktik terbaik untuk pelacakan sisi klien
• Skema pelacakan iklan sisi klien
• Waktu aktivitas pelacakan iklan
• Kontrol dan fungsionalitas pemain
• Beaconing sisi klien
• Mode hybrid dengan suar iklan sisi server
• Integrasi pelacakan iklan sisi klien

Mengaktifkan pelacakan sisi klien

Anda mengaktifkan pelacakan sisi klien untuk setiap sesi. Pemain membuat HTTP POST ke titik akhir awalan sesi inisialisasi MediaTailor konfigurasi. Secara opsional, pemain dapat mengirim metadata tambahan MediaTailor untuk digunakan saat melakukan panggilan iklan, memanggil asal untuk manifes, dan memanggil atau menonaktifkan MediaTailor fitur di tingkat sesi.

Contoh berikut menunjukkan struktur metadata JSON:

{
  "adsParams": {                  # 'adsParams' is case sensitive
    "param1": "value1",           # key is not case sensitive
    "param2": "value2",           # Values can contain spaces. For example, 'value 2' is an allowed value. 
    },
  "origin_access_token":"abc123", # this is an example of a query parameter designated for the origin
  "overlayAvails":"on"            # 'overlayAvails' is case sensitive. This is an example of a feature that is enabled at the session level.
}

Gunakan MediaTailor konsol atau API untuk mengonfigurasi URL templat permintaan ADS untuk mereferensikan parameter ini. Dalam contoh berikut, player_params.param1 adalah parameter pemain untukparam1, dan player_params.param2 merupakan parameter pemain untukparam2.

https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

Parameter server iklan

Pada tingkat paling atas dari struktur JSON adalah objek adsParams JSON. Di dalam objek ini terdapat pasangan kunci/nilai yang MediaTailor dapat membaca dan mengirim ke server iklan di semua permintaan sesi. MediaTailor mendukung server iklan berikut:

• Pengelola Iklan Google

• SpringServe

• FreeWheel

• Publica

Parameter kueri interaksi asal

Setiap pasangan kunci/nilai cadangan dalam tingkat paling atas struktur JSON, seperti,adParams, dan availSuppressionoverlayAvails, tidak ditambahkan ke URL permintaan asal dalam bentuk parameter kueri. Setiap permintaan manifes sesi yang MediaTailor dibuat ke asal berisi parameter kueri ini. Asal mengabaikan parameter kueri asing. Misalnya, MediaTailor dapat menggunakan pasangan kunci/nilai untuk mengirim token akses ke asal.

Fitur yang dikonfigurasi sesi

Gunakan struktur JSON inisialisasi sesi untuk mengaktifkan, menonaktifkan, atau mengganti MediaTailor fitur seperti,, dan. overlayAvails availSuppression adSignaling Konfigurasi fitur apa pun yang diteruskan selama inisialisasi sesi mengesampingkan pengaturan pada tingkat konfigurasi. MediaTailor

catatan

Metadata yang dikirimkan MediaTailor pada saat inisialisasi sesi tidak dapat diubah, dan metadata tambahan tidak dapat ditambahkan selama sesi berlangsung. Gunakan penanda SCTE-35 untuk membawa data yang berubah selama sesi berlangsung. Untuk informasi selengkapnya, lihat Menggunakan variabel sesi.

contoh : Melakukan pelacakan iklan sisi klien untuk HLS

POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.m3u8

        {
            "adsParams": {
               "deviceType": "ipad"   # This value does not change during the session.
               "uid": "abdgfdyei-2283004-ueu"                     
           }
        }

contoh : Melakukan pelacakan iklan sisi klien untuk DASH

POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.mpd

        {
            "adsParams": {
               "deviceType": "androidmobile",
               "uid": "xjhhddli-9189901-uic" 
           }
        }

Respons yang berhasil adalah HTTP 200 dengan badan respons. Tubuh berisi objek JSON dengan trackingUrl kunci manifestUrl dan. Nilainya adalah URL relatif yang dapat digunakan pemain untuk tujuan pemutaran dan pelacakan acara iklan.

{
  "manifestUrl": "/v1/dashmaster/hashed-account-id/origin-id/asset-id.m3u8?aws.sessionId=session-id",
  "trackingUrl": "/v1/tracking/hashed-account-id/origin-id/session-id"
}

Untuk informasi selengkapnya tentang skema pelacakan sisi klien, lihat. Skema pelacakan iklan sisi klien

Praktik terbaik untuk pelacakan sisi klien

Bagian ini menguraikan praktik terbaik untuk pelacakan sisi klien MediaTailor untuk alur kerja langsung dan VOD.

Alur kerja langsung

Polling titik akhir pelacakan pada interval yang cocok dengan setiap durasi target untuk HLS, atau periode pembaruan minimum untuk DASH, agar selalu memiliki metadata pelacakan iklan terbaru. Pencocokan interval ini sangat penting dalam alur kerja di mana materi iklan mungkin memiliki komponen interaktif atau overlay.

catatan

Beberapa pemain mendukung pendengar acara, yang dapat digunakan sebagai alternatif untuk polling. Misalnya, fitur dekorasi ID MediaTailor iklan harus diaktifkan untuk setiap sesi. Untuk informasi selengkapnya, lihat Dekorasi ID Iklan. Menggunakan fitur ini menempatkan pengenal rentang tanggal (HLS) atau elemen peristiwa (DASH) di atas setiap iklan yang tersedia. Pemain dapat menggunakan tag manifes ini sebagai prompt untuk memanggil titik akhir MediaTailor pelacakan untuk sesi tersebut.

Alur kerja VOD

Setelah inisialisasi sesi berhasil, dan setelah MediaTailor menerima manifes pertama yang berisi media, Anda hanya perlu memanggil titik akhir pelacakan sekali.