View a markdown version of this page

Membuat dan mengelola Fungsi - AWS Elemental MediaTailor
Menyiapkan fungsiMengelola fungsiMenghapus fungsiAturan validasiReferensi API

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

Membuat dan mengelola Fungsi

Halaman ini memandu Anda melalui pembuatan, melampirkan, memperbarui, dan menghapus Fungsi menggunakan MediaTailor konsol. Fungsi memungkinkan Anda menyesuaikan perilaku sesi dan permintaan iklan dengan menjalankan logika pada titik-titik penting selama pemutaran.

Menyiapkan fungsi

Membuat fungsi menggunakan konsol

  1. Buka konsol MediaTailor.

  2. Di panel navigasi, pilih Fungsi.

  3. Pilih Buat fungsi.

  4. Untuk ID Fungsi, masukkan nama unik untuk fungsi tersebut (misalnya,fetchIdentity).

  5. Untuk Jenis fungsi, pilihCUSTOM_OUTPUT,HTTP_REQUEST,VAST_REQUEST,SEQUENTIAL_EXECUTOR, atauCONCURRENT_EXECUTOR. Konsol menampilkan bidang konfigurasi untuk jenis yang dipilih.

  6. Isi bidang konfigurasi khusus tipe. Untuk deskripsi setiap jenis fungsi dan bidangnya, lihatJenis fungsi dan komposisi.

  7. Pilih Buat fungsi.

Melampirkan fungsi ke konfigurasi pemutaran

Fungsi tidak berjalan sampai Anda melampirkannya ke konfigurasi pemutaran melalui pemetaan fungsi (tautan antara kait siklus hidup dan fungsi). Pemetaan fungsi menentukan hook siklus hidup mana yang memicu fungsi.

  1. Buka MediaTailor konsol.

  2. Di panel navigasi, pilih Konfigurasi.

  3. Pilih konfigurasi pemutaran yang ingin Anda perbarui.

  4. Di bagian Pemetaan fungsi, pilih Edit.

  5. Untuk setiap kait siklus hidup, pilih fungsi yang akan dilampirkan:

    • Pengait inisialisasi sesi — Pilih fungsi yang akan dijalankan sekali saat sesi dimulai.

    • Pengait permintaan iklan — Pilih fungsi yang akan dijalankan sebelum setiap permintaan ADS.

    • Hubungan respons posting iklan — Pilih fungsi yang akan dijalankan setelah setiap respons ADS diterima dan diurai.

    • Pengait penyisipan pra manifes — Pilih fungsi yang akan dijalankan pada kumpulan iklan akhir tepat sebelum iklan dimasukkan ke dalam manifes.

  6. Pilih Simpan.

Mengelola fungsi

Melihat fungsi

Arahkan ke Fungsi untuk melihat semua fungsi di akun Anda. Pilih nama fungsi untuk melihat konfigurasinya.

Memperbarui fungsi yang ada

Untuk memperbarui fungsi, navigasikan ke Fungsi, pilih fungsi, dan ubah konfigurasi. Pembaruan menggantikan seluruh definisi fungsi.

Tip

Simpan salinan konfigurasi fungsi Anda sebelum membuat perubahan. Tidak ada versi bawaan atau rollback untuk fungsi.

Menghapus fungsi

Melepaskan fungsi dari konfigurasi pemutaran

Sebelum Anda menghapus suatu fungsi, hapus fungsi tersebut dari semua konfigurasi pemutaran yang mereferensikannya.

  1. Buka MediaTailor konsol.

  2. Di panel navigasi, pilih Konfigurasi.

  3. Pilih konfigurasi pemutaran.

  4. Di bagian Pemetaan fungsi, pilih Edit.

  5. Hapus fungsi dari kait siklus hidup.

  6. Pilih Simpan.

Menghapus fungsi

Arahkan ke Fungsi, pilih fungsi, dan pilih H apus.

Aturan pemblokiran penghapusan

MediaTailor mencegah Anda menghapus fungsi yang masih digunakan.

Kondisi Hasil
Fungsi dilampirkan ke konfigurasi pemutaran melalui pemetaan fungsi Hapus diblokir. Lepaskan fungsi terlebih dahulu.
Fungsi direferensikan dalam SEQUENTIAL_EXECUTOR atau CONCURRENT_EXECUTOR Hapus diblokir. Hapus referensi dari fungsi induk terlebih dahulu.
Fungsi tidak direferensikan di mana pun Hapus berhasil.

Aturan validasi

MediaTailor memvalidasi fungsi Anda saat Anda membuat atau memperbaruinya. Pemeriksaan berikut dilakukan:

  • Sintaks ekspresi — Semua ekspresi harus JSONata yang valid.

  • Fungsi terbatas — Ekspresi tidak dapat memanggil fungsi JSONata terbatas. Lihat JSONatareferensi ekspresi daftar lengkapnya.

  • Awalan kunci keluaran — Semua kunci keluaran harus dimulai dengan awalan namespace yang dikenali. Untuk daftar awalan yang diterima, lihatPengait siklus hidup.

  • Referensi fungsi — Semua ID fungsi dalam FunctionList harus mereferensikan fungsi yang ada.

  • Referensi melingkar — Sebuah fungsi tidak dapat mereferensikan dirinya sendiri, secara langsung atau tidak langsung.

  • Kedalaman bersarang — A SEQUENTIAL_EXECUTOR dapat memanggil fungsi lain, tetapi fungsi-fungsi itu sendiri tidak dapat menjadi eksekutor.

Untuk nilai dan batas ukuran tertentu, lihatBatas.

Referensi API

Untuk mengelola fungsi secara terprogram, lihat Referensi AWS Elemental MediaTailor API.