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

Konstruksi tawaran dan templating

Halaman ini menjelaskan cara membuat MediaTailor permintaan tawaran OpenRTB dari template Anda, cara kerja interpolasi variabel, dan nilai apa yang ditetapkan secara otomatis. MediaTailor

Bidang konfigurasi

Saat Anda mengaktifkan Pengoptimalan Hasil pada konfigurasi pemutaran, Anda menyediakan empat bidang:

Bagaimana permintaan tawaran dibuat

Jika jeda iklan memiliki durasi yang tidak terisi tersisa, MediaTailor membuat permintaan tawaran dengan langkah-langkah berikut:

Template default konsol

Saat Anda mengaktifkan Pengoptimalan Hasil di MediaTailor konsol, templat yang telah diisi sebelumnya berikut disediakan sebagai titik awal. Anda harus menyesuaikan nilai untuk aplikasi Anda:

{
  "imp": [
    {
      "bidfloor": 5
    }
  ],
  "app": {
    "id": "{{player_params.app_id}}",
    "name": "{{player_params.app_name}}",
    "bundle": "{{player_params.bundle}}",
    "storeurl": "{{player_params.storeurl}}",
    "domain": "{{player_params.domain}}",
    "content": {
      "genre": "{{asset.genre}}",
      "contentrating": "{{asset.content_rating}}"
    }
  },
  "device": {
    "dnt": "{{player_params.dnt}}",
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}",
    "ifa": "{{player_params.device_ifa}}",
    "w": "{{player_params.device_width}}",
    "h": "{{player_params.device_height}}",
    "language": "{{player_params.language}}",
    "model": "{{player_params.model}}",
    "os": "{{player_params.os}}",
    "osv": "{{player_params.osv}}",
    "devicetype": "{{player_params.devicetype}}",
    "make": "{{player_params.make}}"
  },
  "user": {
    "consent": "{{player_params.consent}}"
  },
  "regs": {
    "gdpr": "{{player_params.gdpr}}",
    "us_privacy": "{{player_params.us_privacy}}",
    "gpp": "{{player_params.gpp_consent}}",
    "gpp_sid": "{{player_params.gpp_sid}}"
  }
}

Field-by-field penjelasan:

Interpolasi template (templating kumis)

Template ORTB Anda menggunakan sintaks templating Mustache untuk substitusi nilai dinamis. Placeholder menggunakan tanda kurung keriting ganda. {{ }}

Variabel template yang tersedia

Template ORTB Anda dapat menggunakan variabel dinamis yang sama yang tersedia di templat URL ADS. Ini termasuk variabel sesi (misalnya,{{session.user_agent}},{{session.client_ip}}), parameter pemain ({{player_params.*}}), metadata aset ({{asset.*}}), konteks tersedia ({{avail.*}}), dan data sinyal SCTE ({{scte.*}}).

Untuk daftar lengkap variabel yang tersedia dan deskripsinya, lihatMediaTailor variabel iklan dinamis untuk permintaan ADS. Untuk bagaimana nilai parameter MediaTailor URL-decodes pemain sebelum menggantinya ke dalam template, lihat Perilaku pengkodean dan decoding nanti di halaman ini.

Variabel yang paling umum digunakan dalam template ORTB adalah:

Cara melewati parameter pemain

Ada dua cara untuk melewati parameter pemain selama inisialisasi sesi.

Metode 1: Permintaan POST dengan badan JSON (disarankan)

POST https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
Content-Type: application/json

{
  "playerParams": {
    "app_id": "558775_example",
    "slot_id": "608109df-2378-4bc5-8da5-24bc355f01a4",
    "os": "Tizen",
    "make": "Samsung",
    "model": "Tizen TV",
    "language": "en",
    "us_privacy": "1YNY"
  }
}

Metode ini lebih disukai karena menghindari URL-encoding masalah dengan nilai kompleks seperti string agen pengguna.

Metode 2: Parameter kueri URL

GET https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
  ?playerParams.app_id=558775_example

Dengan metode ini, nilai harus ada URL-encoded. MediaTailor URL-decodes sebelum interpolasi.

Perilaku pengkodean dan decoding

MediaTailor melakukan satu tingkat decoding URL pada nilai parameter pemain sebelum menginterpolasinya ke dalam template. Ini berlaku terlepas dari bagaimana parameter dilewatkan (parameter kueri badan POST atau URL).

Contoh nilai yang didekodekan:

Poin kunci:

Apa yang terjadi ketika variabel hilang

Jika pemain tidak mengirim parameter yang direferensikan dalam template Anda (misalnya, {{player_params.app_name}} tetapi tidak ada app_name di parameter pemain), placeholder diselesaikan ke string kosong. ""

Damp ak: Jika string kosong berada di bidang wajib (sepertiapp.bundle), permintaan tawaran gagalBidRequestConfigurationError. Jika ada di bidang opsional, APS menerima nilai kosong yang dapat menyebabkan respons tanpa tawaran (HTTP 204).

Apa yang MediaTailor ditetapkan secara otomatis

Bidang berikut selalu diatur dengan MediaTailor menggunakan nilai dari konfigurasi konsol Anda dan konteks yang tersedia saat ini. Jika Anda menyertakan ini dalam template Anda, nilai-nilai Anda diganti:

Langkah selanjutnya