המדריך הזה מיועד לבעלי אפליקציות שרוצים להוסיף מודעות נלוות להטמעה של IMA ב-iOS.
דרישות מוקדמות
אפליקציית iOS עם IMA SDK משולב.
תג מודעה שהוגדר להחזיר מודעה נלווית.
אם אתם צריכים דוגמה, אתם יכולים לעיין בשאלות הנפוצות שלנו.
חומרי לימוד מועילים
אם עדיין לא הטמעתם את IMA SDK באפליקציה, כדאי לעיין במדריך למתחילים.
הוספת מודעות משלימות לאפליקציה
יצירת UIView עבור הרכיב הנלווה
לפני שמבקשים ליצור דמות, צריך ליצור בשבילה מקום בפריסה. בסטוריבורד, גוררים תצוגה מקדימה אל ViewController ומשנים את הגודל שלה כך שתתאים למודעה הנלווית. לאחר מכן, מוודאים שמשבצת המודעה הנלווית מקושרת למשתנה בהטמעה (בדוגמה הזו נעשה שימוש במשתנה שנקרא companionView). בצילום המסך שלמטה, התצוגה באפור בהיר היא תצוגת המודעה הנלווית:
יצירת IMACompanionAdSlot
השלב הבא הוא ליצור אובייקט IMACompanionAdSlot מהתצוגה. IMA SDK
מאכלס את משבצת המודעה הנלווית בכל מודעה נלווית מתגובת VAST שיש לה מידות
שמתאימות לגובה ולרוחב של התצוגה. ב-IMA SDK יש גם תמיכה בשימוש במודעות נלוות בגודל משתנה.
ערכת IMA תומכת עכשיו במודעות באנר נלוות דינמיות. גודל המודעות הנלוות האלה יכול להשתנות בהתאם לגודל של מיקום המודעה. הן ממלאות 100% מהרוחב של תצוגת האב, ואז משנות את הגובה שלהן כך שיתאים לתוכן של המודעה הנלווית. הגודל נקבע באמצעות Fluid הגודל של מצב Companion ב-Ad Manager.
בתמונה הבאה אפשר לראות איפה מגדירים את הערך הזה.
עדכון אפליקציות ל-iOS כדי להשתמש בתכונה 'מכשירים משולבים'
כדי להגדיר משבצת מודעה נלווית גמישה, צריך להפעיל את התג
IMACompanionAdSlot
עם הפרמטר view בלבד, בלי הפרמטרים width ו-height.
פעלתי לפי המדריך, אבל לא רואה מודעות נלוות. מה לעשות?
קודם כל, בודקים שהתג באמת מחזיר מודעות משלימות. כדי לעשות את זה, פותחים את התג בדפדפן אינטרנט ומחפשים תג CompanionAds. אם זה קורה, צריך לוודא שהגודל של המודעה הנלווית שמוחזרת זהה לגודל של ה-UIView שבו מנסים להציג אותה.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-09-06 (שעון UTC)."],[[["\u003cp\u003eThis guide helps iOS publishers integrate companion ads using the IMA SDK.\u003c/p\u003e\n"],["\u003cp\u003eYou need an iOS app with the IMA SDK and an ad tag returning companion ads to get started.\u003c/p\u003e\n"],["\u003cp\u003eCreate a UIView for the companion ad and an IMACompanionAdSlot tied to it.\u003c/p\u003e\n"],["\u003cp\u003eInform the SDK about the companion slot by passing it to the IMAAdDisplayContainer.\u003c/p\u003e\n"],["\u003cp\u003eFluid companion ads can be implemented for automatic resizing to fit content.\u003c/p\u003e\n"]]],[],null,["Select platform: [HTML5](/interactive-media-ads/docs/sdks/html5/client-side/companions \"View this page for the HTML5 platform docs.\") [Android](/interactive-media-ads/docs/sdks/android/client-side/companions \"View this page for the Android platform docs.\") [iOS](/interactive-media-ads/docs/sdks/ios/client-side/companions \"View this page for the iOS platform docs.\")\n\nThis guide is intended for publishers interested in adding companion ads to their iOS IMA implementation.\n\nPrerequisites\n\n- iOS Application with the IMA SDK integrated.\n- An ad tag configured to return a companion ad.\n - If you need a sample, check out our [FAQ](/interactive-media-ads/docs/sdks/ios/client-side/faq#4).\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\nAdd companion ads to your app\n\nCreate a UIView for your companion\n\nBefore requesting a companion, you need to create a space for it in your layout. In your storyboard, drag and drop a View onto your `ViewController` and size it to your companion ad. Then, make sure your companion slot is tied to a variable in your implementation (this example uses a variable called companionView). In the screenshot below, the light gray view is the companion ad view:\n\nCreate an IMACompanionAdSlot\n\nThe next step is to build an IMACompanionAdSlot object from your view. The IMA SDK\npopulates the companion ad slot with any companions from the VAST response that have dimensions\nmatching the view's height and width. The IMA SDK also supports using\n[fluid sized companions](/interactive-media-ads/docs/sdks/ios/client-side/companions#display-fluid-companion-ads).\n**ViewController.h** \n\n```transact-sql\n@property(nonatomic, weak) IBOutlet UIView *companionView;\n```\n**ViewController.m** \n\n```objective-c\nself.companionSlot =\n [[IMACompanionAdSlot alloc] initWithView:self.companionView\n width:self.companionView.frame.size.width\n height:self.companionView.frame.size.height];\n```\n\nPass the companion ad slot to your ad container\n\nLastly, you need to let the SDK know that this companion slot exists by passing an array of your companion slots to the `IMAAdDisplayContainer` constructor:\n**ViewController.m** \n\n```objective-c\nreturn [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView\n viewController:self\n companionSlots:@[ self.companionSlot ]];\n```\n\nThat's all there is to it! Your application is now displaying companion ads.\n\nDisplay fluid companion ads\n\nIMA now supports fluid companion ads. These companions ads can resize to match the size of\nthe ad slot. They fill 100% of the width of parent view, then resize their height to fit the\ncompanion's content. They're set by using the `Fluid` companion size in Ad Manager.\nSee the following image for where to set this value.\n\nUpdate iOS apps for fluid companions\n\nYou can declare a fluid companion slot by initiating the\n[`IMACompanionAdSlot`](/interactive-media-ads/docs/sdks/ios/client-side/reference/Classes/IMACompanionAdSlot#-initwithview:)\nwith only the `view` parameter; excluding `width` and\n`height`.\n**ViewController.m** \n\n```objective-c\nself.companionSlot =\n [[IMACompanionAdSlot alloc] initWithView:self.companionView];\n```\n\nFAQ\n\nI followed the guide, but I'm not seeing companion ads. What should I do?\n: First, check to make sure your tag really is returning companions. To do this, open the tag in a web browser and look for a CompanionAds tag. If you see that, check to make sure the size of the companion being returned is the same size as the UIView in which you're trying to display it."]]
