Canlı API sunan Dinamik Reklam Ekleme kapsülü

Dinamik Reklam Ekleme API'si, DAI canlı yayınlarını istemenize ve izlemenize olanak tanır.

Hizmet: dai.google.com

Tüm URI'ler https://dai.google.com ile ilgilidir.

Yöntem: stream

Yöntemler
stream POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

DAI kapsül yayınlama canlı yayın oturumu kaydeder.

HTTP isteği

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

Yol parametreleri

Parametreler
network_code string

Yayıncının Google Ad Manager ağ kodu.

custom_asset_key string

Google Ad Manager'da bu etkinlikle ilişkili özel tanımlayıcı.

İstek içeriği

İstek metni application/x-www-form-urlencoded türündedir ve aşağıdaki parametreleri içerir:

Parametreler
DFP Hedefleme Parametreleri İsteğe bağlı Ek hedefleme parametreleri.
Akış Parametrelerini Geçersiz Kılma İsteğe bağlı Akış oluşturma parametresinin varsayılan değerlerini geçersiz kılabilirsiniz.
HMAC Kimlik Doğrulaması İsteğe bağlı HMAC tabanlı bir jeton kullanarak kimlik doğrulama yapın.

Yanıt gövdesi

Başarılı olursa yanıt metni yeni bir Stream nesnesi içerir.

Open Measurement

DAI API'si, Verifications alanında Open Measurement doğrulamasıyla ilgili bilgileri içerir. Bu alan, reklam öğesi oynatılmasını doğrulamak için üçüncü taraf ölçüm kodunu yürütmek üzere gereken kaynakları ve meta verileri listeleyen bir veya daha fazla Verification öğesi içerir. Yalnızca JavaScriptResource desteklenir. Daha fazla bilgi için lütfen IAB Tech Lab'e ve VAST 4.1 spesifikasyonuna bakın.

Yöntem: kapsül segmenti

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

Belirtilen etkinlik kimliği için bir DAI akışı oluşturur.

HTTP isteği

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}

Yol parametreleri

Parametreler
network_code string

Yayıncının Google Ad Manager ağ kodu.

custom_asset_key string

Google Ad Manager'da bu etkinlikle ilişkili özel tanımlayıcı.

pod_identifier

Aşağıdaki biçimler desteklenir:

pod/{integer}

Mevcut reklam arasının sayısal tanımlayıcısı. Reklam kapsülü kimlikleri, her reklam arası etkinliği için 1'ten başlayarak artan şekilde atanır.

ad_break_id/{string}

Mevcut reklam arasının dize tanımlayıcısı.
profile_name string

İstenen Google Ad Manager DAI kodlama profilinin adı. Kodlama profili, seçili etkinlik için yapılandırılmış kodlama profillerinden biri olmalıdır.

segment_number integer

Mevcut reklam kapsülündeki istenen segmentin dizini (sıfırdan başlar).
segment_format string

İstenen segment biçimiyle ilişkili dosya uzantısı. Kabul edilen uzantılar: ts, mp4, vtt, aac, ac3 veya eac3.

Sorgu parametreleri

Parametreler
stream_id gerekli string

Mevcut kullanıcı oturumunun akış kimliği. Bu değer, stream uç noktasına gönderilen başarılı bir istek tarafından döndürülür.
sd required1 integer

İstenilen segmentin milisaniye cinsinden süresi.
so isteğe bağlı

İstenilen segmentin reklam kapsülü içindeki ofseti (milisaniye cinsinden). so parametresini atlarsanız segment süresi, segment sayısıyla çarpılarak hesaplanır.
pd zorunlu2 integer

Reklam kapsülünün milisaniye cinsinden süresi.
auth-token gerekli string

Mevcut reklam kapsülü için imzalanmış, URL kodlamalı bir HMAC jetonu.
last isteğe bağlı boolean

Reklam arasının son segmentini belirtir. Diğer tüm segmentler için bu parametreyi çıkarın.
scte35 isteğe bağlı string

Bu reklam arası için Base64 kodlamalı SCTE-35 sinyali.
cust_params isteğe bağlı string

Ad Manager kampanya hedeflemesi için kullanılan bir anahtar/değer çiftleri kümesi. Bu çiftler, URL kodlamalı bir sorgu dizesi olarak temsil edilmelidir.

Örnek:
Parametreler
  • section = sports
  • sayfa = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Dipnotlar

  1. sd, başlatma segmentleri için gerekli değildir. ↩
  2. Süresiz reklam aralarının etkin olduğu etkinlikler için pd gerekli değildir. ↩

Örnek

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

Yanıt gövdesi

İşlem başarılı olursa yanıt metni, istekte belirtilen biçim ve parametrelerle eşleşen oynatılabilir bir akış segmenti olur.

Yöntem: HLS kapsül manifesti

İstemci video oynatıcının yükleyip oynatabileceği bir canlı yayının HLS reklam kapsülü manifestini alır.

Yöntemler
GET GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/pod/{pod_id}.m3u8;

Bir reklam kapsülü için HLS çok değişkenli oynatma listesi almak üzere kullanılan API.

HTTP isteği

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

Yol parametreleri

Parametreler
network_code string

Yayıncının Google Ad Manager ağ kodu.
custom_asset_key string

Google Ad Manager'da bu etkinlikle ilişkili özel tanımlayıcı
pod_id integer

Mevcut reklam arasının sayısal tanımlayıcısı. Reklam kapsülü kimlikleri, her reklam arası etkinliği için 1'ten başlayarak artan şekilde atanır.

Sorgu parametreleri

Parametreler
stream_id Zorunlu string

Mevcut kullanıcı oturumunun akış kimliği. Bu değer, stream uç noktasına gönderilen başarılı bir istek tarafından döndürülür.
pd Zorunlu integer

Reklam kapsülünün milisaniye cinsinden süresi.
scte35 isteğe bağlı string

Bu reklam arası için Base64 kodlamalı SCTE-35 sinyali.
cust_params isteğe bağlı string

Ad Manager kampanya hedeflemesi için kullanılan bir anahtar/değer çiftleri kümesi. Bu çiftler, URL kodlamalı bir sorgu dizesi olarak temsil edilmelidir.

Örnek:
Parametreler
  • section = sports
  • sayfa = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Yanıt gövdesi

Başarılı olursa yanıt metni, HLS çok değişkenli oynatma listesi olur.

Yöntem: DASH kapsül manifesti

İstemci video oynatıcının yükleyip oynatmaya hazır olduğu bir canlı yayının MPEG-DASH reklam kapsülü manifestini alır.

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

Bir reklam kapsülü için MPEG-DASH mpd oynatma listesi almak üzere kullanılan API.

HTTP isteği

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}

Yol parametreleri

Parametreler
network_code string

Yayıncının Google Ad Manager ağ kodu.
custom_asset_key string

Google Ad Manager'da bu etkinlikle ilişkili özel tanımlayıcı
stream_id string

Mevcut kullanıcı oturumunun akış kimliği. Bu değer, stream uç noktasına gönderilen başarılı bir istek tarafından döndürülür.
pod_id integer

Mevcut reklam arasının sayısal tanımlayıcısı. Reklam kapsülü kimlikleri, her reklam arası etkinliği için 1'ten başlayarak artan şekilde atanır.

Sorgu parametreleri

Parametreler
pd Zorunlu integer

Reklam kapsülünün milisaniye cinsinden süresi.
scte35 isteğe bağlı string

Bu reklam arası için Base64 kodlamalı SCTE-35 sinyali.
cust_params isteğe bağlı string

Ad Manager kampanya hedeflemesi için kullanılan bir anahtar/değer çiftleri kümesi. Bu çiftler, URL kodlamalı bir sorgu dizesi olarak temsil edilmelidir.

Örnek:
Parametreler
  • section = sports
  • sayfa = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Yanıt gövdesi

Başarılıysa yanıt metni bir MPEG-DASH mpd oynatma listesidir.

Yöntem: DASH kapsül dönemi şablonu

Yöntemler
pods GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

Google Ad Manager'dan DASH dönemi şablonu ister. Bu şablon, yayın parametrelerinizle doldurmanız gereken makrolar içerir. Bu makrolar doldurulduktan sonra şablon, reklam arası süreniz olur ve DASH manifest'inize eklenebilir.

HTTP isteği

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

Yol parametreleri

Parametreler
network_code string

Yayıncının Google Ad Manager ağ kodu.

custom_asset_key string

Google Ad Manager'da bu etkinlikle ilişkili özel tanımlayıcı.

Sorgu parametreleri

Parametreler
stream_id gerekli string

Mevcut kullanıcı oturumunun akış kimliği. Bu değer, stream uç noktasına gönderilen başarılı bir istek tarafından döndürülür.

Yanıt gövdesi

Başarılı olursa yanıt metni yeni bir PodTemplateResponse nesnesi içerir.

Yöntem: medya doğrulaması

Oynatma sırasında bir reklam medya tanımlayıcısı ile karşılaştıktan sonra, yukarıdaki stream uç noktasından elde edilen media_verification_url'yi kullanarak hemen istek gönderin. Bu istekler, sunucunun medya doğrulamasını başlattığı sunucu tarafı işaretçi akışları için gerekli değildir.

media verification uç noktasına gönderilen istekler idempotent'tir.

Yöntemler
media verification GET /{media_verification_url}/{ad_media_id}

API'yi medya doğrulama etkinliği hakkında bilgilendirir.

HTTP isteği

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

Yanıt gövdesi

media verification aşağıdaki yanıtları döndürür:

  • HTTP/1.1 204 No Content medya doğrulaması başarılı olursa ve tüm ping'ler gönderilirse.
  • HTTP/1.1 404 Not Found (istekte yanlış URL biçimlendirmesi veya geçerlilik süresi sona ermesi nedeniyle medya doğrulanamıyorsa)
  • HTTP/1.1 404 Not Found değerini döndürür.
  • HTTP/1.1 409 Conflict ise bu sırada başka bir istek ping gönderiyorsa.

Reklam medya kimlikleri

Reklam medyası tanımlayıcıları ayrı bir meta veri parçasına kodlanır: HLS aktarma akışı için zamanlanmış meta veriler veya mp4 dosyaları için emsg. Reklam medya kimlikleri her zaman google_ dizesiyle başlar.

Meta veri girişinin metin içeriğinin tamamı, her reklam doğrulama isteği gönderilmeden önce reklam doğrulama URL'sine eklenmelidir.

Yöntem: meta veri

metadata_url adresindeki meta veri bitiş noktası, reklam kullanıcı arayüzü oluşturmak için kullanılan bilgileri döndürür. Meta veri uç noktası, reklam medya doğrulamasını başlatmaktan sunucunun sorumlu olduğu sunucu tarafı işaretçi akışları için kullanılamaz.

Yöntemler
metadata GET /{metadata_url}/{ad-media-id}

GET /{metadata_url}

Reklam meta veri bilgilerini alır.

HTTP isteği

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

GET https://{metadata_url}

Yanıt gövdesi

Başarılı olursa yanıt, PodMetadata öğesinin bir örneğini döndürür.

Meta verileri ayrıştırma

Meta veriler üç ayrı bölümden oluşur: tags, ads ve reklam breaks. Verilere giriş noktası tags bölümüdür. Ardından, etiketleri tarayın ve adı video akışındaki reklam medya kimliğinin ön eki olan ilk girişi bulun. Örneğin, şuna benzer bir reklam medya kimliğiniz olabilir:

google_1234567890

Ardından google_12345 adlı bir etiket nesnesi bulursunuz. Bu durumda, reklam medya kimliğinizle eşleşir. Doğru reklam medya ön ek nesnesi bulduktan sonra reklam kimliklerini, reklam arası kimliklerini ve etkinlik türünü arayabilirsiniz. Ardından reklam kimlikleri, ads nesnelerini dizine eklemek için kullanılır ve reklam arası kimlikleri, breaks nesnelerini dizine eklemek için kullanılır.

Yanıt verileri

Akış

Stream, yeni oluşturulan bir akışa ait kaynak listesini JSON biçiminde oluşturmak için kullanılır.
JSON gösterimi
{
  "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,
}
Alanlar
stream_id string

GAM akış tanımlayıcısı.
media_verification_url string

Oynatma etkinliklerini izlemek için temel uç nokta olarak kullanılan medya doğrulama URL'si.
metadata_url string

Yaklaşan yayın reklam etkinlikleri hakkında düzenli bilgi almak için anket yapmak üzere kullanılan meta veri URL'si.
session_update_url string

Bu yayının hedefleme parametrelerini güncellemek için kullanılan oturumun güncelleme URL'si. Hedefleme parametrelerinin orijinal değerleri, ilk akış oluşturma isteği sırasında yakalanır.
heartbeat_url string

Sunucu tarafı işaretleme akışının etkin kalmasını sağlamak için kullanılan kalp atışı URL'si, {PollingFrequency} saniyede bir pinglenmelidir. Sunucu tarafı işaretleme akışları için doldurulur.
polling_frequency number

metadata_url veya heartbeat_url isteğinde bulunurken anket sıklığı (saniye cinsinden).
pod_manifest_url string

Kapsül manifesti URL şablonu, bir yayının kapsül manifestini almak için URL oluşturmak amacıyla kullanılır. Bu URL, HLS'deki çok değişkenli oynatma listesinin veya DASH'teki MPD'nin URL'sine karşılık gelir. Dinamik Reklam Ekleme türü POD_SERVING_MANIFEST olan canlı yayın etkinlikleri için doldurulur. https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType
manifest_format string

Manifest biçimi, pod_manifest_url adresinden alınan manifestin biçimidir (dash veya hls).

PodMetadata

PodMetadata, reklamlar, reklam araları ve medya kimliği etiketleriyle ilgili meta veri bilgilerini içerir.
JSON gösterimi
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}
Alanlar
tags map[string, object(TagSegment)]

Etiket ön ekine göre dizine eklenen etiket segmentlerinin haritası.
ads map[string, object(Ad)]

Reklam kimliğine göre dizine eklenen reklamların haritası.
ad_breaks map[string, object(AdBreak)]

Reklam aralarının reklam arası kimliğine göre dizine eklenen haritası.

TagSegment

TagSegment, bir reklama, reklam arasınına ve etkinlik türüne referans içerir. type="progress" olan TagSegment, reklam medya doğrulama uç noktasına ping göndermemelidir.
JSON gösterimi
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
Alanlar
ad string

Bu etiketin reklamının kimliği.
ad_break_id string

Bu etiketin reklam arasının kimliği.
type string

Bu etiketin etkinlik türü.

AdBreak

AdBreak, yayındaki tek bir reklam arasını tanımlar. Süre, tür (orta/ön/son) ve reklam sayısını içerir.
JSON gösterimi
{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}
Alanlar
type string

Geçerli ara türü seçenekleri: önce, ortada ve sonra.
duration number

Bu reklam arasının toplam reklam süresi (saniye cinsinden).
expected_duration number

Tüm reklamlar ve listeler dahil olmak üzere reklam arasının beklenen süresi (saniye cinsinden).
ads number

Reklam arasının reklam sayısı.
Reklam, yayındaki bir reklamı tanımlar.
JSON gösterimi
{
  "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),
}
Alanlar
ad_break_id string

Bu reklamın reklam arasının kimliği.
position number

Bu reklamın reklam arasındaki konumu (1'den başlar).
duration number

Reklamın saniye cinsinden süresi.
title string

Reklamın isteğe bağlı başlığı.
description string

Reklamın isteğe bağlı açıklaması.
advertiser string

İsteğe bağlı reklamveren tanımlayıcısı.
ad_system string

İsteğe bağlı reklam sistemi.
ad_id string

İsteğe bağlı reklam kimliği.
creative_id string

İsteğe bağlı reklam öğesi kimliği.
creative_ad_id string

İsteğe bağlı reklam öğesi reklam kimliği.
deal_id string

İsteğe bağlı fırsat kimliği.
clickthrough_url string

İsteğe bağlı tıklama URL'si.
click_tracking_urls string

İsteğe bağlı tıklama izleme URL'leri.
verifications [object(Verification)]

Reklam öğesi oynatmayı doğrulamak için üçüncü taraf ölçüm kodunu yürütmek üzere gereken kaynakları ve meta verileri listeleyen isteğe bağlı Open Measurement doğrulama girişleri.
slate boolean

Mevcut girişin slate olduğunu belirten isteğe bağlı boole değeri.
icons [object(Icon)]

Simgelerin listesi (boşsa atlanır).
wrappers [object(Wrapper)]

Sarmalayıcıların listesi (boşsa atlanır).
universal_ad_id object(UniversalAdID)

İsteğe bağlı evrensel reklam kimliği.
extensions string

VAST'taki tüm <Extension> düğümlerinin isteğe bağlı listesi.
companions [object(Companion)]

Bu reklamla birlikte gösterilebilecek isteğe bağlı tamamlayıcılar.
interactive_file object(InteractiveFile)

Reklam oynatımı sırasında gösterilmesi gereken isteğe bağlı etkileşimli reklam öğesi (SIMID).

PodTemplateResponse

PodTemplateResponse, kapsül dikiş için bir VTP'ye döndürülen JSON yükünü temsil eder.
JSON gösterimi
{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}
Alanlar
dash_period_template string

DashPeriodTemplate, birleştirmeden önce uygun verilerle doldurulacak dönem için XML şablonudur.
segment_duration_ms int64

SegmentDurationMS, dönem segmentlerinin milisaniye cinsinden süresidir.

AdpodTimingMetadataResponse

AdpodTimingMetadataResponse, reklam kapsülü ve bunun için segment URL'lerinin nasıl oluşturulacağı hakkında bilgi içerir.
JSON gösterimi
{
  "status": string,
  "ads": [object(AdRendering)],
  "slate": object(SlateRendering),
  "dash_representations": map[string, object(DASHRepresentation)],
  "dash_adaptation_sets": map[string, object(DASHAdaptationSet)],
}
Alanlar
status string

Reklam kapsülünün karar durumu.
ads [object(AdRendering)]

Reklam segmenti URL'lerinin nasıl oluşturulacağını açıklayan, 0'dan başlayarak dizine eklenen reklam nesnesi dizisi.
slate object(SlateRendering)

Slate segment URL'lerinin nasıl oluşturulacağını açıklayan slate.
dash_representations map[string, object(DASHRepresentation)]

DASH manifestlerinde oluşturulacak reklam kapsülü için DASH temsillerinin listesi.
dash_adaptation_sets map[string, object(DASHAdaptationSet)]

DASH manifestlerinde oluşturulacak reklam kapsülü için DASH Uyumlulaştırma Setleri listesi.

AdRendering

AdRendering, karar verilen bir reklamın nasıl oluşturulacağını açıklar.
JSON gösterimi
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
Alanlar
duration_ms number

Reklamın milisaniye cinsinden süresi (int).
variants map[string, object(VariantRendering)]

Kullanıcı arayüzünden yapılandırıldığı şekilde varyant/profil kimliğine göre dizine eklenen varyant nesneleri sözlüğü (aşağıya bakın).

SlateRendering

SlateRendering, liste içeriğinin nasıl oluşturulacağını açıklar.
JSON gösterimi
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
Alanlar
duration_ms number

Slaytın milisaniye cinsinden süresi (int).
variants map[string, object(VariantRendering)]

Varyant/profil kimliğine göre dizine eklenen varyant nesneleri sözlüğü. Klip süreleri, gerekli klip uzunluğuna ulaşılana kadar tekrarlanmalı, yinelemeler arasına HLS kesintileri eklenmeli veya MPEG-DASH için yeni dönemler tekrarlanmalıdır.

VariantRendering

VariantRendering, reklam/araç listesinde bir varyantı/profili tanımlar.
JSON gösterimi
{
  "segment_extension": string,
  "segment_durations": object(SegmentDurations),
}
Alanlar
segment_extension string

Dize. Şunlardan biri: ts, mp4, aac, ac3, ec3, m4a, m4v. Segment URL'lerinin dosya adı uzantısı bölümü.
segment_durations object(SegmentDurations)

SegmentDurations nesneleri. Her segment süresi, segment URL'sine dönüştürülebilir.

SegmentDurations

SegmentDurations, belirli bir zaman biriminde bir segment dizisinin süresini tanımlar.
JSON gösterimi
{
  "timescale": number,
  "values": [],
}
Alanlar
timescale number

Zaman ölçeği, saniye başına birim sayısıdır (int) Aşağıdaki değerler beklenir: HLS için 1000 (milisaniye) DASH video için 90000 (PTS) DASH ses için ses örnekleme hızı.
values number

Zaman ölçeği birimlerinde tam sayı segment süreleri dizisi.

DASHRepresentation

DASHRepresentation, DASH manifestlerinde oluşturulacak Representation düğümlerini tanımlar.
JSON gösterimi
{
  "codecs": string,
  "bandwidth": number,
  "width": number,
  "height": number,
  "frame_rate": string,
  "audio_sampling_rate": number,
  "audio_channel_config": object(SchemeIDURIAndValue),
}
Alanlar
codecs string

Temsil biçiminin codec'leri.
bandwidth number

Temsil biçiminin bant genişliği.
width number

Temsil genişliği.
height number

Temsil şeklinin yüksekliği.
frame_rate string

Temsil biçiminin kare hızı.
audio_sampling_rate number

Temsil biçiminin ses örnekleme hızı.
audio_channel_config object(SchemeIDURIAndValue)

Temsilasyonun ses kanalı yapılandırması.

DASHAdaptationSet

DASHAdaptationSet, DASH manifestlerinde oluşturulacak AdaptationSet düğümlerini tanımlar.
JSON gösterimi
{
  "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": [],
}
Alanlar
content_type string

Uyarlama grubunun içerik türü.
mime_type string

Uyarlama grubunun MIME türü.
role object(SchemeIDURIAndValue)

Uyarlama grubunun rolü.
inband_event_stream object(SchemeIDURIAndValue)

Uyarlama grubunun bant içi etkinlik akışı.
min_frame_rate string

Uyarlama grubunun minimum kare hızı.
max_frame_rate string

Uyarlama grubunun maksimum kare hızı.
scan_type string

Uyumlulaştırma grubunun tarama türü.
start_with_sap string

Uyumlulaştırma grubunun SAP'inden başlayın.
segment_alignment boolean

Uyarlama grubunun segment hizası.
representations string

Uyarlama grubunun gösterimlerini gösterir.

SchemeIDURIAndValue

SchemeIDURIAndValue, bir şema kimliği ve bu kimliğin değeridir.
JSON gösterimi
{
  "scheme_id_uri": string,
  "value": string,
}
Alanlar
scheme_id_uri string

Değerin şema kimliği URI'si.
value string

Schema ID URI'sinin değeri.

Simge

Simge, VAST simgesiyle ilgili bilgileri içerir.
JSON gösterimi
{
  "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,
}
Alanlar
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, simge tıklaması hakkında bilgi içerir.
JSON gösterimi
{
  "url": string,
}
Alanlar
url string

FallbackImage

FallbackImage, VAST yedek resmiyle ilgili bilgileri içerir.
JSON gösterimi
{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}
Alanlar
creative_type string

height int32

width int32

resource string

alt_text string

Wrapper

Sarmalayıcı, sarmalayıcı reklamla ilgili bilgileri içerir. Anlaşma kimliği yoksa anlaşma kimliği içermez.
JSON gösterimi
{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}
Alanlar
system string

Reklam sistemi tanımlayıcısı.
ad_id string

Sarmalayıcı reklam için kullanılan reklam kimliği.
creative_id string

Sarmalayıcı reklam için kullanılan reklam öğesi kimliği.
creative_ad_id string

Sarmalayıcı reklam için kullanılan reklam öğesi kimliği.
deal_id string

Sarmalayıcı reklam için isteğe bağlı anlaşma kimliği.

Doğrulama

Doğrulama, üçüncü taraf görüntülenebilirlik ve doğrulama ölçümünü kolaylaştıran Open Measurement ile ilgili bilgileri içerir. Şu anda yalnızca JavaScript kaynakları desteklenmektedir. https://iabtechlab.com/standards/open-measurement-sdk/ adresine göz atın.
JSON gösterimi
{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}
Alanlar
vendor string

Doğrulama tedarikçisi.
java_script_resources [object(JavaScriptResource)]

Doğrulama için JavaScript kaynaklarının listesi.
tracking_events [object(TrackingEvent)]

Doğrulama için izleme etkinliklerinin listesi.
parameters string

Başlangıç doğrulama koduna iletilen opak bir dize.

JavaScriptResource

JavaScriptResource, JavaScript aracılığıyla doğrulamayla ilgili bilgileri içerir.
JSON gösterimi
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
Alanlar
script_url string

JavaScript yüküne URI.
api_framework string

APIFramework, doğrulama kodunu yürüten video çerçevesinin adıdır.
browser_optional boolean

Bu komut dosyasının tarayıcı dışında çalıştırılıp çalıştırılamayacağını belirtir.

TrackingEvent

TrackingEvent, belirli durumlarda istemci tarafından pinglenmesi gereken URL'leri içerir.
JSON gösterimi
{
  "event": string,
  "uri": string,
}
Alanlar
event string

İzleme etkinliğinin türü.
uri string

Ping gönderilecek izleme etkinliği.

UniversalAdID

UniversalAdID, reklam sistemlerinde korunan benzersiz bir reklam öğesi tanımlayıcısı sağlamak için kullanılır.
JSON gösterimi
{
  "id_value": string,
  "id_registry": string,
}
Alanlar
id_value string

Reklam için seçilen reklam öğesinin Evrensel Reklam Kimliği.
id_registry string

Seçilen reklam öğesinin Evrensel Reklam Kimliği'nin kataloglandığı kayıt otoritesi web sitesinin URL'sini tanımlamak için kullanılan bir dize.

Companion

Tamamlayıcı, reklamla birlikte gösterilebilecek tamamlayıcı reklamlarla ilgili bilgileri içerir.
JSON gösterimi
{
  "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)],
}
Alanlar
click_data object(ClickData)

Bu tamamlayıcının tıklama verileri.
creative_type string

Bu, static türündeki bir tamamlayıcıysa VAST'teki <StaticResource> düğümündeki CreativeType özelliği.
height int32

Bu tamamlayıcı öğenin piksel cinsinden yüksekliği.
width int32

Bu tamamlayıcı öğenin piksel cinsinden genişliği.
resource string

Statik ve iframe tamamlayıcılar için bu, yüklenecek ve gösterilecek URL'dir. HTML tamamlayıcılar için bu, tamamlayıcı olarak gösterilmesi gereken HTML snippet'idir.
type string

Bu tamamlayıcının türü. Statik, iFrame veya HTML olabilir.
ad_slot_id string

Bu arkadaşın slot kimliği.
api_framework string

Bu tamamlayıcının API çerçevesi.
tracking_events [object(TrackingEvent)]

Bu tamamlayıcı cihazla ilgili izleme etkinliklerinin listesi.

InteractiveFile

InteractiveFile, reklam oynatımı sırasında gösterilmesi gereken etkileşimli reklam öğesi (ör. SIMID) bilgilerini içerir.
JSON gösterimi
{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}
Alanlar
resource string

Etkileşimli reklam öğesinin URL'si.
type string

Kaynak olarak sağlanan dosyanın MIME türü.
variable_duration boolean

Bu reklam öğesinin süresinin uzatılmasını isteyip istemeyeceğini belirtir.
ad_parameters string

VAST'taki <AdParameters> düğümünün değeri.