קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מצבי הפעולה של ה-SDK
ערכת ה-SDK יכולה לפעול במצב אחד או יותר, בהתאם לתגובה שהיא מקבלת מהמודעה.
השרת.
מודעה יחידה
מודעה שאפשר להפעיל בכל שלב כאשר start
הודעה נשלחת לIMAAdsManager. ללא אתחול מיוחד
יש צורך כדי להפעיל מודעה יחידה.
רצף מודעות
כמה מודעות שמופעלות ללא הפסקה כשהודעת ה-start נשלחת אל
IMAAdsManager. לא נדרש אתחול מיוחד כדי
להפעיל רצף מודעות אחד.
כללי מודעות
פלייליסט של הפסקות למודעות שתוזמנו בזמנים מסוימים בהתאם ל:
תוכן. במצב כללי מודעות, המערכת מתעלמת מההודעה start. אפשר
להיות מספר הפסקות למודעות שתוזמנו בפלייליסט יחיד (למשל, לפני סרטון (pre-roll),
באמצע סרטון (mid-roll) או בסוף סרטון (post-roll). פרטים נוספים על ההטמעה זמינים במאמר
בקטע כללי מודעות שבהמשך.
כללי מודעות
IMA iOS
ערכת ה-SDK תומכת בפלייליסטים אוטומטיים לחלוטין של מודעות. התכונה הזו
מוסיפה הפסקות למודעות בתוכן,
Google Ad Manager
בזמן ניהול הטראפיק למודעות שלכם. הוא גם מפשט משמעותית את הקוד של נגן הווידאו
שנדרשות כדי לתמוך בהפסקות למודעות, כולל מודעות לפני הסרטון (pre-roll), מודעות באמצע הסרטון (mid-roll) ומודעות בסוף הסרטון (post-roll).
בניהול הטראפיק של מודעות ב-Ad Manager, אפשר לציין כללים שונים של מודעות
כמו "תמיד להפעיל את ההפסקה למודעות בתחילת התוכן" או "הפעלת הפסקה למודעה למשך דקה אחת"
כל 30 דקות של תוכן".
כשנשלחת בקשה להצגת מודעות, שרת המודעות יכול להחזיר פלייליסט של מודעות. ה-SDK
מעבד את הפלייליסט ומתזמנ אוטומטית את ההפסקות למודעות
שצוין.
באתחול AdsManager, IMAContentPlayhead
שהאובייקט מועבר דרך initializeWithContentPlayhead:adsRenderingSettings:
שיחה. אם אתם משתמשים ב-AVPlayer כדי להציג את התוכן שלכם, עליכם להעביר
מופע של IMAAVPlayerContentPlayhead ל-SDK בזמן היצירה
adDisplayContainer. האובייקט הזה משמש למעקב אחרי התקדמות הפעלת התוכן, אז מודעה
ההפסקות למודעות נוספות אוטומטית בשעות שמצוינות ב-Ad Manager.
הטמעה של currentTime כדי להחזיר את השעה הנוכחית
נגן הווידאו.
שינוי קריאת האתחול IMAAdsManager ל-
להשתמש ב-initializeWithContentPlayhead:self.
נציג IMAAdsManagerDelegate
משמש להשהיה ולהמשך של הצגת התוכן בזמן הפעלת ההפסקות למודעות.
הערה: כשהפעלת התוכן תסתיים, או
המשתמש הפסיק את ההפעלה, יש להתקשר אל contentComplete
ב-IMAAdsLoader כדי לאותת ל-SDK שהתוכן
סיימת לשחק. לאחר מכן, ערכת ה-SDK מפעילה את ההפסקה למודעה בסוף הסרטון, אם תוזמנה הפסקה כזו.
האירוע ALL_ADS_COMPLETED מוגדל אם בכל ההפסקות למודעות יש
הופעלו. כמו כן, חשוב לזכור שהמעקב אחר התוכן מתחיל בתאריך
מכשיר initializeWithContentPlayhead:adsRenderingSettings של IMAAdsManager
קוראים ל-method ותמיד צריך לקרוא ל-initializeWithContentPlayhead:adsRenderingSettings
לפני שמפעילים את התוכן.
[null,null,["עדכון אחרון: 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."]]
