Pod Penyisipan Iklan Dinamis yang menayangkan API live

Dynamic Ad Insertion API memungkinkan Anda meminta dan melacak livestream DAI.

Layanan: dai.google.com

Semua URI relatif terhadap https://dai.google.com.

Metode: streaming

Metode
stream POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

Mendaftarkan sesi live stream penayangan pod DAI DAI.

Permintaan HTTP

POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

Parameter jalur

Parameter
network_code string

Kode jaringan Google Ad Manager penayang.

custom_asset_key string

ID kustom yang terkait dengan peristiwa ini di Google Ad Manager.

Isi permintaan

Isi permintaan berjenis application/x-www-form-urlencoded dan berisi parameter berikut:

Parameter
Parameter Penargetan DFP Opsional Parameter penargetan tambahan.
Mengganti Parameter Streaming Opsional Mengganti nilai default parameter pembuatan streaming.
Autentikasi HMAC Opsional Lakukan autentikasi menggunakan token berbasis HMAC.

Isi respons

Jika berhasil, isi respons akan memuat objek Stream baru.

Pengukuran Terbuka

DAI API berisi informasi untuk verifikasi Pengukuran Terbuka di kolom Verifications. Kolom ini berisi satu atau beberapa elemen Verification yang mencantumkan resource dan metadata yang diperlukan untuk mengeksekusi kode pengukuran pihak ketiga guna memverifikasi pemutaran materi iklan. Hanya JavaScriptResource yang didukung. Untuk mengetahui informasi selengkapnya, lihat IAB Tech Lab dan spesifikasi VAST 4.1.

Metode: segmen pod

Metode
pod segment GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

Membuat streaming DAI untuk ID acara yang diberikan.

Permintaan HTTP

GET https://dai.google.com/linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

Parameter jalur

Parameter
network_code string

Kode jaringan Google Ad Manager penayang.

custom_asset_key string

ID kustom yang terkait dengan peristiwa ini di Google Ad Manager.

pod_identifier

Format berikut didukung:

pod/{integer}

ID numerik untuk jeda iklan saat ini. ID pod iklan ditetapkan secara inkremental untuk setiap peristiwa jeda iklan, dimulai dari 1.

ad_break_id/{string}

ID string untuk jeda iklan saat ini. ID jeda iklan yang diberikan penayang tidak memiliki batasan yang sama dengan ID pod iklan. ID Jeda Iklan yang tidak diketahui yang diberikan ke endpoint tersebut akan membuat Jeda Iklan baru untuk acara livestream.

profile_name string

name dari profil encoding DAI Google Ad Manager yang diminta. Profil encoding harus berupa salah satu profil encoding yang dikonfigurasi untuk acara yang dipilih.

segment_number integer

Indeks segmen yang diminta dalam pod iklan saat ini, dimulai dari nol.
segment_format string

Ekstensi file yang terkait dengan format segmen yang diminta. Ekstensi yang diterima adalah: ts, mp4, vtt, aac, ac3, atau eac3.

Parameter kueri

Parameter
stream_id wajib ada string

ID streaming untuk sesi pengguna saat ini. Nilai ini ditampilkan oleh permintaan yang berhasil ke endpoint stream.
sd required1 integer

Durasi segmen yang diminta, dalam milidetik.
so opsional

Offset segmen yang diminta dalam pod iklan, dalam milidetik. Jika Anda menghilangkan parameter so, parameter tersebut akan dihitung dengan mengalikan durasi segmen dengan nomor segmen.
pd wajib2 integer

Durasi pod iklan, dalam milidetik.
auth-token wajib ada string

Token HMAC yang ditandatangani dan dienkode URL untuk pod iklan saat ini.
last opsional boolean

Menunjukkan segmen terakhir dalam jeda iklan. Hapus parameter ini untuk semua segmen lainnya.
scte35 opsional string

Sinyal SCTE-35 berenkode Base64 untuk jeda iklan ini.
cust_params opsional string

Kumpulan pasangan nilai kunci, yang digunakan untuk penargetan kampanye Ad Manager. Pasangan ini harus direpresentasikan sebagai string kueri berenkode URL.

Contoh:
Parameter
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Catatan kaki

  1. sd tidak diperlukan untuk segmen inisialisasi. ↩
  2. pd tidak diperlukan untuk peristiwa dengan jeda iklan tanpa durasi yang diaktifkan. ↩

Contoh

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/ad_break_id/adbreak-2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

Isi respons

Jika berhasil, isi respons akan berupa segmen streaming yang dapat diputar dan cocok dengan format dan parameter yang ditentukan dalam permintaan.

Metode: Manifes pod HLS

Mengambil manifes pod iklan HLS dari livestream yang siap dimuat dan diputar oleh pemutar video klien.

Metode
GET GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/{pod_identifier}.m3u8;

API untuk mengambil playlist multivarian HLS untuk pod iklan.

Permintaan HTTP

GET https://dai.google.com/linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}.m3u8?stream_id={stream_id}&pd={pod_duration}

Parameter jalur

Parameter
network_code string

Kode jaringan Google Ad Manager penayang.
custom_asset_key string

ID kustom yang terkait dengan peristiwa ini di Google Ad Manager
pod_identifier

Format berikut didukung:

pod/{integer}

ID numerik untuk jeda iklan saat ini. ID pod iklan ditetapkan secara inkremental untuk setiap peristiwa jeda iklan, dimulai dari 1.

ad_break_id/{string}

ID string untuk jeda iklan saat ini. ID jeda iklan yang diberikan penayang tidak memiliki batasan yang sama dengan ID pod iklan. ID Jeda Iklan yang tidak diketahui yang diberikan ke endpoint tersebut akan membuat Jeda Iklan baru untuk acara livestream.

Parameter kueri

Parameter
stream_id Wajib string

ID streaming untuk sesi pengguna saat ini. Nilai ini ditampilkan oleh permintaan yang berhasil ke endpoint stream.
pd Wajib integer

Durasi pod iklan, dalam milidetik.
scte35 opsional string

Sinyal SCTE-35 berenkode Base64 untuk jeda iklan ini.
cust_params opsional string

Kumpulan pasangan nilai kunci, yang digunakan untuk penargetan kampanye Ad Manager. Pasangan ini harus direpresentasikan sebagai string kueri berenkode URL.

Contoh:
Parameter
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Isi respons

Jika berhasil, isi respons adalah playlist multivarian HLS.

Metode: Manifes pod DASH

Mengambil manifes pod iklan MPEG-DASH dari livestream yang siap dimuat dan diputar oleh pemutar video klien.

Metode
GET GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/pod/{pod_id}/manifest.mpd

API untuk mengambil playlist mpd MPEG-DASH untuk pod iklan.

Permintaan HTTP

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/stream/{stream_id}/pod/{pod_id}/manifest.mpd?pd={pod_duration}

Parameter jalur

Parameter
network_code string

Kode jaringan Google Ad Manager penayang.
custom_asset_key string

ID kustom yang terkait dengan peristiwa ini di Google Ad Manager
stream_id string

ID streaming untuk sesi pengguna saat ini. Nilai ini ditampilkan oleh permintaan yang berhasil ke endpoint stream.
pod_id integer

ID numerik untuk jeda iklan saat ini. ID pod iklan ditetapkan secara inkremental untuk setiap peristiwa jeda iklan, dimulai dari 1.

Parameter kueri

Parameter
pd Wajib integer

Durasi pod iklan, dalam milidetik.
scte35 opsional string

Sinyal SCTE-35 berenkode Base64 untuk jeda iklan ini.
cust_params opsional string

Kumpulan pasangan nilai kunci, yang digunakan untuk penargetan kampanye Ad Manager. Pasangan ini harus direpresentasikan sebagai string kueri berenkode URL.

Contoh:
Parameter
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Isi respons

Jika berhasil, isi respons adalah playlist mpd MPEG-DASH.

Metode: Template periode pod DASH

Metode
pods GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

Meminta template periode DASH dari Google Ad Manager. Template ini berisi makro yang harus Anda isi dengan parameter streaming. Setelah makro ini diisi, template akan menjadi periode jeda iklan Anda, dan dapat digabungkan ke manifes DASH Anda.

Permintaan HTTP

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

Parameter jalur

Parameter
network_code string

Kode jaringan Google Ad Manager penayang.

custom_asset_key string

ID kustom yang terkait dengan peristiwa ini di Google Ad Manager.

Parameter kueri

Parameter
stream_id wajib ada string

ID streaming untuk sesi pengguna saat ini. Nilai ini ditampilkan oleh permintaan yang berhasil ke endpoint stream.

Isi respons

Jika berhasil, isi respons akan memuat objek PodTemplateResponse baru.

Metode: Metadata pengaturan waktu pod iklan

Metode
ad pod timing metadata GET /linear/pods/v1/adv/network/{network_code}/custom_asset/{custom_asset_key}/pod.json

Mengambil metadata pengaturan waktu pod iklan.

Permintaan HTTP

GET https://dai.google.com/linear/pods/v1/adv/network/{network_code}/custom_asset/{custom_asset_key}/pod.json

Parameter jalur

Parameter
network_code string

Kode jaringan Google Ad Manager penayang.

custom_asset_key string

ID kustom yang terkait dengan livestream ini di Google Ad Manager.

Parameter kueri

Parameter
stream_id Wajib string

ID streaming Ad Manager dari aplikasi pemutar video klien.
ad_break_id wajib ada string

ID jeda iklan berikutnya yang akan datang.

ID jeda iklan disediakan oleh server Stitching atau VTP, dan harus cocok di seluruh notifikasi jeda iklan awal, permintaan metadata pengaturan waktu pod iklan, dan permintaan pengalihan segmen untuk jeda iklan yang sama.

Batasan berikut berlaku untuk ID jeda iklan kustom:

  • Harus terdiri dari 1 hingga 63 karakter
  • Hanya boleh berisi huruf kecil, angka, dan tanda hubung.
  • ID jeda iklan preroll dicadangkan untuk mengambil pod iklan pre-roll. ID ini tidak dapat digunakan untuk mengidentifikasi pod iklan lainnya.
auth-token wajib ada string

auth-token terdiri dari token HMAC dengan parameter berikut:

  • ad_break_id
  • custom_asset_key
  • exp
  • network_code
  • custom_params
  • pd
  • scte35
timeout opsional integer

Jumlah milidetik yang dapat diblokir DAI untuk menunggu pengambilan keputusan iklan. Gunakan parameter ini pada permintaan yang harus menampilkan iklan yang diisi pada permintaan pertama, seperti jeda iklan pra-putar.

Jika waktu tunggu terlampaui, permintaan akan menampilkan status tertunda.

Jika disertakan, nilai waktu tunggu harus antara 1000 dan 15000 milidetik. Jika tidak disertakan, respons tidak ditunda untuk menunggu pengambilan keputusan iklan.
final opsional boolean

Setel ke true untuk menunjukkan kepada DAI bahwa ini adalah permintaan terakhir yang bersedia dilakukan VTP untuk pod iklan ini. Jika keputusan iklan belum tersedia (dengan waktu tunggu opsional), DAI akan menampilkan layar secara permanen untuk permintaan ini.

Default-nya adalah false.

Parameter pengambilan keputusan iklan
pd opsional integer

Durasi jeda iklan (dalam milidetik). Juga disebut sebagai durasi pod iklan.

Jika EABN digunakan, nilai pd harus cocok dengan durasi yang diberikan dalam notifikasi jeda iklan Anda. Jika durasi tidak cocok, nilai EABN akan diberi prioritas.

cust_params opsional string

Parameter kustom untuk penargetan jeda iklan, seperti yang dijelaskan di Pusat Bantuan Ad Manager.
scte35 opsional string

Sinyal SCTE-35 berenkode base64.

Jika sinyal tidak valid, pesan akan dikirim di header HTTP X-Ad-Manager-Dai-Warning respons dan permintaan akan dikirim tanpa nilai scte35 yang tidak valid.

Isi respons

Jika berhasil, isi respons akan memuat objek AdPodTimingMetadataResponse baru.

Metode: verifikasi media

Setelah menemukan ID media iklan selama pemutaran, segera buat permintaan menggunakan media_verification_url yang diperoleh dari endpoint stream di atas. Permintaan ini tidak diperlukan untuk streaming beacon sisi server, tempat server memulai verifikasi media.

Permintaan ke endpoint media verification bersifat idempoten.

Metode
media verification GET /{media_verification_url}/{ad_media_id}

Memberi tahu API tentang peristiwa verifikasi media.

Permintaan HTTP

GET https://{media-verification-url}/{ad-media-id}

Isi respons

media verification menampilkan respons berikut:

  • HTTP/1.1 204 No Content jika verifikasi media berhasil dan semua ping telah dikirim.
  • HTTP/1.1 404 Not Found jika permintaan tidak dapat memverifikasi media karena format URL yang salah atau masa berlaku habis.
  • HTTP/1.1 404 Not Found jika permintaan verifikasi sebelumnya untuk ID ini berhasil.
  • HTTP/1.1 409 Conflict jika permintaan lain sudah mengirimkan ping pada saat ini.

ID media iklan

ID media iklan akan dienkode dalam trek metadata terpisah — metadata berwaktu untuk aliran transport HLS, atau emsg untuk file mp4. ID media iklan akan selalu dimulai dengan string google_.

Seluruh konten teks entri metadata harus ditambahkan ke URL verifikasi iklan sebelum membuat setiap permintaan verifikasi iklan.

Metode: metadata

Endpoint metadata di metadata_url menampilkan informasi yang digunakan untuk membuat UI iklan. Endpoint metadata tidak tersedia untuk streaming beacon sisi server, di mana server bertanggung jawab untuk memulai verifikasi media iklan.

Metode
metadata GET /{metadata_url}/{ad-media-id}

GET /{metadata_url}

Mengambil informasi metadata iklan.

Permintaan HTTP

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

Isi respons

Jika berhasil, respons akan menampilkan instance PodMetadata.

Mengurai Metadata

Metadata memiliki tiga bagian terpisah: tags, ads, dan breaks iklan. Titik masuk ke data adalah bagian tags. Dari sana, lakukan iterasi pada tag dan temukan entri pertama yang namanya merupakan awalan untuk ID media iklan yang ditemukan di streaming video. Misalnya, Anda mungkin memiliki ID media iklan yang terlihat seperti:

google_1234567890

Kemudian, Anda akan menemukan objek tag bernama google_12345. Dalam hal ini, ID tersebut cocok dengan ID media iklan Anda. Setelah menemukan objek awalan media iklan yang benar, Anda dapat mencari ID iklan, ID jeda iklan, dan jenis peristiwa. ID iklan kemudian digunakan untuk mengindeks objek ads dan ID jeda iklan digunakan untuk mengindeks objek breaks.

Data respons

Streaming

Stream digunakan untuk merender daftar resource untuk stream yang baru dibuat dalam format JSON.
Representasi JSON
{
  "stream_id": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "heartbeat_url": string,
  "polling_frequency": number,
  "pod_manifest_url": string,
  "manifest_format": string,
}
Kolom
stream_id string

ID streaming GAM.
media_verification_url string

URL verifikasi media yang digunakan sebagai endpoint dasar untuk melacak peristiwa pemutaran.
metadata_url string

URL Metadata yang digunakan untuk melakukan polling informasi berkala tentang peristiwa iklan streaming mendatang.
session_update_url string

URL update sesi yang digunakan untuk memperbarui parameter penargetan untuk streaming ini. Nilai asli untuk parameter penargetan diambil selama permintaan pembuatan streaming awal.
heartbeat_url string

URL detak jantung, yang digunakan untuk menjaga agar streaming beaconing sisi server tetap aktif, URL ini harus di-ping setiap {PollingFrequency} detik. Diisi untuk streaming beacon sisi server.
polling_frequency number

Frekuensi polling, dalam detik, saat meminta metadata_url atau heartbeat_url.
pod_manifest_url string

Template URL manifes pod digunakan untuk membuat URL guna mengambil manifes pod streaming, yang sesuai dengan URL playlist multivarian di HLS atau MPD di DASH. Diisi untuk acara Livestream jenis Penyisipan Iklan Dinamis POD_SERVING_MANIFEST. https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType
manifest_format string

Format manifes adalah format manifes yang diambil dari pod_manifest_url, baik dash maupun hls.

PodMetadata

PodMetadata berisi informasi metadata tentang iklan, jeda iklan, dan tag ID media.
Representasi JSON
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}
Kolom
tags map[string, object(TagSegment)]

Peta segmen tag yang diindeks berdasarkan awalan tag.
ads map[string, object(Ad)]

Peta iklan yang diindeks menurut ID iklan.
ad_breaks map[string, object(AdBreak)]

Peta jeda iklan yang diindeks menurut ID jeda iklan.

TagSegment

TagSegment berisi referensi ke iklan, jeda iklan, dan jenis peristiwanya. TagSegment dengan type="progress" tidak boleh di-ping ke endpoint verifikasi media iklan.
Representasi JSON
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
Kolom
ad string

ID iklan tag ini.
ad_break_id string

ID jeda iklan tag ini.
type string

Jenis peristiwa tag ini.

AdBreak

AdBreak menjelaskan satu jeda iklan dalam streaming. Objek ini berisi durasi, jenis (mid/pre/post), dan jumlah iklan.
Representasi JSON
{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}
Kolom
type string

Jenis jeda yang valid adalah: pre, mid, dan post.
duration number

Total durasi iklan untuk jeda iklan ini, dalam detik.
expected_duration number

Perkiraan durasi jeda iklan (dalam detik), termasuk semua iklan dan slate.
ads number

Jumlah iklan dalam jeda iklan.
Iklan menjelaskan iklan dalam aliran.
Representasi JSON
{
  "ad_break_id": string,
  "position": number,
  "duration": number,
  "title": string,
  "description": string,
  "advertiser": string,
  "ad_system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
  "clickthrough_url": string,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}
Kolom
ad_break_id string

ID jeda iklan iklan ini.
position number

Posisi iklan ini di jeda iklan, dimulai dari 1.
duration number

Durasi iklan, dalam detik.
title string

Judul iklan opsional.
description string

Deskripsi iklan opsional.
advertiser string

ID pengiklan opsional.
ad_system string

Sistem iklan opsional.
ad_id string

ID iklan opsional.
creative_id string

ID materi iklan opsional.
creative_ad_id string

ID iklan materi iklan opsional.
deal_id string

ID transaksi opsional.
clickthrough_url string

URL klik-tayang opsional.
click_tracking_urls string

URL pelacakan klik opsional.
verifications [object(Verification)]

Entri verifikasi Pengukuran Terbuka opsional yang mencantumkan resource dan metadata yang diperlukan untuk menjalankan kode pengukuran pihak ketiga guna memverifikasi pemutaran materi iklan.
slate boolean

Bool opsional yang menunjukkan bahwa entri saat ini adalah slate.
icons [object(Icon)]

Daftar ikon, dihilangkan jika kosong.
wrappers [object(Wrapper)]

Daftar Wrapper, dihilangkan jika kosong.
universal_ad_id object(UniversalAdID)

ID iklan universal opsional.
extensions string

Daftar opsional semua node <Extension> di VAST.
companions [object(Companion)]

Materi iklan pengiring opsional yang dapat ditampilkan bersama iklan ini.
interactive_file object(InteractiveFile)

Materi iklan interaktif opsional (SIMID) yang harus ditampilkan selama pemutaran iklan.

PodTemplateResponse

PodTemplateResponse merepresentasikan payload JSON yang ditampilkan ke VTP untuk penyambungan pod.
Representasi JSON
{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}
Kolom
dash_period_template string

DashPeriodTemplate adalah template xml untuk periode yang akan diisi dengan data yang sesuai sebelum digabungkan.
segment_duration_ms int64

SegmentDurationMS adalah durasi segmen periode dalam milidetik.

AdpodTimingMetadataResponse

AdpodTimingMetadataResponse berisi informasi tentang Pod Iklan dan cara membuat URL segmen untuknya.
Representasi JSON
{
  "status": string,
  "ads": [object(AdRendering)],
  "slate": object(SlateRendering),
  "dash_representations": map[string, object(DASHRepresentation)],
  "dash_adaptation_sets": map[string, object(DASHAdaptationSet)],
}
Kolom
status string

Status keputusan untuk pod iklan.
ads [object(AdRendering)]

Array objek Iklan yang menjelaskan cara merender URL segmen iklan, yang diindeks mulai dari 0.
slate object(SlateRendering)

Slate yang menjelaskan cara merender URL segmen slate.
dash_representations map[string, object(DASHRepresentation)]

Daftar Representasi DASH untuk pod iklan yang akan dirender dalam manifes DASH.
dash_adaptation_sets map[string, object(DASHAdaptationSet)]

Daftar Set Adaptasi DASH untuk pod iklan yang akan dirender dalam manifes DASH.

AdRendering

AdRendering menjelaskan cara merender iklan yang telah diputuskan.
Representasi JSON
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
Kolom
duration_ms number

Durasi iklan, dalam milidetik (int).
variants map[string, object(VariantRendering)]

Dictionary objek Varian (lihat di bawah), yang diindeks menurut ID varian/profil, seperti yang dikonfigurasi dari UI.

SlateRendering

SlateRendering menjelaskan cara merender konten slate.
Representasi JSON
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
Kolom
duration_ms number

Durasi layar penuh, dalam milidetik (int).
variants map[string, object(VariantRendering)]

Dictionary objek Varian, diindeks menurut ID varian/profil. Durasi slide harus diulang hingga panjang slide yang diperlukan tercapai, menyisipkan jeda HLS di antara iterasi, atau mengulang periode baru untuk MPEG-DASH.

VariantRendering

VariantRendering menjelaskan satu varian/profil dalam iklan/slate.
Representasi JSON
{
  "segment_extension": string,
  "segment_durations": object(SegmentDurations),
}
Kolom
segment_extension string

String, salah satu dari: ts, mp4, aac, ac3, ec3, m4a, m4v. Bagian ekstensi nama file dari URL segmen.
segment_durations object(SegmentDurations)

Objek SegmentDurations. Durasi setiap segmen dapat diterjemahkan ke dalam URL segmen.

SegmentDurations

SegmentDurations menjelaskan durasi urutan segmen, dalam satuan waktu yang ditentukan.
Representasi JSON
{
  "timescale": number,
  "values": [],
}
Kolom
timescale number

Timescale adalah jumlah unit per detik (int) Diharapkan: 1000 untuk HLS (milidetik) 90000 untuk video DASH (PTS) Frekuensi sampling audio untuk audio DASH.
values number

Array durasi segmen int, dalam unit skala waktu.

DASHRepresentation

DASHRepresentation menjelaskan node Representasi yang akan dirender dalam manifes DASH.
Representasi JSON
{
  "codecs": string,
  "bandwidth": number,
  "width": number,
  "height": number,
  "frame_rate": string,
  "audio_sampling_rate": number,
  "audio_channel_config": object(SchemeIDURIAndValue),
}
Kolom
codecs string

Codec representasi.
bandwidth number

Bandwidth representasi.
width number

Lebar representasi.
height number

Tinggi representasi.
frame_rate string

Kecepatan frame representasi.
audio_sampling_rate number

Frekuensi sampling audio representasi.
audio_channel_config object(SchemeIDURIAndValue)

Konfigurasi channel audio representasi.

DASHAdaptationSet

DASHAdaptationSet menjelaskan node AdaptationSet yang akan dirender dalam manifes DASH.
Representasi JSON
{
  "content_type": string,
  "mime_type": string,
  "role": object(SchemeIDURIAndValue),
  "inband_event_stream": object(SchemeIDURIAndValue),
  "min_frame_rate": string,
  "max_frame_rate": string,
  "scan_type": string,
  "start_with_sap": string,
  "segment_alignment": boolean,
  "representations": [],
}
Kolom
content_type string

Jenis konten set adaptasi.
mime_type string

Jenis MIME set adaptasi.
role object(SchemeIDURIAndValue)

Peran kumpulan adaptasi.
inband_event_stream object(SchemeIDURIAndValue)

Stream peristiwa dalam band dari set adaptasi.
min_frame_rate string

Kecepatan frame minimum set adaptasi.
max_frame_rate string

Kecepatan frame maksimum set adaptasi.
scan_type string

Jenis pemindaian set adaptasi.
start_with_sap string

Mulai dengan SAP dari set adaptasi.
segment_alignment boolean

Perataan segmen kumpulan adaptasi.
representations string

Representasi kumpulan adaptasi.

SchemeIDURIAndValue

SchemeIDURIAndValue adalah pasangan ID skema dan nilainya.
Representasi JSON
{
  "scheme_id_uri": string,
  "value": string,
}
Kolom
scheme_id_uri string

URI ID Skema nilai.
value string

Nilai URI ID skema.

Ikon

Ikon berisi informasi tentang Ikon VAST.
Representasi JSON
{
  "click_data": object(ClickData),
  "creative_type": string,
  "click_fallback_images": [object(FallbackImage)],
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "x_position": string,
  "y_position": string,
  "program": string,
  "alt_text": string,
}
Kolom
click_data object(ClickData)

creative_type string

click_fallback_images [object(FallbackImage)]

height int32

width int32

resource string

type string

x_position string

y_position string

program string

alt_text string

ClickData

ClickData berisi informasi tentang rasio klik-tayang ikon.
Representasi JSON
{
  "url": string,
}
Kolom
url string

FallbackImage

FallbackImage berisi informasi tentang gambar penggantian VAST.
Representasi JSON
{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}
Kolom
creative_type string

height int32

width int32

resource string

alt_text string

Wrapper

Wrapper berisi informasi tentang iklan wrapper. Tidak menyertakan ID Kesepakatan jika tidak ada.
Representasi JSON
{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}
Kolom
system string

ID sistem iklan.
ad_id string

ID Iklan yang digunakan untuk iklan wrapper.
creative_id string

ID materi iklan yang digunakan untuk iklan wrapper.
creative_ad_id string

ID Iklan Materi Iklan yang digunakan untuk iklan wrapper.
deal_id string

ID transaksi opsional untuk iklan wrapper.

Verifikasi

Verifikasi berisi informasi untuk Pengukuran Terbuka, yang memfasilitasi pengukuran visibilitas dan verifikasi pihak ketiga. Saat ini, hanya resource JavaScript yang didukung. Lihat https://iabtechlab.com/standards/open-measurement-sdk/
Representasi JSON
{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}
Kolom
vendor string

Vendor verifikasi.
java_script_resources [object(JavaScriptResource)]

Daftar resource JavaScript untuk verifikasi.
tracking_events [object(TrackingEvent)]

Daftar peristiwa pelacakan untuk verifikasi.
parameters string

String opaque yang diteruskan ke kode verifikasi bootstrap.

JavaScriptResource

JavaScriptResource berisi informasi untuk verifikasi melalui JavaScript.
Representasi JSON
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
Kolom
script_url string

URI ke payload JavaScript.
api_framework string

APIFramework adalah nama framework video yang menjalankan kode verifikasi.
browser_optional boolean

Apakah skrip ini dapat dijalankan di luar browser.

TrackingEvent

TrackingEvent berisi URL yang harus di-ping oleh klien dalam situasi tertentu.
Representasi JSON
{
  "event": string,
  "uri": string,
}
Kolom
event string

Jenis peristiwa pelacakan.
uri string

Peristiwa pelacakan yang akan di-ping.

UniversalAdID

UniversalAdID digunakan untuk memberikan ID materi iklan unik yang dipertahankan di seluruh sistem iklan.
Representasi JSON
{
  "id_value": string,
  "id_registry": string,
}
Kolom
id_value string

ID Iklan Universal dari materi iklan yang dipilih untuk iklan.
id_registry string

String yang digunakan untuk mengidentifikasi URL situs pendaftaran tempat ID Iklan Universal materi iklan yang dipilih dikatalogkan.

Pengiring

Pengiring berisi informasi untuk iklan pengiring yang dapat ditampilkan bersama dengan iklan.
Representasi JSON
{
  "click_data": object(ClickData),
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}
Kolom
click_data object(ClickData)

Data klik untuk pengiring ini.
creative_type string

Atribut CreativeType pada node <StaticResource> di VAST jika ini adalah pendamping jenis statis.
height int32

Tinggi pengiring ini dalam piksel.
width int32

Lebar pengiring ini dalam piksel.
resource string

Untuk pendamping statis dan iframe, ini akan menjadi URL yang akan dimuat dan ditampilkan. Untuk pengiring HTML, ini akan menjadi cuplikan HTML yang harus ditampilkan sebagai pengiring.
type string

Jenis pengiring ini. Dapat berupa statis, iframe, atau HTML.
ad_slot_id string

ID slot untuk pendamping ini.
api_framework string

Framework API untuk pendamping ini.
tracking_events [object(TrackingEvent)]

Daftar peristiwa pelacakan untuk pendamping ini.

InteractiveFile

InteractiveFile berisi informasi untuk materi iklan interaktif (yaitu SIMID) yang harus ditampilkan selama pemutaran iklan.
Representasi JSON
{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}
Kolom
resource string

URL ke materi iklan interaktif.
type string

Jenis MIME file yang disediakan sebagai resource.
variable_duration boolean

Apakah materi iklan ini dapat meminta perpanjangan durasi.
ad_parameters string

Nilai node <AdParameters> di VAST.