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

Bir DAI DAI kapsül yayınlama canlı yayın oturumunu 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

Bu etkinlikle Google Ad Manager'da ilişkilendirilmiş ö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ı Bir akış oluşturma parametresinin varsayılan değerlerini geçersiz kılma.
HMAC kimlik doğrulaması İsteğe bağlı HMAC tabanlı bir jeton kullanarak kimlik doğrulama.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, yeni bir Stream nesnesi içerir.

Open Measurement

DAI API'si, Verifications alanında Open Measurement doğrulamasıyla ilgili bilgiler içerir. Bu alan, reklam öğesi oynatmayı 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 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

Bu etkinlikle Google Ad Manager'da ilişkilendirilmiş ö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 grubu kimlikleri, 1 ile başlayarak her reklam arası etkinliği için artımlı olarak atanır.

ad_break_id/{string}

Mevcut reklam arasının dize tanımlayıcısı. Yayıncı tarafından sağlanan reklam arası kimliği, reklam kapsülü kimliğiyle aynı kısıtlamalara sahip değildir. Bu uç noktaya sağlanan bilinmeyen reklam arası kimlikleri, canlı yayın etkinliği için yeni bir reklam arası oluşturur.

profile_name string

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

segment_number integer

Geçerli reklam kapsülündeki istenen segmentin sıfırdan başlayan dizini.
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 required string

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

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

İstenen segmentin reklam kapsülü içindeki milisaniye cinsinden uzaklığı. so parametresini atlarsanız segment süresi ile segment sayısı çarpılarak hesaplanır.
pd required2 integer

Reklam kapsülünün süresi (milisaniye cinsinden).
auth-token required string

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

Reklam arasının son segmentini gösterir. Diğer tüm segmentler için bu parametreyi atlayı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ı sorgu dizesi olarak gösterilmelidir.

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

Dipnotlar

  1. Başlatma segmentleri için sd gerekli değildir. ↩
  2. Süresiz reklam araları etkinleştirilmiş 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

Başarılı olursa yanıt gövdesi, istekte belirtilen biçim ve parametrelerle eşleşen oynatılabilir bir yayın segmenti olur.

Yöntem: HLS kapsül manifesti

Bir istemci video oynatıcının yükleyip oynatmaya hazır olduğu canlı yayın için HLS reklam kapsülü manifestini alır.

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

Reklam kapsülü için HLS çok değişkenli oynatma listesini 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_identifier}.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_identifier

Aşağıdaki biçimler desteklenir:

pod/{integer}

Mevcut reklam arasının sayısal tanımlayıcısı. Reklam grubu kimlikleri, 1 ile başlayarak her reklam arası etkinliği için artımlı olarak atanır.

ad_break_id/{string}

Mevcut reklam arasının dize tanımlayıcısı. Yayıncı tarafından sağlanan reklam arası kimliği, reklam kapsülü kimliğiyle aynı kısıtlamalara sahip değildir. Bu uç noktaya sağlanan bilinmeyen reklam arası kimlikleri, canlı yayın etkinliği için yeni bir reklam arası oluşturur.

Sorgu parametreleri

Parametreler
stream_id Zorunlu string

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

Reklam kapsülünün süresi (milisaniye cinsinden).
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ı sorgu dizesi olarak gösterilmelidir.

Örnek:
Parametreler
  • section = sports
  • page = 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 listesidir.

Yöntem: DASH kapsül manifesti

Bir istemci video oynatıcının yükleyip oynatmaya hazır olduğu bir canlı yayın için 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

Reklam kapsülü için MPEG-DASH mpd oynatma listesini 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ının oturumunun akış kimliği. Bu değer, stream uç noktasına yapılan 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 grubu kimlikleri, 1 ile başlayarak her reklam arası etkinliği için artımlı olarak atanır.

Sorgu parametreleri

Parametreler
pd Zorunlu integer

Reklam kapsülünün süresi (milisaniye cinsinden).
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ı sorgu dizesi olarak gösterilmelidir.

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

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, MPEG-DASH mpd oynatma listesidir.

Yöntem: DASH pod 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 bir DASH dönemi şablonu ister. Bu şablon, yayın parametrelerinizle doldurmanız gereken makrolar içerir. Bu makrolar doldurulduktan sonra şablon, reklam arası döneminiz haline gelir ve DASH manifestinize 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

Bu etkinlikle Google Ad Manager'da ilişkilendirilmiş özel tanımlayıcı.

Sorgu parametreleri

Parametreler
stream_id required string

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

Yanıt gövdesi

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

Yöntem: Reklam kapsülü zamanlaması meta verileri

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

Reklam kapsülü zamanlama meta verilerini alır.

HTTP isteği

GET https://dai.google.com/linear/pods/v1/adv/network/{network_code}/custom_asset/{custom_asset_key}/pod.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 canlı yayınla ilişkili özel tanımlayıcı.

Sorgu parametreleri

Parametreler
stream_id Zorunlu string

İstemci video oynatıcı uygulamasından alınan Ad Manager akış kimliği.
ad_break_id required string

Bir sonraki reklam arası kimliği.

Reklam arası kimlikleri, birleştirme sunucusu veya VTP tarafından sağlanır ve aynı reklam arası için erken reklam arası bildirimleri, reklam kapsülü zamanlama meta veri istekleri ve segment yönlendirme istekleriyle eşleşmelidir.

Özel reklam arası kimlikleri için aşağıdaki kısıtlamalar geçerlidir:

  • 1 ile 63 karakter arasında olmalıdır.
  • Yalnızca küçük harf, rakam ve kısa çizgi içermelidir.
  • Reklam arası kimliği preroll, ön rulo reklam kapsülünü almak için ayrılmıştır. Başka bir reklam kapsülünü tanımlamak için kullanılamaz.
auth-token required string

auth-token, aşağıdaki parametreleri içeren bir HMAC jetonundan oluşur:

  • ad_break_id
  • custom_asset_key
  • exp
  • network_code
  • custom_params
  • pd
  • scte35
timeout isteğe bağlı integer

DAI'nın reklam kararı için bekleme amacıyla bu isteği engelleyebileceği milisaniye sayısı. İlk istekte doldurulmuş reklamlar döndürmesi gereken isteklerde (ör. yayın öncesi reklam araları) bu parametreyi kullanın.

Zaman aşımı süresi aşılırsa istek, beklemede durumuyla geri döner.

Zaman aşımı değeri dahil edilirse 1.000 ile 15.000 milisaniye arasında olmalıdır. Atlanırsa yanıtlar, reklam kararı için bekletilmez.
final isteğe bağlı boolean

VTP'nin bu reklam kapsülü için yapmaya istekli olduğu son istek olduğunu DAI'ye belirtmek üzere true olarak ayarlayın. Bir reklam kararı henüz mevcut değilse (isteğe bağlı zaman aşımı süresi içinde), DAI bu istek için kalıcı olarak slate döndürür.

Varsayılan olarak false değerine ayarlanır.

Reklam karar parametreleri
pd isteğe bağlı integer

Reklam arasının süresi (milisaniye). Reklam kapsülü süresi olarak da adlandırılır.

EABN kullanılıyorsa pd değeri, reklam arası bildiriminize girilen süreyle eşleşmelidir. Süreler eşleşmezse EABN değerine öncelik verilir.

cust_params isteğe bağlı string

Ad Manager Yardım Merkezi'nde açıklandığı gibi, reklam arası hedefleme için özel parametreler.
scte35 isteğe bağlı string

Base64 kodlu bir SCTE-35 sinyali.

Sinyal geçersizse yanıtın X-Ad-Manager-Dai-Warning HTTP başlığında bir mesaj gönderilir ve istek, geçersiz scte35 değeri olmadan gönderilir.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi yeni bir AdPodTimingMetadataResponse nesnesi içerir.

Yöntem: medya doğrulaması

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

media verification uç noktasına yapılan istekler idempotent'tır.

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

API'yi bir 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 İstek, yanlış URL biçimlendirmesi veya sürenin dolması nedeniyle medyayı doğrulayamıyorsa.
  • Bu kimlik için önceki doğrulama isteği başarılı olduysa HTTP/1.1 404 Not Found.
  • HTTP/1.1 409 Conflict Başka bir istek bu sırada zaten ping gönderiyorsa

Reklam medyası kimlikleri

Reklam medyası tanımlayıcıları ayrı bir meta veri parçasında kodlanır. Bu parça, HLS aktarım akışı için zamanlanmış meta veriler veya MP4 dosyaları için emsg'dir. Reklam medyası tanımlayıcıları her zaman google_ dizesiyle başlar.

Her reklam doğrulama isteğinde bulunmadan önce, meta veri girişiyle ilgili tüm metin içerikleri reklam doğrulama URL'sine eklenmelidir.

Yöntem: metadata

metadata_url adresindeki meta veri uç noktası, reklam kullanıcı arayüzü oluşturmak için kullanılan bilgileri döndürür. Meta veri uç noktası, sunucunun reklam medyası doğrulamayı başlatmaktan sorumlu olduğu sunucu tarafı işaretçi yayınları için kullanılamaz.

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

GET /{metadata_url}

Reklam meta verileri 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. Buradan etiketler arasında yineleme yaparak video akışında bulunan reklam medyası kimliğinin öneki olan ilk girişi bulun. Örneğin, reklam medyası kimliğiniz şu şekilde görünebilir:

google_1234567890

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

Yanıt verileri

Akış

Akış, yeni oluşturulan bir akış için kaynak listesini JSON biçiminde oluşturmak üzere 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 içi reklam etkinlikleri hakkında düzenli olarak bilgi almak için kullanılan meta veri URL'si.
session_update_url string

Bu yayın için hedefleme parametrelerini güncellemek üzere 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ı etkin tutmak için kullanılan kalp atışı URL'si, her {PollingFrequency} saniyede bir pinglenmelidir. Sunucu tarafı işaretleme akışları için doldurulur.
polling_frequency number

metadata_url veya heartbeat_url istenirken anket sıklığı (saniye cinsinden).
pod_manifest_url string

Kapsül manifest URL'si şablonu, bir akışın kapsül manifestini almak için URL oluşturmak üzere kullanılır. Bu URL, HLS'deki çok varyantlı oynatma listesinin URL'sine veya DASH'teki MPD'ye karşılık gelir. POD_SERVING_MANIFEST türünde Dinamik Reklam Ekleme 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'den 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 eklenmiş 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 arası kimliğine göre dizine eklenen reklam aralarının haritası.

TagSegment

TagSegment, bir reklama, reklam arasını ve etkinlik türüne referans içerir. TagSegment with type="progress" (tür="ilerleme") parametresi, reklam medyası doğrulama uç noktasına pinglenmemelidir.
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, akıştaki tek bir reklam arasını tanımlar. Süre, tür (orta/ön/son) ve reklam sayısı bilgilerini içerir.
JSON gösterimi
{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}
Alanlar
type string

Geçerli ara türleri şunlardır: pre, mid ve post.
duration number

Bu reklam arası için toplam reklam süresi (saniye).
expected_duration number

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

Reklam arasındaki reklam sayısı.
Reklam, akıştaki 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ı anlaşma 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)]

Üçüncü taraf ölçüm kodunu yürütmek için gereken kaynakları ve meta verileri listeleyen isteğe bağlı Açık Ölçüm doğrulama girişleri reklam öğesi oynatmayı doğrulamak için.
slate boolean

Geçerli girişin slate olduğunu belirten isteğe bağlı boole.
icons [object(Icon)]

Boşsa atlanan simge listesi.
wrappers [object(Wrapper)]

Boşsa atlanan sarmalayıcıların listesi.
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ılırken gösterilmesi gereken isteğe bağlı etkileşimli reklam öğesi (SIMID).

PodTemplateResponse

PodTemplateResponse, pod birleştirme 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ştirme işleminden önce uygun verilerle doldurulacak döneme ait XML şablonudur.
segment_duration_ms int64

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

AdpodTimingMetadataResponse

AdpodTimingMetadataResponse, reklam grubu ve bunun için segment URL'lerinin nasıl oluşturulacağı hakkında bilgiler 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ü için karar durumu.
ads [object(AdRendering)]

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

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

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

Bu reklam kapsülünün DASH manifestlerinde oluşturulacak DASH uyarlama kümelerinin listesi.

AdRendering

AdRendering, karara bağlanmış 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

Milisaniye cinsinden reklam 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 eklenmiş Varyant nesneleri sözlüğü (aşağıya bakın).

SlateRendering

SlateRendering, slate 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

Milisaniye cinsinden (int) başlangıç ekranı süresi.
variants map[string, object(VariantRendering)]

Varyant/profil kimliğine göre dizine eklenmiş Varyant nesneleri sözlüğü. Slate süreleri, gerekli slate uzunluğuna ulaşılana kadar döngüye alınmalıdır. Döngüler arasına HLS süreksizlikleri eklenmeli veya MPEG-DASH için yeni dönemler döngüye alınmalıdır.

VariantRendering

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

Dize, şu değerlerden biri: ts, mp4, aac, ac3, ec3, m4a, m4v. Dosya adı uzantısı, segment URL'lerinin bir parçasıdır.
segment_durations object(SegmentDurations)

SegmentDurations nesneleri. Her segment süresi, bir segment URL'sine çevrilebilir.

SegmentDurations

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

Zaman ölçeği, saniye başına birim sayısıdır (int). Şu şekilde olması 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 birimleriyle ifade edilen, int türünde segment süreleri dizisi.

DASHRepresentation

DASHRepresentation, DASH manifestlerinde oluşturulacak Representation düğümlerini açıklar.
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

Gösterimin codec'leri.
bandwidth number

Gösterimin bant genişliği.
width number

Temsilin genişliği.
height number

Temsilin yüksekliği.
frame_rate string

Temsilin kare hızı.
audio_sampling_rate number

Temsilin ses örnekleme hızı.
audio_channel_config object(SchemeIDURIAndValue)

Temsilin ses kanalı yapılandırması.

DASHAdaptationSet

DASHAdaptationSet, DASH manifestlerinde oluşturulacak AdaptationSet düğümlerini açıklar.
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

Adaptasyon kümesinin MIME türü.
role object(SchemeIDURIAndValue)

Uyarlama grubunun rolü.
inband_event_stream object(SchemeIDURIAndValue)

Uyarlama kümesinin 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

Uyarlama grubunun tarama türü.
start_with_sap string

Uyarlama grubunun SAP'si ile başlayın.
segment_alignment boolean

Uyarlama grubunun segment hizalaması.
representations string

Uyarlama grubunun temsilleri.

SchemeIDURIAndValue

SchemeIDURIAndValue, bir şema kimliği ve değerinden oluşan bir çifttir.
JSON gösterimi
{
  "scheme_id_uri": string,
  "value": string,
}
Alanlar
scheme_id_uri string

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

Şema kimliği URI'sinin değeri.

Simge

Simge, VAST simgesiyle ilgili bilgiler 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, bir simge tıklamasıyla ilgili bilgileri 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. 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 reklam 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

Bootstrap doğrulama koduna iletilen opak bir dize.

JavaScriptResource

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

JavaScript yükü için URI.
api_framework string

APIFramework, doğrulama kodunu kullanan 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ğı.

TrackingEvent

TrackingEvent, belirli durumlarda istemci tarafından ping gönderilmesi gereken URL'ler 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ğinin kataloglandığı kayıt kuruluşu web sitesinin URL'sini tanımlamak için kullanılan dize.

Tamamlayıcı

Companion, 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ı reklam öğesinin tıklama verileri.
creative_type string

Bu, statik türde bir eşlik eden reklam ise VAST'taki <StaticResource> düğümünde CreativeType özelliği.
height int32

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

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

Statik ve iframe eşlikçiler 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 eşlik eden öğenin yuva kimliği.
api_framework string

Bu eşlikçi için API çerçevesi.
tracking_events [object(TrackingEvent)]

Bu eşlikçiyle ilgili izleme etkinliklerinin listesi.

InteractiveFile

InteractiveFile, reklam oynatma 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ürenin uzatılmasını isteyip istemediği.
ad_parameters string

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