View a markdown version of this page

Output kustom - AWS Elemental MediaTailor
Kapan harus digunakanBidang konfigurasiPerilaku runtimeContoh: pemis A/B ahan lalu lintas

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

Output kustom

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. Atur 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 JSONata ekspresi dalam bidang string. Nilai tanpa pembatas ini diperlakukan sebagai string statis. Misalnya, "{%session.id%}" mengevaluasi ekspresi, sementara "session.id" adalah teks literal.

Perilaku runtime

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

Jika ada ekspresi yang gagal untuk mengevaluasi, MediaTailor membuang seluruh output fungsi dan melanjutkan seolah-olah tidak ada fungsi yang dilampirkan. Fungsi ini tidak melakukan sebagian hasil.

Contoh: pemis A/B ahan 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, lihatContoh fungsi.