Gejala Penyebab Langkah pemecahan masalah Variabel sesi Kueri lanjutan Praktik terbaik Sumber daya terkait

Memecahkan masalah iklan yang dilewati MediaTailor

Melewatkan iklan adalah salah satu masalah paling umum yang dilaporkan oleh MediaTailor pelanggan. Bagian ini memberikan analisis terperinci tentang mengapa iklan dapat dilewati selama pemutaran dan menawarkan solusi untuk memastikan penyisipan iklan yang tepat.

Gejala dan dampak

Ketika iklan skipping terjadi, Anda mungkin mengamati gejala-gejala berikut:

Iklan tidak muncul selama jeda iklan yang diharapkan
Istirahat iklan diisi dengan konten, bukan iklan
Pemutaran iklan yang tidak konsisten di berbagai sesi penayangan
CloudWatch log yang menampilkan AdSkipped acara dengan berbagai alasan lewati

Melompati iklan secara langsung berdampak pada penghasilan pendapatan dan dapat menyebabkan pengalaman pemirsa yang buruk jika tidak ditangani dengan segera.

Penyebab umum

MediaTailor mencatat alasan spesifik mengapa iklan dilewati dalam pesan log FILLED_AVAIL peristiwa dari grup MediaTailor/AdDecisionServerInteractions log. Memahami alasan lewati ini sangat penting untuk pemecahan masalah yang efektif.

Alasan lewati iklan umum
Lewati alasan	Deskripsi
`NEW_CREATIVE`	Iklan belum ditranskode. Hal ini terjadi ketika MediaTailor menemukan iklan kreatif baru yang memerlukan transcoding sebelum penyisipan.
`PROFILE_NOT_FOUND`	Profil MediaConvert transkode yang terkait dengan konfigurasi sesi tidak ada, mencegah persiapan iklan.
`TRANSCODE_ERROR`	Proses transkode iklan mengalami kesalahan dan gagal diselesaikan.
`TRANSCODE_IN_PROGRESS`	Transkode iklan masih dalam proses dan belum siap untuk dimasukkan.
`INTERNAL_ERROR`	Terjadi MediaTailor kesalahan internal saat menangani iklan, mencegah penyisipan.
`AVAIL_DURATION_EXCEEDED`	Iklan tidak sesuai dengan sisa durasi jeda iklan.
`LEFTOVER_AVAIL_EXCEEDED_THRESHOLD`	Durasi kumulatif semua iklan yang mungkin telah disisipkan tidak memenuhi ambang personalisasi yang dikonfigurasi untuk sesi tersebut.
`VAST_PARSING_ERROR`	Respons VAST dari server keputusan iklan berisi kesalahan atau cacat.
`ADS_TIMEOUT`	Server keputusan iklan tidak merespons dalam periode batas waktu yang dikonfigurasi.
`MEDIA_FILE_UNAVAILABLE`	File media iklan yang ditentukan dalam respons VAST tidak dapat diakses.
`SESSION_INITIALIZATION_FAILED`	MediaTailor Sesi gagal diinisialisasi dengan benar, seringkali karena variabel sesi yang salah.
`EARLY_CUE_IN`	Jeda iklan berakhir lebih awal dari yang diharapkan karena sinyal isyarat awal, mencegah iklan dimasukkan sepenuhnya.
`NO_VARIANT_MATCH`	Kreatif iklan tidak memiliki varian yang cocok dengan parameter pengkodean aliran konten (bitrate, resolusi, codec).
`NO_MODEL_CREATIVE_MATCH`	Kreatif iklan tidak sesuai dengan model atau persyaratan format yang diharapkan untuk konfigurasi pemutaran saat ini.
`REJECTED_REPLICA_VAST`	Respons VAST ditolak karena kebijakan deteksi konten replika atau duplikat.
`INVALID_VAST_WRAPPER_AD`	Iklan pembungkus VAST berisi elemen pembungkus yang tidak valid atau cacat yang mencegah penyisipan iklan berhasil.
`IMPORT_ERROR`	Terjadi kesalahan selama proses impor iklan, mencegah iklan diproses untuk penyisipan.
`IMPORT_IN_PROGRESS`	Proses impor iklan sedang berlangsung dan belum selesai.

Di luar alasan lompatan khusus ini, penyebab umum lainnya meliputi:

Konfigurasi variabel sesi salah
Masalah konektivitas server keputusan iklan (ADS)
Kreatif yang tidak konsisten IDs untuk konten iklan yang sama
Masalah kompatibilitas pemain dengan format manifes
Masalah konfigurasi CDN yang memengaruhi pengiriman segmen iklan

Langkah pemecahan masalah

Ikuti langkah-langkah berikut untuk mendiagnosis dan mengatasi masalah melewatkan iklan:

Identifikasi alasan lompatan spesifik

Gunakan Wawasan CloudWatch Log untuk menanyakan grup MediaTailor/AdDecisionServerInteractions log untuk iklan yang dilewati:
```
fields @timestamp, avail.availId, skippedAds.0.skippedReason, skippedAds.0.creativeUniqueId
| filter eventType = "FILLED_AVAIL" and ispresent(skippedAds.0.skippedReason)
| sort @timestamp desc
                
```
Kueri ini menampilkan peristiwa lewati iklan terbaru dengan alasan spesifiknya, membantu Anda mengidentifikasi pola.
Periksa konfigurasi variabel sesi

Variabel sesi yang salah adalah penyebab umum lompatan iklan. Verifikasi bahwa:
- Semua variabel sesi yang diperlukan dikonfigurasi dengan benar di template URL ADS Anda
- Variabel dinamis diformat dengan benar (lihat sintaks MediaTailor variabel iklan dinamis yang tepat)
- Parameter pemain sedang diteruskan dengan benar MediaTailor
Contoh URL ADS yang dikonfigurasi dengan benar dengan variabel sesi:
```
https://my-ads-server.com/ads?
sessionId=[session.id]&
playerParams=[player_params.param1]&
deviceType=[player_params.device]&
correlator=[session.avail_duration_ms]
                
```
Selesaikan masalah NEW_CREATIVE

Jika iklan dilewati dengan NEW_CREATIVE alasan:

MediaTailor mentranskode iklan berdasarkan tiga faktor utama: ID kreatif, ID Akun AWS, dan set varian transkode (rendisi pemutaran untuk aliran konten yang mendasarinya). Jika ada bagian dari kumpulan varian ID kreatif atau transkode yang berbeda, MediaTailor kenali iklan sebagai varian baru yang memerlukan transcoding. Ini termasuk perubahan bitrate ketika dibulatkan ke 8.000 bit terdekat, yang dapat terjadi ketika aliran konten yang mendasarinya mengubah manifes utama.

Untuk informasi rinci tentang skenario NEW_CREATIVE termasuk perubahan bitrate dan konflik ID kreatif, lihat Analisis NEW_CREATIVE terperinci bagian mengikuti prosedur ini.
1. Verifikasi bahwa server keputusan iklan Anda menampilkan materi iklan yang konsisten IDs untuk konten iklan yang sama
2. Periksa apakah aliran konten Anda mempertahankan bitrate dan set varian yang konsisten
3. Pertimbangkan untuk menerapkan prefetching iklan untuk memastikan iklan ditranskode sebelum pemutaran (lihat) Prefetching iklan
4. Untuk masalah yang terus-menerus, hubungi AWS Support untuk bantuan pemecahan masalah tambahan
Mengatasi masalah konektivitas ADS

Jika iklan dilewati dengan ADS_TIMEOUT atau alasan terkait:
- Verifikasi bahwa server keputusan iklan Anda dapat diakses dari MediaTailor
- Periksa apakah ADS Anda merespons dalam periode batas waktu yang dikonfigurasi
- Pastikan ADS Anda dapat menangani volume permintaan selama periode puncak
- Pertimbangkan untuk menerapkan strategi iklan fallback ketika ADS utama Anda tidak tersedia
Selesaikan masalah respons VAST

Jika iklan dilewati dengan VAST_PARSING_ERROR atauMEDIA_FILE_UNAVAILABLE:
- Validasi format respons VAST Anda terhadap spesifikasi VAST
- Pastikan semua file media URLs dalam respons VAST dapat diakses publik
- Periksa pengkodean karakter khusus yang tepat di VAST XMLmu
- Verifikasi bahwa respons VAST Anda menyertakan file media dalam format yang kompatibel dengan MediaTailor
Mengatasi masalah ketidakcocokan durasi

Jika iklan dilewati dengan AVAIL_DURATION_EXCEEDED atauLEFTOVER_AVAIL_EXCEEDED_THRESHOLD:
- Pastikan ADS Anda menampilkan iklan yang sesuai dengan durasi jeda iklan yang tersedia
- Periksa apakah penanda jeda iklan di konten menandakan durasi yang diinginkan dengan benar
- Pertimbangkan untuk menyesuaikan ambang personalisasi jika sesuai untuk kasus penggunaan Anda
Monitor CloudWatch metrik

Siapkan CloudWatch alarm untuk MediaTailor metrik utama untuk mendeteksi masalah melewatkan iklan secara proaktif:
- AdDecisionServer.Ads.Skipped- Hitungan iklan yang dilewati
- AdDecisionServer.Timeouts- Hitungan batas waktu ADS
- Avail.FilledDuration- Durasi jeda iklan yang diisi
- Avail.SlateOnly- Hitungan jeda iklan yang diisi dengan batu tulis saja
Untuk informasi selengkapnya tentang metrik yang tersedia, lihat Pemantauan AWS Elemental MediaTailor dengan CloudWatch metrik Amazon.
Mengatasi masalah pencocokan varian dan format

Jika iklan dilewati denganNO_VARIANT_MATCH,, NO_MODEL_CREATIVE_MATCHEARLY_CUE_IN, atau alasan terkait format:
- NO_VARIANT_MATCH: Pastikan materi iklan Anda tersedia dalam varian yang sesuai dengan parameter pengkodean aliran konten Anda (bitrate, resolusi, codec). Konfigurasikan server iklan Anda untuk menyediakan iklan dalam format yang kompatibel.
- NO_MODEL_CREATIVE_MATCH: Tinjau persyaratan model kreatif konfigurasi pemutaran Anda dan pastikan server iklan Anda menyediakan iklan yang sesuai dengan format dan spesifikasi yang diharapkan.
- EARLY_CUE_IN: Pastikan sinyal cue-in aliran konten Anda diatur waktunya dengan benar dan jeda iklan memiliki durasi yang cukup untuk penyisipan iklan. Periksa EXT-X-CUE-IN tag prematur atau pesan splice_insert SCTE-35.
Selesaikan masalah pembungkus dan impor VAST

Jika iklan dilewati denganREJECTED_REPLICA_VAST,, INVALID_VAST_WRAPPER_ADIMPORT_ERROR, atauIMPORT_IN_PROGRESS:
- REJECTED_REPLICA_VAST: Periksa konfigurasi server iklan Anda untuk kebijakan deteksi konten duplikat. Pastikan respons VAST berisi konten kreatif yang unik dan hindari menayangkan iklan yang identik dalam sesi yang sama.
- INVALID_VAST_WRAPPER_AD: Validasi respons pembungkus VAST Anda terhadap spesifikasi VAST. Pastikan semua elemen pembungkus diformat dengan benar dan berisi TagURI yang valid VASTAd.
- IMPORT_ERRORdanIMPORT_IN_PROGRESS: Ini menunjukkan masalah dengan proses impor iklan. Periksa file sumber kreatif iklan untuk aksesibilitas dan kompatibilitas format. Pantau kemajuan impor dan coba lagi impor yang gagal.

Analisis NEW_CREATIVE terperinci

Bagian ini memberikan informasi komprehensif tentang skenario melewatkan iklan NEW_CREATIVE, termasuk penyebab mendasar dan teknik pemecahan masalah lanjutan.

Skenario Perubahan Bitrate

Perubahan bitrate dapat menyebabkan NEW_CREATIVE melewatkan ketika bitrate tidak cocok setelah dibulatkan ke 8.000 bit terdekat. Ini biasanya terjadi ketika:

Aliran konten yang mendasari mengubah manifes utama
Sesi baru dibuat dengan varian berbeda dari sesi yang ada
Bitrate aliran konten tidak konsisten di seluruh sesi pemutaran

Konflik ID Kreatif

Ketika MediaTailor menemukan ID kreatif yang berbeda untuk file media yang telah ditranskode, urutan berikut terjadi:

Iklan dilewati dengan alasan NEW_CREATIVE
Ini mengarah pada upaya transcoding yang tidak perlu
Kreatif ditandai sebagai DUPLICATE_TRANSCODE atau COPY_DEDUP

catatan

MediaTailor tidak kedaluwarsa atau menghapus iklan transkode. Mereka disimpan dalam ember S3 MediaTailor milik tanpa batas waktu.

Pengolahan ETAG

ETAG adalah pengenal unik yang terkait dengan versi tertentu dari daftar putar iklan atau manifes. MediaTailor menggunakan ID kreatif untuk mengidentifikasi aset iklan, tetapi jika ID kreatif berubah dengan setiap permintaan, iklan dapat ditandai sebagai materi iklan baru, mencegah penyisipan.

Awas

ID kreatif tidak dijamin unik, yang dapat mengakibatkan iklan yang salah ditampilkan.

Masalah format durasi

Penyisipan Iklan Sisi Server (SSAI) memerlukan format parameter durasi tertentu dalam file manifes. Format durasi yang salah dapat menyebabkan kegagalan penyisipan iklan.

EXT-X-CUE-OUT parameter durasi

Parameter durasi EXT-X-CUE-OUT tag harus diformat sebagai nilai integer, bukan sebagai format durasi ISO 8601.

Persyaratan format durasi
format	Contoh	Status
Integer (Benar)	`32`	Didukung - mewakili 32 detik
Desimal (Benar)	`30.000`	Didukung - mewakili 30 detik
ISO 8601 (Salah)	`PT32S`	Tidak didukung - menyebabkan kegagalan penyisipan

Contoh format manifes yang benar:



#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:10
#EXTINF:10.0,
segment1.ts
#EXT-X-CUE-OUT:30
#EXTINF:10.0,
segment2.ts
#EXT-X-CUE-IN
#EXTINF:10.0,
segment3.ts

penting

Pastikan semua parameter EXT-X-CUE-OUT durasi menggunakan format integer untuk mencegah masalah penyisipan iklan.

Memvalidasi format penanda iklan

Untuk memvalidasi format penanda iklan dan mengidentifikasi masalah penguraian durasi:

Periksa format penanda iklan di CloudWatch log di bawah AD_MARKER_FOUND peristiwa
Cari alasan FORMAT_ERROR lewati dalam FILLED_AVAIL acara
Verifikasi bahwa nilai durasi dalam manifes konten Anda menggunakan format yang didukung
Uji dengan format durasi yang berbeda untuk mengidentifikasi masalah kompatibilitas

Optimalisasi aliran VOD

Streaming Video On Demand (VOD) dapat menghasilkan beberapa permintaan ADS, yang dapat memengaruhi kinerja. MediaTailor menyediakan fitur pengoptimalan untuk mengatasi perilaku ini.

Beberapa masalah permintaan ADS

Secara default, aliran VOD dapat menghasilkan beberapa peristiwa MAKING_ADS_REQUEST dalam log. MediaTailor Hal ini terjadi karena setiap jeda iklan dalam konten VOD memicu permintaan ADS terpisah ke server keputusan iklan.

Untuk mengidentifikasi apakah aliran VOD Anda menghasilkan permintaan ADS yang berlebihan, gunakan kueri Wawasan CloudWatch Log ini:



fields @timestamp, sessionId, eventType, adBreakIndex
| filter eventType = "MAKING_ADS_REQUEST"
| stats count() by sessionId
| sort count desc
| limit 20

Fitur paralelisasi VOD

MediaTailor menawarkan fitur paralelisasi untuk mengoptimalkan penanganan permintaan ADS untuk konten VOD. Fitur ini dapat dikonfigurasi menggunakan maxConcurrentAdsRequests parameter dalam konfigurasi pemutaran Anda.

Contoh konfigurasi:



{
  "Name": "OptimizedVODConfig",
  "VideoContentSourceUrl": "https://example.com/content/",
  "AdDecisionServerUrl": "https://example.com/ads",
  "maxConcurrentAdsRequests": 3
}

Konfigurasi ini membatasi jumlah permintaan ADS bersamaan, mengurangi beban server dan meningkatkan waktu respons.

Penanganan respons VAST yang dibungkus

Fitur paralelisasi juga mengoptimalkan penanganan respons VAST yang dibungkus, yang umum dalam skenario periklanan terprogram. Respons VAST yang dibungkus berisi beberapa lapisan tag VAST yang perlu dibuka untuk mencapai file media yang sebenarnya.

Pemecahan masalah variabel sesi

Variabel sesi memainkan peran penting dalam penargetan dan pemilihan iklan. Konfigurasi variabel sesi yang salah adalah penyebab umum masalah melewatkan iklan.

Masalah variabel sesi umum

Masalah berikut dengan variabel sesi dapat menyebabkan lompatan iklan:

Variabel wajib hilang: Server keputusan iklan Anda mungkin memerlukan variabel tertentu yang tidak disediakan
Sintaks variabel salah: Variabel harus menggunakan sintaks yang benar (misalnya, [session.id] bukan) ${session.id}
Masalah pengkodean URL: Karakter khusus dalam nilai variabel mungkin memerlukan pengkodean URL yang tepat
Parameter pemain yang tidak konsisten: Parameter pemain harus secara konsisten melewati sesi
Kegagalan resolusi variabel dinamis: Variabel yang tidak dapat diselesaikan akan diganti dengan string kosong
Masalah parsing UPID SCTE-35: Masalah dengan pemrosesan UPID segmentasi dapat menyebabkan kegagalan resolusi variabel sesi.

Memverifikasi resolusi variabel sesi

Untuk memverifikasi bahwa variabel sesi Anda diselesaikan dengan benar:

Aktifkan pencatatan debug untuk konfigurasi Anda MediaTailor
Periksa grup MediaTailor/AdDecisionServerInteractions log untuk permintaan ADS yang sebenarnya URLs
Verifikasi bahwa semua variabel dalam URL template telah diganti dengan nilai yang sesuai
Cari variabel apa pun yang diganti dengan string kosong, yang mungkin mengindikasikan kegagalan resolusi

Contoh entri log yang menampilkan URL permintaan ADS yang diselesaikan:



{
  "eventType": "MAKING_ADS_REQUEST",
  "sessionId": "abcd1234-5678-efgh-9012-ijklmnopqrst",
  "requestUrl": "https://my-ads-server.com/ads?sessionId=abcd1234-5678-efgh-9012-ijklmnopqrst&playerParams=mobile&deviceType=android&correlator=30000",
  "timestamp": "2025-06-20T19:00:00Z"
}

SCTE-35 UPID parsing dan variabel sesi

Masalah dengan pemrosesan UPID segmentasi SCTE-35 dapat menyebabkan masalah variabel sesi:

Persyaratan format: UPID harus memiliki segmentation_upid_type 12 dan termasuk format_identifier untuk pemrosesan yang tepat.
Aturan parsing: UPID yang didekode dapat berisi pembatas titik dua untuk beberapa nilai. Jumlah variabel template dan token UPID yang diterjemahkan harus sama.
Format tidak valid: Hindari titik dua ganda tanpa nilai (misalnya, :: atau:46175218::4053) karena ini menyebabkan kegagalan penguraian.
Penanganan pengenal format: MediaTailor mengasumsikan empat byte pertama adalah format_identifier. Jika tidak ada, private_data memotong empat byte pertama, yang berpotensi menyebabkan ADS menerima nilai yang berbeda dari yang diharapkan.

Kueri Wawasan CloudWatch Log Tingkat Lanjut

Gunakan kueri Wawasan CloudWatch Log khusus ini untuk pemecahan masalah penyisipan iklan secara mendetail:

Menemukan Kreatif IDs

Untuk mengidentifikasi Creative IDs dari peristiwa FILLED_AVAIL di ads_interaction_log:



fields @timestamp, sessionId, eventType
| filter sessionId like /sessionId/ and eventType!='BEACON_FIRED'
| sort @timestamp desc

catatan

Ganti sessionId dengan ID sesi aktual yang sedang Anda selidiki.

Analisis sesi komprehensif

Untuk analisis rinci perilaku penyisipan iklan untuk sesi tertentu:



fields @timestamp, sessionId, eventType, creativeId, skipReason, adBreakIndex
| filter sessionId = "your-session-id-here"
| filter eventType in ["FILLED_AVAIL", "SKIPPED_AVAIL", "MAKING_ADS_REQUEST"]
| sort @timestamp asc
| limit 100

NEW_CREATIVE lewati analisis

Untuk menganalisis pola dalam lompatan iklan NEW_CREATIVE:



fields @timestamp, sessionId, creativeId, skipReason, MediaFileSourceUrl
| filter skipReason = "NEW_CREATIVE"
| stats count() by creativeId, MediaFileSourceUrl
| sort count desc
| limit 50

Praktik terbaik untuk mencegah melewatkan iklan

Terapkan praktik terbaik ini untuk meminimalkan masalah melewatkan iklan:

Terapkan prefetching iklan: Gunakan MediaTailor fitur prefetch untuk memastikan iklan ditranskode sebelum pemutaran. Lihat Prefetching iklan untuk detail implementasi.
Pertahankan materi iklan yang konsisten IDs: Pastikan server keputusan iklan Anda menggunakan materi iklan yang konsisten IDs untuk konten iklan yang sama di seluruh sesi.
Pastikan pemformatan durasi yang tepat: Gunakan nilai integer untuk parameter EXT-X-CUE-OUT durasi, bukan format ISO 8601.
Konfigurasikan optimasi VOD: Tetapkan maxConcurrentAds Permintaan untuk aliran VOD dengan beberapa jeda iklan untuk mengurangi beban server.
Pantau pola transcoding: Pantau CloudWatch log untuk efisiensi transcoding dan hubungi AWS Support jika Anda melihat pola yang menunjukkan masalah transcoding.
Verifikasi konsistensi ETAG: Pastikan File Media konsisten untuk konten URIs yang identik untuk mencegah transcoding ulang yang tidak perlu.
Menerapkan pemecahan masalah sistematis: Ikuti pendekatan terstruktur: mengidentifikasi alasan lewati, menganalisis akar penyebab, menerapkan resolusi, dan memvalidasi perbaikan.
Optimalkan kinerja ADS: Konfigurasikan server keputusan iklan Anda untuk merespons dengan cepat dan menangani volume lalu lintas puncak.
Menerapkan penanganan kesalahan yang tepat: Konfigurasikan konten batu tulis untuk mengisi jeda iklan saat iklan tidak dapat disisipkan.
Pantau metrik penyisipan iklan: Siapkan CloudWatch alarm untuk mendeteksi masalah melewatkan iklan lebih awal.
Uji secara menyeluruh: Validasi alur kerja penyisipan iklan Anda di berbagai perangkat dan kondisi jaringan.
Menerapkan strategi fallback: Konfigurasikan sumber iklan cadangan atau iklan default saat sumber iklan utama gagal.

Untuk informasi selengkapnya tentang pemecahan masalah melewatkan iklan, lihat topik terkait ini:

MediaTailor variabel iklan dinamis- Panduan komprehensif untuk variabel iklan dinamis di MediaTailor
Prefetching iklan- Cara menerapkan prefetching iklan untuk mencegah skipping terkait transcoding
Pemantauan AWS Elemental MediaTailor dengan CloudWatch metrik Amazon- Pemantauan MediaTailor dengan CloudWatch metrik
Melihat AWS Elemental MediaTailor log- Cara melihat dan menganalisis MediaTailor log
Memecahkan masalah alur MediaTailor acara- Memahami alur acara penyisipan iklan
Memecahkan masalah alur MediaTailor acara- Teknik pemantauan dan pemecahan masalah tingkat lanjut
Untuk informasi selengkapnya tentang perbedaan yang meminta MediaTailor untuk mentranskode ulang iklan, lihat dokumentasi AWS tentang logika pencocokan varian
Untuk pemecahan masalah konten iklan lanjutan, hubungi AWS Support

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

Pemecahan masalah pemutaran

MediaTailor sumber daya