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

# PRE\_SESSION\_INISIALISASI
<a name="monetization-functions-hooks-pre-session"></a>

## Saat terbakar
<a name="monetization-functions-hooks-pre-session-when"></a>

MediaTailor menjalankan fungsi yang dipetakan menjadi `PRE_SESSION_INITIALIZATION` sekali, pada awal sesi pemutaran baru. Fungsi berjalan sebelum MediaTailor membangun respon manifes awal.

## Input
<a name="monetization-functions-hooks-pre-session-input"></a>

`session.*`, `player_params.*`, dan `event.*`. Untuk semua bidang yang tersedia, lihat[Referensi bidang masukan](monetization-functions-hooks.md#monetization-functions-hooks-input-ref).

## Namespace keluaran diizinkan
<a name="monetization-functions-hooks-pre-session-output"></a>


| Namespace | Jenis yang diterima | 
| --- | --- | 
| player\_params.\* | String, angka, boolean | 

Nilai yang `player_params.*` ditulis untuk dipertahankan pada sesi. Mereka tersedia:
+ Sebagai masukan pada kait `PRE_ADS_REQUEST` siklus hidup melalui `player_params.*`
+ Di URL permintaan ADS melalui [MediaTailor variabel iklan dinamis untuk permintaan ADS](variables.md) (misalnya,`[player_params.deviceType]`)
+ Untuk masa pakai sesi di semua jeda iklan

**catatan**  
Ukuran serial total dari semua tombol dan nilai `player_params` output tidak boleh melebihi 1.000 karakter. Jika total melebihi batas ini, output fungsi dibuang. Untuk informasi selengkapnya, lihat [Batas fungsi](monetization-functions-limits.md).

## Kasus penggunaan yang khas
<a name="monetization-functions-hooks-pre-session-use-cases"></a>
+ Ambil identitas atau data audiens dari layanan eksternal dan simpan dalam parameter pemutar untuk digunakan dalam permintaan ADS selanjutnya.
+ Klasifikasi jenis perangkat berdasarkan agen pengguna dan tulis klasifikasi ke parameter pemain.
+ Tetapkan nilai parameter pemutar default yang diandalkan oleh pemrosesan pemutusan iklan hilir.
+ Simpan nilai dalam parameter pemain yang disertakan dalam URL ADS melalui[MediaTailor variabel iklan dinamis untuk permintaan ADS](variables.md).

## Perilaku kegagalan
<a name="monetization-functions-hooks-pre-session-failure"></a>

Jika fungsi yang dilampirkan `PRE_SESSION_INITIALIZATION` gagal karena alasan apa pun, MediaTailor membuang output fungsi dan melanjutkan seolah-olah tidak ada fungsi yang dilampirkan. Sesi dimulai secara normal tanpa nilai parameter pemain fungsi.