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 untuk membuat, melampirkan, memperbarui, dan menghapus Fungsi menggunakan konsol. MediaTailor Fungsi memungkinkan Anda menyesuaikan perilaku sesi dan permintaan iklan dengan menjalankan logika pada titik-titik utama selama pemutaran.

Menyiapkan fungsi

Membuat fungsi menggunakan konsol

  1. Buka MediaTailor konsol di https://console.aws.amazon.com/mediatailor/.

  2. Di panel navigasi, pilih Fungsi.

  3. Pilih Buat fungsi.

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

  5. Untuk jenis Fungsi, pilihCUSTOM_OUTPUT,HTTP_REQUEST, atauSEQUENTIAL_EXECUTOR. Konsol menampilkan bidang konfigurasi untuk jenis yang dipilih.

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

  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:

    • Hook inisialisasi sesi - Pilih fungsi untuk dijalankan sekali pada awal sesi.

    • Kait permintaan iklan — Pilih fungsi untuk dijalankan sebelum setiap permintaan ADS.

  6. Pilih Simpan.

Mengelola fungsi

Fungsi tampilan

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 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 Hapus.

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 a SEQUENTIAL_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 Referensi ekspresi Jsonata untuk daftar lengkapnya.

  • Awalan kunci keluaran - Semua kunci keluaran harus dimulai dengan awalan namespace yang dikenali. Untuk daftar awalan yang diterima, lihat. Pengait siklus hidup

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

  • Referensi melingkar — Fungsi tidak dapat mereferensikan dirinya sendiri, langsung atau tidak langsung.

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

Untuk nilai dan batas ukuran tertentu, lihatBatas.

Referensi API

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