View a markdown version of this page

KUSTOM_OUTPUT - AWS Elemental MediaTailor
Kapan harus digunakanBidang konfigurasiPerilaku runtimeContoh: pembagian A/B lalu lintas

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

KUSTOM_OUTPUT

Kapan harus digunakan

Gunakan CUSTOM_OUTPUT ketika logika fungsi Anda murni komputasi. Kasus penggunaan umum termasuk mengklasifikasikan perangkat berdasarkan string agen pengguna, memilih URL server keputusan iklan dengan logika A/B pengujian, dan memformat ulang parameter pemain sebelum mencapai server keputusan iklan.

CUSTOM_OUTPUTfungsi adalah tipe tercepat karena mereka mengevaluasi ekspresi dalam memori tanpa panggilan jaringan. Pilih jenis ini kapan pun Anda dapat mencapai tujuan Anda tanpa menghubungi layanan eksternal.

Bidang konfigurasi

Sebuah CUSTOM_OUTPUT fungsi memiliki dua bidang:

  • Runtime — Bahasa ekspresi. Setel ini keJSONATA.

  • Output — Peta pasangan kunci-nilai. Setiap kunci adalah nama pengikatan keluaran (sepertiplayer_params.device_type), dan setiap nilai adalah ekspresi yang MediaTailor mengevaluasi saat runtime.

catatan

Gunakan {%...%} untuk membungkus ekspresi Jsonata di bidang string. Nilai tanpa pembatas ini diperlakukan sebagai string statis. Misalnya, "{%session.id%}" mengevaluasi ekspresi, sedangkan "session.id" adalah teks literal.

Perilaku runtime

Ketika MediaTailor mengeksekusi CUSTOM_OUTPUT fungsi, itu mengevaluasi setiap ekspresi di blok output terhadap keadaan sesi saat ini. Semua ekspresi melihat snapshot input yang sama. Hasil yang dievaluasi menjadi output fungsi.

Jika ekspresi apa pun gagal dievaluasi, MediaTailor buang seluruh output fungsi dan lanjutkan seolah-olah tidak ada fungsi yang dilampirkan. Fungsi ini tidak melakukan sebagian hasil.

Contoh: pembagian A/B lalu lintas

Fungsi berikut secara acak menetapkan setiap jeda iklan ke salah satu dari dua URL server keputusan iklan. Ini dirancang untuk kait PRE_ADS_REQUEST siklus hidup.

{
    "FunctionId": "abTestAdsUrl",
    "FunctionType": "CUSTOM_OUTPUT",
    "CustomOutputConfiguration": {
        "Runtime": "JSONATA",
        "Output": {
            "adsRequest.url": "{%$random() < 0.5 ? 'https://ads.example.com/v1' : 'https://ads.example.com/v2'%}"
        }
    }
}

Untuk panduan lengkap dari contoh ini, lihat. Contoh fungsi