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

# Pelacakan sisi server dengan penyisipan iklan yang dipandu server (SGAI)
<a name="ad-reporting-server-side-sgai"></a>

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

## Cara kerja beaconing sisi server tanpa sesi
<a name="ad-reporting-server-side-sgai-how-it-works"></a>

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

1. **Inisialisasi sesi**: Pemain meminta daftar putar multivarian HLS dengan. `aws.insertionMode=GUIDED` Pelaporan sisi server adalah default (tidak diperlukan `aws.reportingMode` parameter). Tidak seperti mode jahitan, respons inisialisasi sesi *tidak* menyertakan a. `trackingUrl`

1. Manifes **cacheable: MediaTailor mengembalikan manifes** cacheable 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 pengantara.

1. **Daftar aset dengan metadata suar**: Saat 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>"
       }
     ]
   }
   ```

   Saat pelaporan sisi server aktif, respons *tidak* menyertakan bagian. `TRACKING` Iklan URIs membawa semua data suar.

1. **Substitusi variabel HLS**: Pemain mengambil daftar putar multivarian iklan. Manifes iklan menggunakan `#EXT-X-DEFINE:QUERYPARAM` arahan untuk meneruskan parameter beacon dari string kueri URI ke segmen URLs 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, lalu meminta setiap segmen iklan melalui. MediaTailor

1. **Penembakan suar pada permintaan segmen**: Saat pemain meminta setiap segmen iklan, permintaan akan dilalui. 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 beaconing sisi server SGAI
<a name="ad-reporting-server-side-sgai-requirements"></a>

Untuk menggunakan beaconing sisi server dengan SGAI, pemain Anda harus memenuhi persyaratan berikut:
+ HLS versi 11 atau yang lebih baru
+ Support for `EXT-X-DATERANGE` with `CLASS` atribut untuk HLS Interstitials
+ Support untuk substitusi `#EXT-X-DEFINE:QUERYPARAM` variabel (RFC 8216bis). Pemain harus mendekode nilai parameter kueri sebelum menggantinya ke segmen. URLs

**catatan**  
SGAI server-side beaconing saat ini didukung untuk HLS saja. DASH belum didukung untuk beaconing sisi server SGAI.

## Perbandingan dengan pelacakan sisi server mode jahitan
<a name="ad-reporting-server-side-sgai-comparison"></a>

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


| Aspek | Dijahit (SSAI) | Dipandu server (SGAI) | 
| --- | --- | --- | 
| Manifestasi cacheability | Per-sesi, 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 | 
| Melacak URL pada sesi init | Kembali dalam respon inisialisasi sesi | Tidak disediakan — data suar disematkan dalam iklan URIs 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](sgai-guided-prefetch.md).