Melewati parameter ke ADS Penggunaan lanjutan

Menggunakan variabel iklan dinamis di MediaTailor

Bagian AWS Elemental MediaTailor permintaan ke server keputusan iklan (ADS) mencakup informasi tentang sesi penayangan saat ini, yang membantu ADS memilih iklan terbaik untuk diberikan dalam tanggapannya. Ketika Anda mengkonfigurasi ADS template dalam MediaTailor konfigurasi Anda, Anda dapat menyertakan variabel dinamis, juga dikenal sebagai makro. Variabel dinamis adalah string yang dapat diganti.

Variabel dinamis dapat mengambil bentuk berikut:

Nilai statis — Nilai yang tidak berubah dari satu sesi ke sesi berikutnya. Misalnya, jenis respons yang MediaTailor diharapkan dari. ADS
Variabel domain — Variabel dinamis yang dapat digunakan untuk URL domain, seperti my-ads-serverbagian.com dari URL http://my-ads-server.com. Untuk detailnya, lihat Menggunakan variabel domain untuk mengonfigurasi beberapa konten dan sumber iklan.
Data sesi — Nilai dinamis yang disediakan oleh MediaTailor untuk setiap sesi, misalnya, ID sesi. Untuk detailnya, lihat Menggunakan variabel sesi.
Data pemain — Nilai dinamis yang disediakan oleh pemain untuk setiap sesi. Ini menjelaskan penampil konten dan ADS membantu menentukan iklan mana yang MediaTailor harus dimasukkan ke dalam aliran. Untuk detailnya, lihat Menggunakan variabel pemain.

Untuk informasi selengkapnya tentang penggunaan variabel domain, sesi, dan pemain dinamis, pilih topik yang berlaku.

Topik

Melewati parameter ke ADS

Untuk meneruskan sesi dan informasi pemain ke ADS

Bekerja dengan ADS untuk menentukan informasi yang dibutuhkan sehingga dapat menanggapi permintaan iklan dari AWS Elemental MediaTailor.
Buat konfigurasi MediaTailor yang menggunakan ADS permintaan template URL yang memenuhi ADS persyaratan. DalamURL, sertakan parameter statis dan sertakan placeholder untuk parameter dinamis. Masukkan templat Anda URL di bidang server keputusan iklan konfigurasi.

Dalam contoh template berikutURL, correlation menyediakan data sesi, dan deviceType menyediakan data pemain:
```
https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
```
Pada pemain, konfigurasikan permintaan inisiasi sesi untuk AWS Elemental MediaTailor untuk memberikan parameter untuk data pemain. Sertakan parameter Anda dalam permintaan inisiasi sesi, dan hilangkan dari permintaan berikutnya untuk sesi tersebut.

Jenis panggilan yang dilakukan pemain untuk menginisialisasi sesi menentukan apakah pemain (klien) atau MediaTailor (server) menyediakan pelaporan pelacakan iklan untuk sesi tersebut. Untuk informasi tentang dua opsi ini, lihatMelaporkan data pelacakan iklan .

Lakukan salah satu jenis panggilan berikut, tergantung apakah Anda menginginkan pelaporan pelacakan iklan sisi server atau klien. Dalam kedua contoh panggilan, userID dimaksudkan untuk ADS dan auth_token dimaksudkan untuk asal:
- (Opsi) Panggilan untuk pelaporan pelacakan iklan sisi server — Awalan parameter yang ingin Anda kirim MediaTailor ke with. ADS ads Biarkan awalan mati untuk parameter yang ingin Anda kirim MediaTailor ke server asal:
  
  Contoh berikut menunjukkan permintaan masuk untuk HLS dan DASH AWS Elemental MediaTailor. MediaTailor menggunakan deviceType dalam permintaannya ke ADS dan auth_token dalam permintaannya ke server asal.
  
  HLScontoh:
```
GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
  DASHcontoh:
```
GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
- (Opsi) Panggilan untuk pelaporan pelacakan iklan sisi klien — Berikan parameter untuk ADS bagian dalam suatu objek. adsParams
  
  HLScontoh:
```
POST master.m3u8
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```
  DASHcontoh:
```
POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```

Ketika pemain memulai sesi, AWS Elemental MediaTailor menggantikan variabel dalam ADS permintaan template URL dengan data sesi dan ads parameter pemain. Ini melewati parameter yang tersisa dari pemain ke server asal.

Contoh berikut menunjukkan panggilan ke ADS dan server asal dari AWS Elemental MediaTailor yang sesuai dengan contoh panggilan inisialisasi sesi pemain sebelumnya:

MediaTailor memanggil data sesi ADS dengan dan jenis perangkat pemain:
```
https://my.ads.server.com/path?correlation=896976764&deviceType=ipad
```

MediaTailor memanggil server asal dengan token otorisasi pemain.

HLScontoh:


https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh

DASHcontoh:


https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh

Bagian berikut memberikan rincian untuk mengkonfigurasi sesi dan data pemain.

Penggunaan lanjutan

Anda dapat menyesuaikan ADS permintaan dengan banyak cara dengan data pemain dan sesi. Satu-satunya persyaratan adalah memasukkan ADS nama host.

Contoh berikut menunjukkan beberapa cara agar Anda dapat menyesuaikan permintaan Anda:

Menggabungkan parameter pemain dan parameter sesi untuk membuat parameter baru. Contoh:
```
https://my.ads.com?key1=[player_params.value1][session.id]
```
Gunakan parameter pemain sebagai bagian dari elemen jalur. Contoh:
```
https://my.ads.com/[player_params.path]?key=value
```
Gunakan parameter pemain untuk melewati elemen jalur dan kunci itu sendiri, bukan hanya nilai. Contoh:
```
https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]
```

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Integrasi pelacakan iklan

Menggunakan variabel domain