Reklam arası oynatmayı yapılandırma
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Platform seçin:
Android
iOS
Bu kılavuz, reklam arası oynatma zamanlaması üzerinde manuel kontrol sahibi olmak isteyen kullanıcılar için hazırlanmıştır. Varsayılan uygulamada SDK, ara reklamları planlanan zamanda otomatik olarak oynatır. Bazı geliştiriciler, SDK'nın bu reklam aralarını otomatik olarak oynatmasını engellemek isteyebilir. Manuel reklam arası oynatma uygulandığında SDK, bir ara reklam yüklendiğinde AD_BREAK_READY
etkinliğini tetikler ve aranın oynatılmasını başlatmanızı bekler.
Ön koşullar
- IMA SDK'nın uygulandığı iOS uygulaması.
Faydalı başlangıç kılavuzları
IMA SDK'yı uygulamanıza henüz eklemediyseniz Başlangıç kılavuzumuza göz atın.
Manuel reklam arası oynatmayı yapılandırmak üç adımda gerçekleştirilir:
- SDK'ya reklam arası oynatmayı kontrol etmek istediğinizi söyleyin.
- AD_BREAK_READY etkinliğini dinleyin.
- Hazır olduğunuzda SDK'ya reklam oynatmasını söyleyin.
Aşağıdaki snippet'te, manuel reklam arası oynatmayı uygulamak için
Gelişmiş Örnek'te yapılması gereken değişiklikler gösterilmektedir:
- (void)setUpAdsLoader {
...
IMASettings settings = [[IMASettings alloc] init];
// Tell the SDK that you want to control ad break playback.
settings.autoPlayAdBreaks = NO;
self.adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];
...
}
- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {
...
switch (event.type) {
// Listen for the AD_BREAK_READY event
case kIMAAdEvent_AD_BREAK_READY:
// Tell the SDK to play ads when you're ready. To skip this ad break,
// simply return from this handler without calling [adsManager start].
[adsManager start];
break;
...
}
}
SSS
- Bu, IMA SDK uygulaması için gerekli mi?
- Kesinlikle hayır. Bu özellik yalnızca IMA SDK'nın, reklam kurallarınız veya VMAP yanıtınız tarafından planlandığında orta rulo reklamları otomatik olarak oynatmasını istemeyen yayıncılar için sunulur.
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 how to manually control ad break playback timing within the IMA SDK for iOS apps, preventing automatic mid-roll playback.\u003c/p\u003e\n"],["\u003cp\u003eBy implementing manual ad break playback, developers can trigger mid-roll ads using the \u003ccode\u003eAD_BREAK_READY\u003c/code\u003e event and the \u003ccode\u003estart\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is optional and intended for publishers seeking greater control over ad playback timing, requiring code modifications to the IMA SDK setup and event handling.\u003c/p\u003e\n"],["\u003cp\u003eManual ad break playback involves three steps: disabling automatic ad breaks, listening for the \u003ccode\u003eAD_BREAK_READY\u003c/code\u003e event, and initiating ad playback when desired.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/interactive-media-ads/docs/sdks/android/client-side/manual_ad_playback \"View this page for the Android platform docs.\") [iOS](/interactive-media-ads/docs/sdks/ios/client-side/manual_ad_playback \"View this page for the iOS platform docs.\")\n\nThis guide is intended for users who want manual control over ad break playback timing. In a default implementation, the SDK automatically plays mid-rolls at their scheduled time. Some developers may want to prevent the SDK from playing these ad breaks automatically. By implementing manual ad break playback, the SDK fires an `AD_BREAK_READY` event when a mid-roll has been loaded, and wait on you to start the break's playback.\n\nPrerequisites\n\n\u003cbr /\u003e\n\n- iOS application with the IMA SDK implemented.\n\n\u003cbr /\u003e\n\nHelpful primers\n\nIf you still need to implement the IMA SDK in your app, check out our [Get Started guide](/interactive-media-ads/docs/sdks/ios/client-side).\n\nConfiguring Manual Ad Break Playback Configuring manual ad break playback takes three steps: \n\n1. Tell the SDK you want to control ad break playback.\n2. Listen for the AD_BREAK_READY event.\n3. Tell the SDK to play ads when you're ready.\n\nThe snippet below shows the modifications required on the [Advanced Example](//github.com/googleads/googleads-ima-ios/tree/master/Objective-C/AdvancedExample) to implement manual ad break playback: \n\n```objective-c\n- (void)setUpAdsLoader {\n ...\n IMASettings settings = [[IMASettings alloc] init];\n // Tell the SDK that you want to control ad break playback.\n settings.autoPlayAdBreaks = NO;\n self.adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];\n ...\n}\n\n- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {\n ...\n switch (event.type) {\n // Listen for the AD_BREAK_READY event\n case kIMAAdEvent_AD_BREAK_READY:\n // Tell the SDK to play ads when you're ready. To skip this ad break,\n // simply return from this handler without calling [adsManager start].\n [adsManager start];\n break;\n ...\n }\n}\n```\n\nFAQ\n\nIs this required for an IMA SDK implementation?\n: Absolutely not! This is only offered for publishers who do not want the IMA SDK to automatically play mid-roll ads when they are scheduled by your ad rules or VMAP response."]]