Wenn Sie sich mit anderen Nutzern über unsere Produkte austauschen und Feedback geben möchten, treten Sie dem offiziellen Ad Manager-Discord-Kanal auf dem Server der Google Advertising and Measurement Community bei.
Das SDK kann je nach der Anzeigenantwort, die es vom Ad-Server erhält, in einem oder mehreren Modi ausgeführt werden.
Einzelne Anzeige
Eine Anzeige, die jederzeit abgespielt werden kann, wenn die start-Nachricht an die IMAAdsManager gesendet wird. Für die Wiedergabe einer einzelnen Anzeige ist keine spezielle Initialisierung erforderlich.
Anzeigen-Pod
Mehrere Anzeigen, die hintereinander abgespielt werden, wenn die start-Nachricht an die IMAAdsManager gesendet wird. Für die Wiedergabe eines einzelnen Ad-Pods ist keine spezielle Initialisierung erforderlich.
Anzeigenregeln
Eine Playlist mit Werbeunterbrechungen, die für bestimmte Zeiten und bestimmte Inhalte geplant sind. Die Meldung start wird im Modus „Anzeigenregeln“ ignoriert. In einer einzelnen Playlist können mehrere Werbeunterbrechungen geplant werden, z.B. Pre-Roll, Mid-Roll und Post-Roll. Weitere Implementierungsdetails finden Sie unten im Abschnitt Anzeigenregeln.
Anzeigenregeln
Das IMA SDK für iOS unterstützt vollständig automatisierte Anzeigen-Playlists. Bei der Auslieferung Ihrer Anzeigen werden mit dieser Funktion Werbeunterbrechungen in die Inhalte eingefügt, wie in Google Ad Manager angegeben. Außerdem wird der Videoplayer-Code, der für die Unterstützung von Werbeunterbrechungen, einschließlich Pre-Rolls, Mid-Rolls und Post-Rolls, erforderlich ist, erheblich vereinfacht.
Beim Trafficking von Anzeigen in Ad Manager können verschiedene Anzeigenregeln angegeben werden, z. B. „Werbeunterbrechung immer am Anfang des Contents einfügen“ oder „alle 30 Minuten Content eine einminütige Werbeunterbrechung einfügen“.
Wenn Anzeigen angefordert werden, kann der Ad-Server eine Anzeigen-Playlist zurückgeben. Das SDK verarbeitet die Playlist und plant automatisch die angegebenen Werbeunterbrechungen.
Beim Initialisieren von AdsManager wird ein IMAContentPlayhead-Objekt über den initializeWithContentPlayhead:adsRenderingSettings:-Aufruf übergeben. Wenn Sie einen AVPlayer zum Anzeigen Ihrer Inhalte verwenden, übergeben Sie eine Instanz von IMAAVPlayerContentPlayhead an das SDK, wenn Sie adDisplayContainer erstellen. Mit diesem Objekt wird der Fortschritt der Wiedergabe von Inhalten verfolgt, damit Werbeunterbrechungen automatisch zu den in Ad Manager angegebenen Zeiten eingefügt werden.
Implementieren Sie die IMAContentPlayhead-Schnittstelle.
Implementieren Sie currentTime, um die aktuelle Zeit Ihres Videoplayers zurückzugeben.
Ändern Sie den IMAAdsManager-Initialisierungsaufruf so, dass initializeWithContentPlayhead:self verwendet wird.
Das IMAAdsManagerDelegate wird verwendet, um die Wiedergabe von Inhalten während der Werbeunterbrechungen zu pausieren und fortzusetzen.
Hinweis:Wenn die Wiedergabe des Inhalts beendet ist oder der Nutzer die Wiedergabe beendet hat, müssen Sie contentComplete für das IMAAdsLoader aufrufen, um dem SDK zu signalisieren, dass die Wiedergabe des Inhalts beendet ist. Das SDK spielt dann die Post-Roll-Werbeunterbrechung ab, sofern eine geplant wurde.
Das Ereignis ALL_ADS_COMPLETED wird ausgelöst, wenn alle Werbeunterbrechungen abgespielt wurden. Das Tracking von Inhalten beginnt, wenn die Methode initializeWithContentPlayhead:adsRenderingSettings von IMAAdsManager aufgerufen wird. Sie sollten initializeWithContentPlayhead:adsRenderingSettings immer vor der Wiedergabe von Inhalten aufrufen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-06 (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,["Select platform: [HTML5](/interactive-media-ads/docs/sdks/html5/client-side/ad-rules \"View this page for the HTML5 platform docs.\") [Android](/interactive-media-ads/docs/sdks/android/client-side/ad-rules \"View this page for the Android platform docs.\") [iOS](/interactive-media-ads/docs/sdks/ios/client-side/ad-rules \"View this page for the iOS platform docs.\") [tvOS](/interactive-media-ads/docs/sdks/tvos/client-side/ad-rules \"View this page for the tvOS platform docs.\")\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\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\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."]]