Memulai dengan penyisipan MediaTailor iklan - AWS Elemental MediaTailor

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

Memulai dengan penyisipan MediaTailor iklan

Untuk menggunakannya AWS Elemental MediaTailor, Anda memerlukan izin Akun AWS dan untuk mengakses, melihat, dan mengedit MediaTailor konfigurasi. Untuk informasi tentang cara melakukannya, lihat Menyiapkan AWS Elemental MediaTailor.

Tutorial Memulai ini menunjukkan cara melakukan tugas-tugas berikut:

  • Siapkan aliran DASH konten HLS atau Anda

  • Konfigurasikan templat server keputusan iklan (ADS) URL

  • Buat MediaTailor konfigurasi yang berisi titik akhir pemutaran

  • Gunakan pemutar atau jaringan pengiriman konten (CDN) untuk membuat permintaan pemutaran MediaTailor

Setelah selesai, Anda akan dapat mengirim permintaan pemutaran ke konten iklan MediaTailor yang dipersonalisasi di streaming Anda.

Prasyarat

Sebelum memulai, pastikan Anda telah menyelesaikan langkah-langkah tersebut di Menyiapkan AWS Elemental MediaTailor.

Langkah 1: Akses AWS Elemental MediaTailor

Dengan menggunakan IAM kredensi Anda, masuk ke MediaTailor konsol di. https://console.aws.amazon.com/mediatailor/home

Langkah 2: Siapkan aliran

Konfigurasikan server asal Anda untuk menghasilkan manifes untuk HLS atau DASH yang kompatibel dengannya AWS Elemental MediaTailor.

Siapkan HLS aliran

HLSmanifes harus memenuhi persyaratan berikut:

  • Manifestasi harus dapat diakses di internet publik.

  • Manifestasi harus langsung atau video sesuai permintaan (VOD).

  • Manifestasi EXT-X-VERSION harus memiliki 3 atau lebih tinggi.

  • Untuk konten langsung, manifes harus berisi penanda untuk menggambarkan ketersediaan iklan. Ini opsional untuk VOD konten, yang dapat menggunakan VMAP timeoffsets sebagai gantinya.

    File manifes harus memiliki slot iklan yang ditandai dengan salah satu dari berikut ini:

    • #EXT-X-CUE-OUT /# EXT -X- CUE -IN (lebih umum) dengan durasi seperti yang ditunjukkan pada contoh berikut.

      #EXT-X-CUE-OUT:60.00 #EXT-X-CUE-IN
    • # EXT -X- DATERANGE (kurang umum) dengan durasi seperti yang ditunjukkan pada contoh berikut.

      #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF

      Semua bidang yang #EXT-X-DATERANGE ditampilkan diperlukan.

    Cara Anda mengonfigurasi penanda iklan dalam manifes memengaruhi apakah iklan disisipkan dalam aliran atau mengganti fragmen lain dalam aliran. Untuk informasi selengkapnya, lihat Memahami MediaTailor perilaku penyisipan iklan.

  • HLSmanifes master harus mengikuti HLS spesifikasi yang didokumentasikan pada streaming HTTP langsung: Tag daftar putar master. Secara khusus, #EXT-X-STREAM-INF harus mencakup bidangRESOLUTION,BANDWIDTH, danCODEC.

Setelah Anda mengonfigurasi aliran, perhatikan URL awalan asal konten untuk manifes master. Anda membutuhkannya untuk membuat konfigurasi di AWS Elemental MediaTailor, nanti dalam tutorial ini.

Siapkan DASH aliran

DASHmanifes harus memenuhi persyaratan berikut:

  • Manifestasi harus dapat diakses di internet publik.

  • Manifestasi harus langsung atau video sesuai permintaan (VOD).

  • Manifes harus menandai peristiwa sebagai ketersediaan iklan menggunakan penanda sisipan sambatan atau penanda sinyal waktu. Anda dapat memberikan penanda iklan dalam biner yang jelas XML atau dalam biner yang disandikan base64. Untuk sisipan sambatan, out-of-network indikator harus diaktifkan. Untuk penanda sinyal waktu, ID tipe segmentasi, yang terletak di dalam segmentasiUPID, harus merupakan nilai isyarat yang dikenali oleh. AWS Elemental MediaTailor Penggunaan iklan dimulai pada awal acara dan berlangsung selama durasi acara, jika ditentukan, atau hingga acara berikutnya dimulai.

    Contoh berikut menunjukkan peristiwa yang ditetapkan sebagai penggunaan iklan menggunakan spidol sisipan sambatan. Durasi untuk iklan ini adalah durasi acara.

    <Period start="PT444806.040S" id="123586" duration="PT15.000S"> <EventStream timescale="90000" schemeIdUri="urn:scte:scte35:2013:xml"> <Event duration="1350000"> <scte35:SpliceInfoSection protocolVersion="0" ptsAdjustment="180832" tier="4095"> <scte35:SpliceInsert spliceEventId="4026531855" spliceEventCancelIndicator="false" outOfNetworkIndicator="true" spliceImmediateFlag="false" uniqueProgramId="1" availNum="1" availsExpected="1"> <scte35:Program><scte35:SpliceTime ptsTime="5672624400"/></scte35:Program> <scte35:BreakDuration autoReturn="true" duration="1350000"/> </scte35:SpliceInsert> </scte35:SpliceInfoSection> </Event> </EventStream> <AdaptationSet mimeType="video/mp4" ... </AdaptationSet> </Period>
  • Ad avails harus memiliki Representation pengaturan yang sama AdaptationSet dan sebagai aliran konten. AWS Elemental MediaTailor menggunakan pengaturan ini untuk mentranskode iklan agar sesuai dengan aliran konten, untuk kelancaran peralihan di antara keduanya.

Setelah Anda mengonfigurasi aliran, perhatikan URL awalan asal konten untuk DASH manifes. Anda membutuhkannya untuk membuat konfigurasi di AWS Elemental MediaTailor, nanti dalam tutorial ini.

Langkah 3: Konfigurasikan parameter ADS permintaan URL dan kueri

Untuk menentukan parameter kueri yang ADS diperlukan, buat tag iklan URL dariADS. Ini URL bertindak sebagai template untuk permintaan keADS, dan terdiri dari yang berikut:

  • Nilai statis

  • Nilai yang dihasilkan oleh AWS Elemental MediaTailor (dilambangkan dengan session atau avail parameter kueri)

  • Nilai yang dihasilkan oleh pemain, diperoleh dari aplikasi klien (dilambangkan dengan player_params. parameter kueri)

contoh Tag iklan URL dari ADS
https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params]

Di mana:

  • output dan content_id adalah nilai statis

  • playerSession= [session.id] adalah nilai dinamis yang disediakan oleh. AWS Elemental MediaTailor Nilai [session.id] berubah untuk setiap sesi pemain dan menghasilkan VAST permintaan yang berbeda URL untuk setiap sesi.

  • cust_params adalah nilai dinamis yang disediakan pemain

Permintaan manifes master dari pemain harus menyediakan pasangan kunci-nilai yang sesuai dengan parameter player_params. kueri dalam permintaan. ADS URL Untuk informasi selengkapnya tentang mengonfigurasi pasangan nilai kunci dalam permintaan, lihat. AWS Elemental MediaTailorMenggunakan variabel iklan dinamis di MediaTailor

Masukkan “templat” yang dikonfigurasi URL saat Anda membuat server ADS asal/pemetaan di, di MediaTailor. Langkah 4: Buat konfigurasi

Pengujian

Anda dapat menggunakan VAST respons statis dari Anda ADS untuk tujuan pengujian. Idealnya, VAST respons mengembalikan MP4 rendisi kualitas mezzanine yang dapat mentranskode. AWS Elemental MediaTailor Jika respons dari ADS berisi beberapa rendisi pemutaran, MediaTailor pilih rendisi kualitas dan resolusi tertinggi dan mengirimkannya ke MP4 transcoder.

Langkah 4: Buat konfigurasi

AWS Elemental MediaTailor Konfigurasi menyimpan informasi pemetaan untuk server asal danADS.

Untuk membuat konfigurasi (konsol)
  1. Buka MediaTailor konsol di https://console.aws.amazon.com/mediatailor/.

  2. Di halaman Konfigurasi, pilih Buat konfigurasi.

  3. Di bagian Konfigurasi di bagian bawah halaman, untuk nama Konfigurasi, masukkan nama unik yang menjelaskan konfigurasi. Nama adalah pengenal utama untuk konfigurasi. Panjang maksimum yang diizinkan adalah 512 karakter.

  4. Untuk sumber konten Video, masukkan URL awalan untuk manifes HLS utama atau DASH manifes untuk aliran ini, dikurangi ID aset. Misalnya, jika manifes master URL adalahhttp://origin-server.com/a/master.m3u8, Anda akan masukhttp://origin-server.com/a/. Atau, Anda dapat memasukkan awalan yang lebih pendek sepertihttp://origin-server.com, tetapi kemudian Anda harus menyertakan ID aset dalam permintaan pemain untuk konten. /a/ Panjang maksimum adalah 512 karakter.

    catatan

    Jika asal konten Anda digunakanHTTPS, sertifikatnya harus dari otoritas sertifikat yang terkenal. (Ini tidak bisa berupa sertifikat yang ditandatangani sendiri.) Jika tidak, AWS Elemental MediaTailor gagal terhubung ke asal konten dan tidak dapat menyajikan manifes sebagai tanggapan atas permintaan pemain.

  5. Untuk server keputusan Iklan, masukkan URL untuk AndaADS. Ini adalah variabel URL with seperti yang dijelaskan dalamLangkah 3: Konfigurasikan parameter ADS permintaan URL dan kueri, atau statis VAST URL yang Anda gunakan untuk tujuan pengujian. Panjang maksimum adalah 25.000 karakter.

    catatan

    Jika Anda ADS menggunakanHTTPS, sertifikatnya harus dari otoritas sertifikat yang terkenal. (Ini tidak bisa berupa sertifikat yang ditandatangani sendiri.) Hal yang sama berlaku untuk iklan mezzanine yang URLs dikembalikan oleh. ADS Jika tidak, MediaTailor gagal mengambil dan memasukkan iklan ke dalam manifes dari asal konten.

  6. (Opsional sesuai kebutuhan untukDASH) Untuk Lokasi, pilih DISABLEDapakah Anda memiliki aturan CDN perutean yang disiapkan untuk mengakses MediaTailor manifes dan Anda menggunakan pelaporan sisi klien atau pemain Anda mendukung pengalihan lengket. HTTP

    Untuk informasi selengkapnya tentang fitur Lokasi, lihatDASHfitur lokasi.

  7. (Opsional) Jika server asal Anda menghasilkan DASH manifes periode tunggal, pilih jenis asal manifes DASH mpd, lalu pilih SINGLE _. PERIOD Secara default, MediaTailor menangani DASH bermanifestasi sebagai manifes multi-periode. Untuk informasi selengkapnya, lihat Mengintegrasikan MPEG - sumber DASH.

  8. Pilih Buat konfigurasi.

    AWS Elemental MediaTailor menampilkan konfigurasi baru pada halaman Konfigurasi.

Langkah 5: Uji konfigurasi

Setelah Anda menyimpan konfigurasi, uji aliran menggunakan format URL yang sesuai untuk protokol streaming Anda:

  • Contoh: HLS

    playback-endpoint/v1/master/hashed-account-id/origin-id/master.m3u8
  • Contoh: DASH

    playback-endpoint/v1/dash/hashed-account-id/origin-id/manifest.mpd

Di mana:

  • playback-endpointadalah titik akhir pemutaran unik yang AWS Elemental MediaTailor dihasilkan saat konfigurasi dibuat.

    Contoh

    https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com
  • hashed-account-idadalah Akun AWS ID Anda.

    Contoh

    AKIAIOSFODNN7EXAMPLE
  • origin-idadalah nama yang Anda berikan saat membuat konfigurasi.

    Contoh

    myOrigin
  • master.m3u8atau manifest.mpd nama manifes dari aliran pengujian ditambah ekstensi file-nya. Tentukan ini sehingga Anda mendapatkan manifes yang teridentifikasi sepenuhnya saat menambahkan ini ke sumber konten video yang Anda konfigurasikanLangkah 4: Buat konfigurasi.

Menggunakan nilai-nilai dari contoh sebelumnya, lengkap URLs adalah sebagai berikut.

  • Contoh: HLS

    https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8
  • Contoh: DASH

    https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd

Anda dapat menguji aliran menggunakan salah satu metode berikut.

  • Seperti yang ditunjukkan pada contoh sebelumnya, masukkan URL dalam pemain mandiri.

  • Uji aliran di lingkungan pemain Anda sendiri.

Langkah 6: Kirim permintaan pemutaran ke AWS Elemental MediaTailor

Konfigurasikan pemutar hilir atau CDN untuk mengirim permintaan pemutaran ke titik akhir pemutaran konfigurasi yang disediakan. AWS Elemental MediaTailor Setiap variabel dinamis yang ditentukan pemain yang Anda gunakan dalam ADS permintaan Langkah 3: Konfigurasikan parameter ADS permintaan URL dan kueri harus ditentukan URL dalam permintaan manifes dari pemain.

contoh

Asumsikan template Anda ADS URL adalah sebagai berikut.

https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params]

Kemudian tentukan [player_params.cust_params] permintaan pemain dengan mengawali pasangan kunci-nilai dengan. ads. AWS Elemental MediaTailor meneruskan parameter yang tidak didahului dengan ads. ke server asal alih-alih. ADS

Permintaan pemain URL adalah beberapa variasi dari berikut HLS dan DASH contoh.

https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8?ads.cust_params=viewerinfo
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd?ads.cust_params=viewerinfo

Ketika AWS Elemental MediaTailor menerima permintaan pemain, itu mendefinisikan variabel pemain berdasarkan informasi dalam permintaan. ADSPermintaan yang dihasilkan URL adalah beberapa variasi dari ini.

https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=<filled_in_session_id>&cust_params=viewerinfo

Untuk informasi selengkapnya tentang mengonfigurasi pasangan nilai kunci untuk diteruskan ke, lihat. ADS Menggunakan variabel iklan dinamis di MediaTailor

Langkah 7 (opsional): Pantau AWS Elemental MediaTailor aktivitas

Gunakan CloudWatch Log Amazon CloudWatch dan Amazon untuk melacak AWS Elemental MediaTailor aktivitas, seperti jumlah permintaan, kesalahan, dan ketersediaan iklan yang diisi.

Jika ini adalah pertama kalinya Anda menggunakan CloudWatch with AWS Elemental MediaTailor, buat peran AWS Identity and Access Management (IAM) untuk memungkinkan komunikasi antar layanan.

Untuk mengizinkan AWS Elemental MediaTailor akses ke CloudWatch (konsol)
  1. Buka IAM konsol di https://console.aws.amazon.com/iam/.

  2. Di panel navigasi IAM konsol, pilih Peran, lalu pilih Buat peran.

  3. Pilih jenis Akun AWS peran lain.

  4. Untuk ID Akun, masukkan Akun AWS ID Anda.

  5. Pilih Memerlukan ID eksternal dan masukkanmidas. Opsi ini secara otomatis menambahkan kondisi ke kebijakan kepercayaan yang memungkinkan layanan untuk mengambil peran hanya jika permintaan menyertakan yang benarsts:ExternalID.

  6. Pilih Berikutnya: Izin.

  7. Tambahkan kebijakan izin yang menentukan tindakan apa yang dapat diselesaikan peran ini. Pilih dari salah satu opsi berikut, lalu pilih Berikutnya: Tinjau:

    • CloudWatchLogsFullAccessuntuk menyediakan akses penuh ke Amazon CloudWatch Logs

    • CloudWatchFullAccessuntuk menyediakan akses penuh ke Amazon CloudWatch

  8. Untuk nama PeranMediaTailorLogger, masukkan, lalu pilih Buat peran.

  9. Pada halaman Peran, pilih peran yang baru saja Anda buat.

  10. Edit hubungan kepercayaan untuk memperbarui kepala sekolah:

    1. Pada halaman Ringkasan peran, pilih tab Hubungan kepercayaan.

    2. Pilih Edit trust relationship (Edit Hubungan Kepercayaan).

    3. Dalam dokumen kebijakan, ubah kepala sekolah ke AWS Elemental MediaTailor layanan. Seharusnya terlihat seperti ini.

      "Principal": { "Service": "mediatailor.amazonaws.com" },

      Seluruh kebijakan harus dibaca sebagai berikut.

      { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "mediatailor.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "sts:ExternalId": "Midas" } } } ] }
    4. Pilih Perbarui Kebijakan Kepercayaan.

Langkah 8: Membersihkan

Untuk menghindari biaya asing, hapus semua konfigurasi yang tidak perlu.

Untuk menghapus konfigurasi (konsol)
  1. Pada halaman AWS Elemental MediaTailor Konfigurasi, lakukan salah satu hal berikut:

    • Pilih nama Konfigurasi untuk konfigurasi yang ingin Anda hapus.

    • Di kolom Nama konfigurasi, pilih tombol radio, lalu pilih Hapus.

  2. Di kotak Hapus konfirmasi konfigurasi, masukkanDelete, lalu pilih Hapus lagi.

    AWS Elemental MediaTailor menghapus konfigurasi.