

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

# Panduan memulai cepat Pengoptimalan Hasil
<a name="yield-optimization-quickstart"></a>

Panduan ini memandu Anda mengaktifkan Pengoptimalan Hasil pada konfigurasi pemutaran dan memverifikasi bahwa itu berfungsi.

**Tujuan: ** Pada akhir panduan ini, Anda akan memiliki konfigurasi pemutaran yang secara otomatis mengisi inventaris iklan yang tidak terisi dengan iklan terprogram dari APS.

## Prasyarat
<a name="yield-optimization-quickstart-prereqs"></a>
+ Konfigurasi MediaTailor pemutaran yang ada dengan sumber konten langsung.
+ ID Penerbit APS. Lihat [Integrasi dengan APS](yield-optimization-integrating-aps.md) apakah Anda tidak memilikinya.

## Langkah 1: Aktifkan Pengoptimalan Hasil di konsol
<a name="yield-optimization-quickstart-step1"></a>

1. Buka [konsol MediaTailor](https://console.aws.amazon.com/mediatailor/home).

1. Di panel navigasi kiri, pilih ** Konfigurasi**.

1. Pilih konfigurasi pemutaran yang ingin Anda perbarui.

1. Pilih **Edit**.

1. Perluas ** bagian ** Pengaturan Pengoptimalan Hasil (ditandai dengan ** lencana ** Baru saat peluncuran). Deskripsi bagian tersebut berbunyi: “Konfigurasikan setelan Pengoptimalan Hasil termasuk ID penayang, batas durasi iklan, dan penargetan regional.”

1. Setel dropdown pengaktifan ke Diaktifkan. ** **

1. Isi kolom berikut:
   + **ID Penerbit APS**: ID Penerbit APS yang terkait dengan akun Penerbit Anda (misalnya,`8caf35b3-402b-4d75-bab2-f2aef63a66d3`). Lihat [Integrasi dengan APS](yield-optimization-integrating-aps.md) cara mendapatkannya.
   + **Durasi Minimum Tidak Terisi**: Durasi minimum yang belum terisi dalam hitungan detik yang akan coba diisi oleh Pengoptimalan Hasil. Setel ini ke ** 15 ** atau lebih tinggi. Nilai di bawah 15 detik tidak akan menampilkan iklan karena iklan APS biasanya 15 detik atau lebih.
   + **Wilayah Iklan Amazon**: Wilayah Iklan Amazon untuk mengarahkan permintaan tawaran. Pilih salah satu`Americas`,`Europe`, atau `Asia Pacific` berdasarkan audiens utama Anda. Ini memetakan ke `Region` bidang dalam model `YieldOptimizationConfiguration` API, dan nama wilayah sesuai dengan wilayah APS yang dijelaskan di[Integrasi dengan APS](yield-optimization-integrating-aps.md).
   + **Konfigurasi Template OpenRTB**: Template JSON Anda. Lihat [Contoh templat](yield-optimization-examples.md) untuk titik awal. Konsol memvalidasi sintaks JSON dan menampilkan kesalahan dan peringatan sebaris. Template default sudah diisi sebelumnya dengan template starter konsol. Lihat [Konstruksi tawaran dan templating](yield-optimization-bid-construction.md).

1. Pilih **Simpan**.

## Langkah 2: Konfigurasikan template OpenRTB
<a name="yield-optimization-quickstart-step2"></a>

Konsol menyediakan editor JSON untuk template OpenRTB. Minimal, template Anda harus mencakup:

```
{
  "app": {
    "bundle": "your.app.bundle.id",
    "storeurl": "https://your-app-store-url",
    "content": {}
  },
  "device": {
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}"
  },
  "imp": [
    {
      "video": {
        "mimes": ["video/mp4"],
        "protocols": [2, 3, 5, 6],
        "ext": {
          "slotId": "your-aps-slot-id"
        }
      },
      "bidfloor": 1.0
    }
  ]
}
```

Konsol akan memperingatkan Anda jika bidang wajib tidak ada.

## Langkah 3: Mulai sesi dan verifikasi
<a name="yield-optimization-quickstart-step3"></a>

1. Mulai sesi pemutaran yang mencakup parameter pemain Anda (agen pengguna, alamat IP, dan sebagainya).

1. Tunggu jeda iklan dengan durasi yang tidak terisi.

1. Periksa CloudWatch metrik untuk `YieldOptimization.BidRequest` dan`YieldOptimization.AdsInserted`.

Jika `BidRequest` memancarkan tetapi `AdsInserted` 0, periksa `RAW_BID_REQUEST` acara di `ads_interaction_log` untuk memverifikasi template Anda menghasilkan permintaan tawaran yang valid.

## Langkah 2 (alternatif): Konfigurasikan menggunakan API
<a name="yield-optimization-quickstart-step2-api"></a>

Gunakan `PutPlaybackConfiguration` API dengan `YieldOptimizationConfiguration` parameter:

```
aws mediatailor put-playback-configuration \
  --name "MyStreamingService" \
  --ad-decision-server-url "https://ads.example.com/vast" \
  --video-content-source-url "https://origin.example.com/hls/" \
  --yield-optimization-configuration '{
    "MinimumUnfilledDuration": 15,
    "PublisherId": "your-aps-publisher-id",
    "Region": "AMERICAS",
    "OpenRtbTemplate": "{\"app\":{\"bundle\":\"your.app.bundle\",\"storeurl\":\"https://store-url\",\"content\":{}},\"device\":{\"ua\":\"{{session.user_agent}}\",\"ip\":\"{{session.client_ip}}\"},\"imp\":[{\"video\":{\"mimes\":[\"video/mp4\"],\"protocols\":[2,3,5,6],\"ext\":{\"slotId\":\"your-slot-id\"}},\"bidfloor\":1.0}]}"
  }'
```

## Langkah selanjutnya
<a name="yield-optimization-quickstart-next-steps"></a>
+ Untuk mendaftar dengan APS dan mendapatkan ID Penerbit Anda, lihat[Integrasi dengan APS](yield-optimization-integrating-aps.md).
+ Untuk memahami cara MediaTailor memutuskan kapan harus membuat permintaan tawaran, lihat[Cara kerja Pengoptimalan Hasil](yield-optimization-how-it-works.md).
+ Untuk melihat contoh template lengkap, lihat[Contoh templat](yield-optimization-examples.md).