Dinamik Reklam Ekleme VOD API'si

Dinamik Reklam Ekleme API'si, DAI için istekte bulunmanıza ve bu verileri izlemenize olanak tanır seç-izle video (VOD) hizmeti HLS ve DASH akışları desteklenir.

Hizmet: dai.google.com

stream yönteminin yolu https://dai.google.com ile görelidir

Yöntem: akış

HTTP isteği

POST https://dai.google.com/ondemand/v1/hls/content/{content-source}/vid/{video-id}/stream

POST https://dai.google.com/ondemand/v1/dash/content/{content-source}/vid/{video-id}/stream

İstek başlığı

Authorization: DCLKDAI key="<api-key>"

Yol parametreleri

İstek içeriği

İstek gövdesi application/x-www-form-urlencoded türündedir ve şu parametrelere sahiptir:

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, yeni bir Stream. Sunucu tarafı işaretleme akışları için bu Stream yalnızca stream_id ve stream_manifest alanlarını içerir.

Open Measurement

Verifications alanı, "Açık" seçeneğinin bilgilerini içerir Sunucu tarafı işaretlemeyen akışlar için ölçüm doğrulaması. Verifications, kaynakların listelendiği bir veya daha fazla Verification öğesi içeriyor üçüncü taraf ölçüm koduyla reklam öğesi oynatmayı doğrulamak için ihtiyacınız olan verileri ve meta verileri içerir. Yalnızca JavaScriptResource desteklenir. Daha fazla bilgi için daha fazla bilgi için IAB Tech Lab ve VAST 4.1 spesifikasyonu kullanıyor.

Yöntem: Medya doğrulaması

Oynatma sırasında bir reklam medyası tanımlayıcısıyla karşılaştığınızda, bunu hemen stream içinden media_verification_url öğesini kullanarak istekte bulunun uç nokta. media_verification_url, mutlak bir yoldur. Sunucu tarafı işaretleme akışları için medya doğrulama istekleri gerekli değildir. Burada sunucu medya doğrulamasını başlatır.

media verification uç noktasına yapılan istekler idempotenttir.

HTTP isteği

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

Yanıt gövdesi

media verification. şu yanıtları döndürür:

• Medya doğrulaması başarılı olursa ve tüm ping'ler gönderilirse HTTP/1.1 204 No Content.
• İstek, yanlış URL biçimlendirmesi veya geçerlilik süresi nedeniyle medyayı doğrulayamıyorsa HTTP/1.1 404 Not Found.
• Bu kimlik için önceki doğrulama isteği başarılı olduysa HTTP/1.1 404 Not Found.
• Şu anda başka bir istek zaten ping gönderiyorsa HTTP/1.1 409 Conflict.

Reklam medyası kimlikleri (HLS)

Reklam medyası tanımlayıcıları, TXXX anahtarı kullanılarak HLS Zamanlı Meta Veri'de kodlanır. "kullanıcı tanımlı metin bilgileri" için ayrıldı çerçeveler. Çerçevenin içeriği şifrelenmez ve her zaman "google_" metniyle başlar.

Çerçevedeki tüm metin içerikleri media_verification_url parametresini kullanın.

Reklam medyası kimlikleri (DASH)

Reklam medyası tanımlayıcıları, DASH'in EventStream öğesi.

Her EventStream, urn:google:dai:2018 Şema Kimliği URI'sine sahip olur. Bunlar, messageData özelliğine sahip etkinlikler içerir: “google_” ile başlayan reklam medyası kimliği. messageData içeriğinin tamamı özelliği, her reklam için media_verification_url öğesine eklenmelidir. doğrulama isteği gönderin.

Yanıt verileri

Akış

{
  "stream_id": string,
  "total_duration": number,
  "content_duration": number,
  "valid_for": string,
  "valid_until": string,
  "subtitles": [object(Subtitle)],
  "hls_master_playlist": string,
  "stream_manifest": string,
  "media_verification_url": string,
  "apple_tv": object(AppleTV),
  "ad_breaks": [object(AdBreak)],
}

AppleTV

{
  "interstitials_url": string,
}

AdBreak

{
  "type": string,
  "start": number,
  "duration": number,
  "ads": [object(Ad)],
}

Reklam

{
  "seq": number,
  "start": 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,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "events": [object(Event)],
  "verifications": [object(Verification)],
  "universal_ad_id": object(UniversalAdID),
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
  "skip_metadata": object(SkipMetadata),
}

Etkinlik

{
  "time": number,
  "type": string,
}

Alt başlık

{
  "language": string,
  "language_name": string,
  "ttml": string,
  "webvtt": string,
}

SkipMetadata

{
  "offset": number,
  "tracking_url": string,
}

Simge

{
  "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

{
  "url": string,
}

FallbackImage

{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}

Wrapper

{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}

Doğrulama

{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}

JavaScriptResource

{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}

TrackingEvent

{
  "event": string,
  "uri": string,
}

UniversalAdID

{
  "id_value": string,
  "id_registry": string,
}

Tamamlayıcı

{
  "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)],
}

InteractiveFile

{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}