Dinamik Reklam Ekleme Doğrusal API'si

Dinamik Reklam Ekleme API'si, DAI için istekte bulunmanıza ve bu verileri izlemenize olanak tanır doğrusal (CANLI) akışlar.

Hizmet: dai.google.com

Aşağıdaki tüm URI'ler https://dai.google.com ile ilgilidir

Yöntem: akış

HTTP isteği

POST https://dai.google.com/linear/v1/hls/event/{assetKey}/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

DAI API'si, Open Measurement doğrulamasına ilişkin bilgileri Verifications alanına giriş yapın. Bu alan bir veya daha fazla öğe içeriyor Yürütülmek için gereken kaynakları ve meta verileri listeleyen Verification öğeleri üçüncü taraf ölçüm kodunu kontrol edin. Yalnızca JavaScriptResource desteklenir. Daha fazla bilgi için lütfen IAB Tech Lab ve VAST 4.1 spesifikasyonu.

Yöntem: Medya doğrulaması

Oynatma sırasında bir reklam medya tanımlayıcısıyla karşılaştıktan sonra, bunu hemen akıştan elde edilen media_verification_url'yi kullanarak istekte bulunma uç nokta ekleyin. Bu istekler, sunucu tarafı işaretleme için gerekli değildir Akışta yer alan sunuculardan birinin medya doğrulamasını başlattığını unutmayın.

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

HTTP isteği

GET https://{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, "kullanıcı tanımlı metin bilgileri" için ayrıldı çerçeveler. İlgili içeriği oluşturmak için kullanılan çerçevenin içeriği şifrelenmez ve her zaman "google_"

Çerçevedeki metin içeriğinin tamamı reklam doğrulamasına eklenmelidir. URL'sini eklemeniz gerekir.

Yöntem: meta veriler

metadata_url adresindeki meta veri uç noktası, reklam oluşturmak için kullanılan bilgileri döndürür Kullanıcı arayüzü. Meta veri uç noktası, sunucu tarafı işaretleme akışlarda kullanılamaz. Burada sunucu reklam medyası doğrulamasını başlatmaktan sorumlu olur.

HTTP isteği

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

GET https://{metadata_url}

Yanıt gövdesi

Başarılı olursa yanıt şu örneği döndürür: PodMetadata.

Meta verilerle çalışma

Meta veriler üç ayrı bölümden oluşur: tags, ads ve reklam breaks. Giriş tags bölümüdür. Ardından etiketleri yineleyin ve adı reklam medyası kimliği bulunmalıdır. Örneğin, aşağıdaki gibi bir reklam medyası kimliğine sahip olabilir:

google_1234567890

Daha sonra google_12345 adlı bir etiket nesnesi bulursunuz. Bu durumda, reklam medyası kimliği. Doğru reklam medyası öneki nesnesini bulduktan sonra, reklam kimlikleri, reklam arası kimlikleri ve etkinlik türü. Reklam kimlikleri daha sonra breaks nesneleri dizine eklemek için ads nesneleri ve reklam arası kimlikleri kullanılır.

Yanıt verileri

Akış

{
  "stream_id": string,
  "stream_manifest": string,
  "hls_master_playlist": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "polling_frequency": number,
}

PodMetadata

{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}

TagSegment

{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}

AdBreak

{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}

Reklam

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

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