View a markdown version of this page

Server-side pelacakan dengan penyisipan iklan yang dipandu server (SGAI) - AWS Elemental MediaTailor

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

Server-side pelacakan dengan penyisipan iklan yang dipandu server (SGAI)

Saat Anda menggunakan penyisipan iklan yang dipandu server (SGAI), pelacakan sisi server menggunakan mekanisme beacon tanpa sesi yang berbeda dari pendekatan mode jahitan yang dijelaskan di atas. Alih-alih men MediaTailor jahit segmen iklan ke dalam manifes konten (tempat melacak /v1/segment permintaan), SGAI mengembalikan referensi iklan sebagai daftar putar terpisah dalam respons daftar aset dengan metadata suar yang disematkan di URI iklan.

Cara kerja beacon sisi server tanpa sesi

Langkah-langkah berikut menjelaskan cara kerja beacon sisi server untuk sesi SGAI:

  1. Inisialisasi sesi: Pemain meminta daftar putar multivarian HLS dengan. aws.insertionMode=GUIDED Server-side pelaporan adalah default (tidak ada aws.reportingMode parameter yang diperlukan). Tidak seperti mode jahitan, respons inisialisasi sesi tidak menyertakan a. trackingUrl

  2. Manifes yang dapat di-cache: MediaTailor mengembalikan manifes yang dapat di-cache yang berisi EXT-X-DATERANGE tag dengan CLASS="com.apple.hls.interstitial" dan X-ASSET-LIST atribut yang menunjuk ke titik akhir daftar aset MediaTailor interstitial.

  3. Daftar aset dengan metadata suar: Ketika pemain menemukan jeda iklan, ia mengambil daftar aset. MediaTailormengembalikan respons JSON di mana setiap URI iklan menyertakan metadata suar terenkripsi:

    { "ASSETS": [ { "DURATION": 30.0, "URI": "https://cdn.example.com/ad/master.m3u8?awsBeaconData=<encrypted>&awsBeaconDomain=<MediaTailor-endpoint>&awsConfigurationName=<config-name>" } ] }

    Ketika pelaporan sisi server aktif, respons tidak menyer takan bagian. TRACKING URI iklan membawa semua data suar.

  4. Substitusi variabel HLS: Pemain mengambil daftar putar multivarian iklan. Manifes iklan menggunakan #EXT-X-DEFINE:QUERYPARAM arahan untuk meneruskan parameter suar dari string kueri URI ke URL segmen melalui substitusi variabel HLS:

    #EXTM3U #EXT-X-DEFINE:QUERYPARAM="awsBeaconData" #EXT-X-DEFINE:QUERYPARAM="awsBeaconDomain" #EXT-X-DEFINE:QUERYPARAM="awsConfigurationName" #EXTINF:5.0, {$awsBeaconDomain}/segment/hash/{$awsConfigurationName}/{$awsBeaconData}/0/0?aws.segmentRelativePath=asset_00001.ts

    Pemain menyelesaikan {$awsConfigurationName} variabel, {$awsBeaconData}{$awsBeaconDomain}, dan menggunakan nilai dari string kueri URI manifes iklan, dan kemudian meminta setiap segmen iklan melalui MediaTailor.

  5. Suar menyala pada permintaan segmen: Saat pemain meminta setiap segmen iklan, permintaan akan melaluinya MediaTailor. Layanan mendekripsi data suar, menentukan posisi segmen dalam iklan (tayangan, kuartil pertama, titik tengah, kuartil ketiga, atau lengkap), dan mengaktifkan suar pelacakan VAST yang sesuai ke server iklan. MediaTailor kemudian mengarahkan pemain ke segmen konten iklan yang sebenarnya.

Persyaratan pemain untuk beacon sisi server SGAI

Untuk menggunakan beacon sisi server dengan SGAI, pemain Anda harus memenuhi persyaratan berikut:

  • HLS versi 11 atau yang lebih baru

  • Dukungan untuk EXT-X-DATERANGE dengan CLASS atribut untuk HLS Interstitial

  • Dukungan untuk substitusi #EXT-X-DEFINE:QUERYPARAM variabel (RFC 8216bis). Pemain harus memecahkan kode persentase nilai parameter kueri sebelum menggantinya ke URL segmen.

catatan

Suar sisi server SGAI saat ini didukung untuk HLS saja. DASH belum didukung untuk beacon sisi server SGAI.

Perbandingan dengan pelacakan sisi server mode jahitan

Tabel berikut merangkum perbedaan pelacakan sisi server antara penyisipan iklan yang dijahit dan dipandu server:

Aspek Jahit (SSAI) Server-guided (GOOD)
Kemampuan cache yang nyata Per-session, tidak dapat di-cache Dapat di-cache, dibagikan di seluruh pemirsa
Perutean segmen iklan Melalui /v1/segment/ menggunakan ID sesi Melalui /v1/segment/ menggunakan gumpalan data beacon terenkripsi
Status sesi untuk beacon Disimpan per sesi di MediaTailor Sessionless — semua status dibawa dalam parameter terenkripsi awsBeaconData
URL pelacakan saat sesi init Dikembalikan dalam respons inisialisasi sesi Tidak disediakan — data suar disematkan dalam URI iklan di setiap respons daftar aset
Dukungan DASH Didukung Belum didukung
catatan

Untuk sesi SGAI langsung, Anda dapat mengaktifkan prefetching iklan berbasis manifes menggunakan. aws.guidedPrefetchMode=MANIFEST Ini terpisah dari API prefetch berbasis jadwal yang digunakan dengan sesi stitched (SSAI). Lihat perinciannya di Prefetch terpandu dengan detak jantung yang nyata.