Ürünlerimiz hakkında görüşlerinizi paylaşmak ve geri bildirimde bulunmak için Google Advertising and Measurement Community sunucusundaki resmi Ad Manager Discord kanalına katılın.
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
SDK işlem modları
SDK, reklamdan aldığı reklam yanıtına bağlı olarak bir veya daha fazla modda çalışabilir
sunucu.
Tek reklam
Aşağıdaki durumlarda herhangi bir zamanda oynatılabilecek reklam: start
ileti IMAAdsManager numaralı telefona gönderildi. Özel başlatma yok
tek bir reklam oynatmak için gerekir.
Reklam kapsülü
start mesajı şu numaraya gönderildiğinde art arda oynatılan çeşitli reklamlar:
IMAAdsManager. Aşağıdaki işlemler için özel başlatma gerekmez:
bir reklam kapsülünü oynatır.
Reklam kuralları
Belirli zamanlarda, belirli bir zamana göre planlanmış reklam aralarından oluşan bir oynatma listesi
içerik. start mesajı, reklam kuralları modunda yoksayılır. Her biri 100'den az gösterim alan
Tek bir oynatma listesinde planlanmış birden fazla reklam arası olmamalıdır (ör. videodan önce gösterilen reklamlar,
videonun ortasında gösterilen reklam, videodan sonra gösterilen reklam). Uygulamayla ilgili daha fazla bilgi için bkz.
Reklam Kuralları bölümünü inceleyin.
Reklam kuralları
IMA iOS
SDK, tam otomatik reklam oynatma listelerini destekler. Bu özellik
belirtildiği gibi içeriğe reklam araları ekler.
Google Ad Manager
göz önünde bulundurmanız gerekir. Ayrıca video oynatıcı kodunu
büyük ölçüde basitleştiriyor,
Videodan önce, videonun ortasında ve videodan sonra gösterilen reklamlar dahil olmak üzere reklam aralarını desteklemek için gereklidir.
Ad Manager'da reklamları trafiğe eklerken çeşitli reklam kuralları belirtmek mümkündür
Örneğin, "reklam arası her zaman içeriğin başında oynatılsın" veya "bir dakikalık reklam arası oynat"
her 30 dakikada bir içerik yayınlanması".
Reklamlar istendiğinde, reklam sunucusu bir reklam oynatma listesi döndürebilir. SDK
oynatma listesini işler ve önceden ayarlanmış olan reklam aralarını otomatik olarak
belirtiliyor.
AdsManager başlatılırken IMAContentPlayhead
nesne, initializeWithContentPlayhead:adsRenderingSettings: aracılığıyla aktarılır
çağrısına bir tıklama URL'si eklemeniz gerekir. İçeriğinizi görüntülemek için bir AVPlayer kullanıyorsanız
IMAAVPlayerContentPlayhead örneğini SDK'ya ekleyebilirsiniz.
adDisplayContainer. Bu nesne, bir reklamın gösterilmesi için içerik oynatmasının ilerlemesini
aralar, Ad Manager'da belirtilen zamanlarda otomatik olarak eklenir.
Saatinizin şu anki saatini döndürmek için currentTime
video oynatıcıya gidin.
IMAAdsManager başlatma çağrısını şu şekilde değiştir:
initializeWithContentPlayhead:self kullanın.
IMAAdsManagerDelegate
reklam araları oynatıldığında içeriği duraklatmak ve devam ettirmek için kullanılır.
Not: İçeriğin oynatılması bittiğinde veya
kullanıcı oynatmayı durdurdu. contentComplete işlevini çağırdığınızdan emin olun
SDK'ya içeriğin uygun olduğunu bildirmek için IMAAdsLoader üzerinde
çalmayı bitirdi. Ardından SDK, videodan sonra gösterilen reklam arasını (planlanmışsa) oynatır.
Tüm reklam araları şu durumlarda olduğunda ALL_ADS_COMPLETED etkinliği tetiklenir:
oynandı. Ayrıca içerik izlemenin
IMAAdsManager adlı çocuğun initializeWithContentPlayhead:adsRenderingSettings cihazı
yöntemi çağrıldığı için her zaman initializeWithContentPlayhead:adsRenderingSettings yöntemini çağırmalısınız.
kontrol edin.
[null,null,["Son güncelleme tarihi: 2025-08-31 UTC."],[[["\u003cp\u003eThe Google IMA iOS SDK allows you to integrate ads into your video content using a WebView for ad requests, parsing, tracking, and rendering.\u003c/p\u003e\n"],["\u003cp\u003eIt supports three main operation modes: single ad, ad pod (multiple ads played back-to-back), and ad rules for scheduled ad breaks.\u003c/p\u003e\n"],["\u003cp\u003eAd rules simplify ad integration by automating ad playlist management based on Google Ad Manager settings, requiring an \u003ccode\u003eIMAContentPlayhead\u003c/code\u003e for content tracking.\u003c/p\u003e\n"],["\u003cp\u003eThe SDK utilizes the \u003ccode\u003eIMAAdsManagerDelegate\u003c/code\u003e to control content playback during ad breaks and requires signaling content completion via \u003ccode\u003econtentComplete\u003c/code\u003e for post-roll ads.\u003c/p\u003e\n"]]],[],null,["# Automate ad playlists\n\n| **Note:** The iOS SDK uses a WebView to load a JavaScript back end. This WebView is used to make ad requests, parse responses, ping tracking URLs, and render the ad UI.\n\nSDK operation modes\n-------------------\n\nThe SDK can operate in one or more modes, depending on the ad response it receives from the ad\nserver.\n\nSingle ad\n: An ad that can be played at any time when the `start`\n message is sent to the `IMAAdsManager`. No special initialization\n is necessary to play a single ad.\n:\n\nAd pod\n: Several ads that play back to back when the `start` message is sent to\n the `IMAAdsManager`. No special initialization is necessary to\n play a single ad pod.\n\nAd rules\n: A playlist of ad breaks scheduled at certain times against particular\n content. The `start` message is ignored in ad rules mode. There can\n be several ad breaks scheduled within a single playlist (e.g., pre-roll,\n mid-roll, post-roll). For further implementation details, see the\n [Ad Rules](#ad-rules) section below.\n\nAd rules\n--------\n\nIMA iOS\nSDK supports fully automated ad playlists. This feature\ninserts ad breaks into the content as specified in\n[Google Ad Manager](//admanager.google.com/)\nwhen trafficking your ads. It also greatly simplifies the video player code\nnecessary to support ad breaks, including pre-rolls, mid-rolls, and post-rolls.\n\n- When trafficking ads in Ad Manager, it is possible to specify various ad rules like \"always play ad break at the beginning of the content\" or \"play a one-minute ad break every 30 minutes of content\".\n- When ads are requested, the ad server can return an ad playlist. The SDK processes the playlist and automatically schedules the ad breaks that have been specified.\n- When initializing the `AdsManager`, an `IMAContentPlayhead` object is passed in via the `initializeWithContentPlayhead:adsRenderingSettings:` call. If you are using an AVPlayer to display your content, you pass an instance of `IMAAVPlayerContentPlayhead` to the SDK when you create your `adDisplayContainer`. This object is used to track the progress of the content playback so ad breaks are automatically inserted at the times specified in Ad Manager. \n\n **With AVPlayer:** \n\n ```objective-c\n IMAContentPlayhead *contentPlayhead =\n [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer];\n IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl\n adDisplayContainer:adDisplayContainer\n contentPlayhead:contentPlayhead\n userContext:nil];\n ```\n\n **Without AVPlayer:**\n 1. Implement the `IMAContentPlayhead` interface.\n 2. Implement `currentTime` to return the current time of your video player.\n 3. Change the `IMAAdsManager` initialization call to use `initializeWithContentPlayhead:self`.\n- The [IMAAdsManagerDelegate](/interactive-media-ads/docs/sdks/ios/client-side/reference/Protocols/IMAAdsManagerDelegate) is used to pause and resume the content as ad breaks are played.\n\n**Note:** When the content has finished playing or\nthe user has stopped playback, be sure to call `contentComplete`\non the `IMAAdsLoader` in order to signal to the SDK that the content\nhas finished playing. The SDK then plays the post-roll ad break, if one has been scheduled.\nThe `ALL_ADS_COMPLETED` event is raised when all ad breaks have\nbeen played. In addition, note that content tracking begins when\n`IMAAdsManager`'s `initializeWithContentPlayhead:adsRenderingSettings`\nmethod is called and you should always call `initializeWithContentPlayhead:adsRenderingSettings`\nbefore playing content."]]
