View a markdown version of this page

Perbaiki masalah manajemen sesi CDN dan pelacakan MediaTailor - AWS Elemental MediaTailor

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

Perbaiki masalah manajemen sesi CDN dan pelacakan MediaTailor

AWS Elemental MediaTailor Manajemen sesi jaringan pengiriman konten (CDN) sangat penting untuk personalisasi dan pelacakan iklan yang tepat. Jika Anda menemukan kesalahan terkait sesi atau perilaku yang tidak konsisten di seluruh permintaan:

  1. Periksa konsistensi ID sesi:

    • Verifikasi bahwa pemain Anda mempertahankan ID sesi yang sama di semua permintaan untuk satu sesi pemutaran

    • Periksa log CDN untuk mengonfirmasi sesi IDs diteruskan dengan benar

    • Pastikan sesi IDs dikodekan URL dengan benar dalam parameter kueri

    • Gunakan CloudWatch Log untuk memverifikasi konsistensi ID sesi di seluruh permintaan (lihat langkah validasi di bawah)

  2. Validasi inisialisasi sesi:

    • Konfirmasikan bahwa permintaan manifes pertama berhasil membuat sesi

    • Periksa penerusan parameter sesi yang tepat (misalnya,) aws.sessionId

    • Verifikasi inisialisasi sesi menggunakan log debug (lihat pengaturan log debug di bawah)

  3. Aktifkan pencatatan debug untuk pemecahan masalah sesi terperinci:

    • Untuk pelaporan sisi server: Tambahkan ?aws.logMode=DEBUG ke permintaan pemutaran Anda:

      GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUG

    • Untuk pelaporan sisi klien: Sertakan "logMode": "DEBUG" dalam badan permintaan inisialisasi sesi Anda

    • Penting: DEBUG Nilai peka huruf besar/kecil

    • Maksimal 10 sesi debug aktif diizinkan secara bersamaan

  4. Gunakan kueri CloudWatch Log untuk memvalidasi perilaku sesi:

    • Verifikasi sesi debug aktif:

      fields @timestamp, @message
| filter sessionId = "your-session-id-here"
| filter eventType = "SESSION_INITIALIZED" # client-side reporting
or mediaTailorPath like "/v1/master" # server-side reporting HLS
or mediaTailorPath like "/v1/dash" # server-side reporting DASH

    • Lihat semua acara untuk satu sesi:

      fields @timestamp, @message, eventType, mediaTailorPath
| filter sessionId = "your-session-id-here"
| sort @timestamp asc

    • Periksa pembuatan manifes untuk sesi:

      fields @timestamp, responseBody, @message
| filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "your-session-id-here"

  5. Penerusan parameter sesi uji melalui CDN:

    • Uji permintaan manifes dengan parameter sesi langsung terhadap MediaTailor (melewati CDN)

    • Bandingkan perilaku sesi dengan dan tanpa CDN untuk mengidentifikasi masalah penerusan

    • Verifikasi konfigurasi penerusan parameter kueri CDN mencakup parameter terkait sesi

    • Periksa apakah CDN tidak menyimpan respons yang harus spesifik untuk sesi

Pesan kesalahan sesi umum:

  • ConflictException(HTTP 409) - Beberapa permintaan daftar putar simultan untuk sesi yang sama. Solusi: Pastikan pemain Anda meminta daftar putar satu per satu sesuai dengan spesifikasi HLS

  • NotFoundException(HTTP 404) - Sesi tidak tersedia atau konfigurasi tidak ada. Solusi: Periksa validitas konfigurasi Anda dan inisialisasi ulang sesi

  • BadRequestException(HTTP 400) - ID sesi tidak valid atau permintaan yang tidak diformat dengan benar. Solusi: Verifikasi pemformatan permintaan dan validitas ID sesi

Sumber daya pemecahan masalah tambahan:

Kriteria keberhasilan: Ketika diselesaikan, sesi harus diinisialisasi dengan benar, mempertahankan sesi yang konsisten IDs di seluruh permintaan, dan log debug harus menampilkan SESSION_INITIALIZED peristiwa yang tepat dan pembuatan manifes tanpa kesalahan.