Canlı API sunan Dinamik Reklam Ekleme kapsülü

Dinamik Reklam Ekleme API'si, DAI canlı yayınları için istekte bulunmanıza ve bu canlı yayınları izlemenize olanak tanır.

Hizmet: dai.google.com

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

Yöntem: akış

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ıl İ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ğrulayın.

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 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}

Geçerli 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 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.
sd required1 integer

İstenen 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 imzalı, URL kodlu bir HMAC jetonu.
last isteğe bağlı boolean

Reklam arasındaki son segmenti 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

https://dai.google.com/lineer/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd-c8c04c8c0c4c4c4c4c4c4c5

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, 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 oynatmaya hazır olan 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;

Reklam kapsülü için HLS çok değişkenli oynatma listesi alma API'si.

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 yapılan 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 gövdesi, 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

Reklam kapsülü için MPEG-DASH mpd oynatma listesini alma API'si.

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

Geçerli 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 kapsülü kimlikleri, 1 tutarından itibaren her reklam arası etkinliğine aşamalı olarak 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 manifestinize birleştirilebilir.

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 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.

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'ye bir medya doğrulama etkinliği bildirir.

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)
  • Bu kimlik için daha önce yapılan bir doğrulama isteği başarılı olduysa HTTP/1.1 404 Not Found.
  • HTTP/1.1 409 Conflict ise başka bir istek şu anda ping gönderiyor demektir.

Reklam medyası 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 bir 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, şöyle 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 bulunduktan sonra reklam kimliklerini, reklam arası kimliklerini ve etkinlik türünü arayabilirsiniz. Daha sonra reklam kimlikleri 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 kaynakların listesini JSON biçiminde oluşturmak amacıyla 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ı canlı tutmak için kullanılan sinyal URL'si her {PollingFrequency} saniyede bir pinglenmelidir. Sunucu tarafı işaretleme akışları için doldurulur.
polling_frequency number

Metadata_url veya cardbeat_url istenirken saniye cinsinden yoklama sıklığı.
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 (kısa çizgi veya hls) parametresinden alınan manifestin biçimidir.

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, reklama ait reklam arası ve etkinlik türü için referans içeriyor. type="progress" içeren TagSegmenti, 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ü.

Reklam arası

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ı için saniye cinsinden toplam reklam süresi.
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, 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

Geçerli girişin seçenek listesi olduğunu belirten isteğe bağlı Boole.
icons [object(Icon)]

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

Boşsa atlanan Sarmalayıcılar listesi.
universal_ad_id object(UniversalAdID)

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

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

Bu reklamla birlikte görüntülenebilecek 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 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 doldurulması gereken dönemin xml şablonudur.
segment_duration_ms int64

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

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, bir simge tıklamasıyla ilgili bilgiler 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 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

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ü için 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

İzleme Etkinliği, belirli durumlarda istemci tarafından pinglenmesi 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ğ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ı için 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 tamamlayıcının alan kimliği.
api_framework string

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

Bu tamamlayıcı için izleme etkinliklerinin listesi.

InteractiveFile

InteractiveFile, reklam oynatma sırasında görüntülenmesi gereken etkileşimli reklam öğesi (SIMID) ile ilgili bilgileri 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 isteymeyeceği.
ad_parameters string

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