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

# PRE\_ADS\_REQUEST
<a name="monetization-functions-hooks-pre-ads"></a>

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

MediaTailor menjalankan fungsi yang dipetakan menjadi `PRE_ADS_REQUEST` sekali per jeda iklan, segera sebelum mengirim permintaan ke ADS. Fungsi berjalan setiap kali peluang iklan ditemui selama pemrosesan manifes.

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

Semua bidang dari`PRE_SESSION_INITIALIZATION`, plus`avail.*`,`scte.*`, dan `adsRequest.*` (url, metode, header, badan). 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-ads-output"></a>


| Namespace | Jenis yang diterima | Bagaimana output digunakan | 
| --- | --- | --- | 
| player\_params.\* | String, angka, boolean | Mengganti parameter pemutar sesi untuk jeda iklan ini. Tersedia untuk URL permintaan ADS melalui[MediaTailor variabel iklan dinamis untuk permintaan ADS](variables.md). | 
| session.\* | String, angka, boolean | Mengganti variabel sesi untuk jeda iklan ini. Tersedia untuk URL permintaan ADS melalui substitusi variabel dinamis. | 
| avail.\* | String, angka, boolean | Mengganti variabel yang tersedia untuk jeda iklan ini. Tersedia untuk URL permintaan ADS melalui substitusi variabel dinamis. | 
| scte.\* | String, angka, boolean | Mengganti variabel SCTE untuk jeda iklan ini. Tersedia untuk URL permintaan ADS melalui substitusi variabel dinamis. | 
| adsRequest.\* | String | Mengganti permintaan ADS untuk jeda iklan ini saja. Bidang yang didukung: urlmethod,,headers.<name>,body. urlNilai diperlakukan sebagai template dan mendukung [MediaTailor variabel iklan dinamis untuk permintaan ADS](variables.md) setelah fungsi berjalan. Tidak bertahan. | 

**catatan**  
Semua output dari `PRE_ADS_REQUEST` hook adalah penggantian sementara — hanya berlaku untuk permintaan ADS jeda iklan saat ini dan tidak dipertahankan pada sesi.

**Contoh - menulis ulang permintaan ADS:**

```
{
    "Output": {
        "adsRequest.url": "{%'https://ads.example.com/v1/vast?sid=' & session.id & '&genre=' & player_params.genre%}",
        "adsRequest.headers.X-Custom-Token": "{%player_params.auth_token%}"
    }
}
```

Ini menggantikan URL ADS dan menambahkan header khusus untuk jeda iklan saat ini.

## Kasus penggunaan yang khas
<a name="monetization-functions-hooks-pre-ads-use-cases"></a>
+ Tulis ulang URL permintaan ADS untuk merutekan lalu lintas antar server iklan yang berbeda untuk A/B pengujian.
+ Tambahkan data pengayaan (segmen audiens, token identitas) ke URL atau header permintaan ADS.
+ Ubah parameter permintaan ADS secara kondisional berdasarkan data SCTE-35 sinyal atau indeks avail.

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

Jika fungsi yang dilampirkan `PRE_ADS_REQUEST` gagal karena alasan apa pun, MediaTailor membuang output fungsi dan melanjutkan seolah-olah tidak ada fungsi yang dilampirkan. Permintaan ADS dikirim menggunakan sesi asli dan parameter permintaan tanpa modifikasi.