SDK mimarisini öğrenin
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Platform seçin:
HTML5
Android
iOS
tvOS
Bu kılavuzda, SDK yaşam döngüsü ve video oynatıcınız, IMA SDK'sı ve bir reklam sunucusu arasındaki etkileşimler hakkında genel bilgiler verilmektedir.
Temel etkileşimler
Aşağıdaki şemada, video oynatıcınız, IMA SDK ve bir reklam sunucusu arasındaki etkileşimler gösterilmekte ve açıklanmaktadır. Reklam sunucusu Ad Manager, Video için AdSense (AFV) veya Ad Exchange'i (AdX) kullanabilir.
Web sayfası veya uygulama, IMA SDK'yı yüklemek için şunları kullanır:
- HTML5 için yerleştirilmiş bir komut dosyası etiketi
- Android, Google Cast, iOS veya tvOS için bir uygulama
IMA SDK, reklam sunucusundaki belirli reklam birimi için bir VAST yanıtı ister. Ad Manager ve AFV veya AdX olabilen çağrılan reklam sunucusu, reklam etiketi URL'si tarafından belirlenir.
Reklam sunucusu en iyi reklamı seçer ve IMA SDK'ya bir VAST yanıtı gönderir.
Reklamlar aşağıdaki yöntemlerden biri kullanılarak seçilir:
- Ad Manager reklam birimi, satır öğesi adaylarını filtreler
- AdSense veya Ad Exchange bir açık artırma yürütür
IMA SDK, VAST yanıtını ayrıştırır, ortama göre doğru medya türünü belirler ve satır içi video reklam öğesini (gerekirse tamamlayıcı reklamlarla birlikte) web sayfasına veya uygulamaya teslim eder.
Video oynatıcı, oynatma ayrıntılarını IMA SDK ile görüşür ve reklamları oynatır.
IMA SDK, gerektiğinde bir gösterim ping'i ve VAST izleme etkinlikleri tetikler.
Yaşam döngüsü
Bu şemada, IMA SDK'nın tam yaşam döngüsü gösterilmektedir. Oluşturucu ve yöntem çağrıları mavi renkle, etkinlikler kırmızı renkle, hata koşulları ise kırmızı bağlayıcılar ve kırmızı metinle vurgulanır.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-31 UTC."],[[["\u003cp\u003eThis guide explains the lifecycle of the Interactive Media Ads (IMA) SDK and how it facilitates communication between your video player, the SDK, and an ad server (Ad Manager, AdSense for Video, or Ad Exchange).\u003c/p\u003e\n"],["\u003cp\u003eThe process involves the IMA SDK requesting ads from the ad server based on the provided ad tag URL, the ad server selecting and sending a VAST response, and the SDK parsing this response to deliver ads to the video player.\u003c/p\u003e\n"],["\u003cp\u003eThe video player then handles ad playback while the IMA SDK manages tracking events like impressions and VAST events for reporting purposes.\u003c/p\u003e\n"],["\u003cp\u003eThis guide also visually illustrates the entire IMA SDK lifecycle including constructor calls, method calls, events, and potential errors.\u003c/p\u003e\n"]]],[],null,["Select platform: [HTML5](/interactive-media-ads/docs/sdks/html5/client-side/architecture \"View this page for the HTML5 platform docs.\") [Android](/interactive-media-ads/docs/sdks/android/client-side/architecture \"View this page for the Android platform docs.\") [iOS](/interactive-media-ads/docs/sdks/ios/client-side/architecture \"View this page for the iOS platform docs.\") [tvOS](/interactive-media-ads/docs/sdks/tvos/client-side/architecture \"View this page for the tvOS platform docs.\")\n\n\u003cbr /\u003e\n\nThis guide provides an overview of the SDK lifecycle and the interactions\nbetween your video player, the IMA SDK, and an ad server.\n\nBasic interactions\n\nThe following diagram illustrates and annotates the interactions between\nyour video player, the IMA SDK, and an ad server. The ad server can use\nAd Manager, AdSense for Video (AFV), or Ad Exchange (AdX).\n\n1. The web page or app loads the IMA SDK using:\n\n - an embedded script tag for HTML5\n - an app for Android, Google Cast, iOS, or tvOS\n2. The IMA SDK requests a VAST Response for the specific Ad Unit on the ad\n server. The ad server called, which can be either Ad Manager versus AFV or\n AdX, is determined by the ad tag URL.\n\n3. The ad server selects the best ad and sends a VAST response to the IMA SDK.\n Ads are selected using one of the following methods:\n\n - Ad Manager Ad Unit filters Line Item candidates\n - AdSense or Ad Exchange runs an auction\n4. The IMA SDK parses the VAST response, determines the correct media type based\n on environment, and delivers the inline video creative (and\n companion ads if needed) to the web page or app.\n\n5. The video player negotiates the playback details with the IMA SDK and plays\n the ads.\n\n6. The IMA SDK fires an impression ping and VAST tracking events, as needed.\n\nLifecycle\n\nThis diagram shows the full lifecycle of the IMA SDK. Constructor and method\ncalls are highlighted in blue, events are highlighted in red, and error\nconditions are shown with red connectors and red text."]]
