ערכות IMA SDK מאפשרות לשלב בקלות מודעות מולטימדיה באתרים ובאפליקציות. IMA SDKs יכולים לשלוח בקשות למודעות מכל שרת מודעות שתואם ל-VAST ולנהל את ההפעלה של המודעות באפליקציות. באמצעות IMA DAI SDK, האפליקציות שולחות בקשה לסטרימינג של מודעות ותוכן וידאו – תוכן VOD או תוכן בשידור חי. לאחר מכן, ה-SDK מחזיר זרם וידאו משולב, כך שלא צריך לנהל את המעבר בין מודעה לתוכן וידאו באפליקציה.
בחירת פתרון DAI שמעניין אתכם
הצגת DAI ב-Pod
במדריך הזה מוסבר איך לשלב את IMA DAI SDK באפליקציית נגן וידאו פשוטה. אם אתם רוצים לראות או לעקוב אחרי שילוב לדוגמה, אתם יכולים להוריד את PodServingExample מ-GitHub.
סקירה כללית על IMA DAI
הטמעה של IMA DAI כוללת ארבעה רכיבי SDK עיקריים, כפי שמוסבר במדריך הזה:
-
IMAAdDisplayContainer
– אובייקט קונטיינר שמוצב מעל רכיב הפעלת הווידאו ומכיל את רכיבי ממשק המשתמש של המודעה. -
IMAAdsLoader
– אובייקט שמבקש סטרימינג ומטפל באירועים שמופעלים על ידי אובייקטים של תגובות לבקשות סטרימינג. צריך ליצור רק מופע אחד של הכלי לטעינת מודעות, שאפשר לעשות בו שימוש חוזר לאורך חיי האפליקציה. -
IMAStreamRequest
–IMAPodVODStreamRequest
אוIMAPodStreamRequest
. -
IMAStreamManager
– אובייקט שמטפל בסטרימינג של הטמעת מודעות דינמיות ובאינטראקציות עם ה-Backend של DAI. מנהל השידור מטפל גם בפינגים למעקב ומעביר אירועים שקשורים לשידור ולמודעות אל בעל התוכן הדיגיטלי.
בנוסף, כדי להפעיל סטרימינג של פודים של מודעות, צריך להטמיע handler מותאם אישית של VTP. ה-handler המותאם אישית של VTP שולח את מזהה הסטרים לשותף הטכני של הווידאו (VTP) יחד עם כל מידע אחר שנדרש לו כדי להחזיר מניפסט של סטרים שמכיל גם תוכן וגם מודעות ששולבו בו. ספק ה-VTP יספק הוראות להטמעה של רכיב ה-handler המותאם אישית של ה-VTP.
דרישות מוקדמות
לפני שמתחילים, צריך:
- Xcode 13 ואילך
- CocoaPods (מומלץ), Swift Package Manager או עותק להורדה של IMA DAI SDK ל-iOS
צריך גם את הפרמטרים שמשמשים לשליחת בקשה לסטרימינג מ-IMA SDK.
פרמטרים של שידורים חיים | |
---|---|
קוד רשת |
קוד הרשת של חשבון Ad Manager 360. |
Custom Asset Key |
המפתח של נכס בהתאמה אישית שמזהה את אירוע הצגת המודעות ב-Ad Manager 360. יכול להיות שהקובץ הזה נוצר על ידי כלי לשינוי מניפסט או על ידי שותף צד שלישי להצגת מודעות בפודקאסטים. |
פרמטרים של שידורי VOD | |
קוד רשת |
קוד הרשת של חשבון Ad Manager 360. |
יצירת פרויקט חדש ב-Xcode
ב-Xcode, יוצרים פרויקט חדש ל-iOS באמצעות Objective-C בשם PodServingExample.
הוספת IMA DAI SDK לפרויקט Xcode
אפשר להשתמש באחת משלוש השיטות הבאות כדי להתקין את IMA DAI SDK.
התקנת ה-SDK באמצעות CocoaPods (מומלץ)
CocoaPods הוא כלי לניהול תלות בפרויקטים של Xcode, והוא השיטה המומלצת להתקנת IMA DAI SDK. מידע נוסף על התקנה או שימוש ב-CocoaPods זמין במאמרי העזרה של CocoaPods. אחרי שמתקינים את CocoaPods, משתמשים בהוראות הבאות כדי להתקין את IMA DAI SDK:
באותה תיקייה שבה נמצא הקובץ PodServingExample.xcodeproj, יוצרים קובץ טקסט בשם Podfile ומוסיפים את ההגדרות הבאות:
בספרייה שמכילה את קובץ ה-Podfile, מריצים את הפקודה:
pod install --repo-update
התקנת ה-SDK באמצעות Swift Package Manager
החל מגרסה 3.18.4, Interactive Media Ads SDK תומך ב-Swift Package Manager. כדי לייבא את חבילת Swift, פועלים לפי השלבים הבאים.
ב-Xcode, מתקינים את חבילת ה-Swift של IMA DAI SDK. לשם כך, עוברים אל File > Add Packages (קובץ > הוספת חבילות).
בהנחיה שמופיעה, מחפשים את מאגר IMA DAI SDK Swift Package GitHub:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-ios
בוחרים את הגרסה של IMA DAI SDK Swift Package שרוצים להשתמש בה. לפרויקטים חדשים, מומלץ להשתמש באפשרות עד הגרסה הראשית הבאה.
אחרי שתסיימו, פלטפורמת Xcode תטפל ביחסי התלות שבחבילה ותוריד אותם ברקע. לפרטים נוספים על הוספת תלות בחבילות, אפשר לעיין במאמר של Apple.
הורדה והתקנה של ה-SDK באופן ידני
אם אתם לא רוצים להשתמש ב-Swift Package Manager או ב-CocoaPods, אתם יכולים להוריד את IMA DAI SDK ולהוסיף אותו לפרויקט באופן ידני.
יצירת נגן וידאו פשוט
מטמיעים נגן וידאו בבקר התצוגה הראשי, באמצעות נגן AV שעטוף בתצוגת ממשק משתמש. IMA SDK משתמש בתצוגת ממשק המשתמש כדי להציג רכיבי ממשק משתמש של מודעות.
Objective-C
Swift
אתחול של הכלי לטעינת מודעות
מייבאים את IMA SDK לבקר התצוגה ומאמצים את הפרוטוקולים
IMAAdsLoaderDelegate
ו-
IMAStreamManagerDelegate
כדי לטפל באירועים של טוען המודעות ומנהל הסטרימינג.
מוסיפים את המאפיינים הפרטיים האלה כדי לאחסן רכיבים מרכזיים של IMA SDK:
-
IMAAdsLoader
– מנהל את בקשות הסטרימינג במהלך מחזור החיים של האפליקציה. -
IMAAdDisplayContainer
– מטפל בהוספה ובניהול של רכיבי ממשק משתמש של מודעות. -
IMAAVPlayerVideoDisplay
- מתקשר בין IMA SDK לבין נגן המדיה ומטפל במטא-נתונים מתוזמנים. -
IMAStreamManager
– מנהל את ההפעלה של הסטרימינג ומפעיל אירועים שקשורים למודעות.
מפעילים את טוען המודעות, את מאגר המודעות ואת תצוגת הווידאו אחרי שהתצוגה נטענת.
Objective-C
Swift
שליחת בקשה לסטרימינג
כשמשתמש לוחץ על לחצן ההפעלה, צריך לשלוח בקשה חדשה לשידור.
משתמשים בכיתה
IMAPodStreamRequest
לשידורים חיים. לשידורים של סרטונים על פי דרישה, משתמשים במחלקה IMAPodVODStreamRequest
.
בקשת הסטרימינג דורשת את פרמטרי הסטרימינג, וגם הפניה אל מאגר התצוגה של המודעות ואל תצוגת הווידאו.
Objective-C
Swift
האזנה לאירועי טעינה של שידור
הקלאס IMAAdsLoader
קורא למתודות IMAAdsLoaderDelegate
אם האתחול מצליח או אם בקשת הסטרימינג נכשלת.
בשיטת ההעברה adsLoadedWithData
, מגדירים את IMAStreamManagerDelegate
.
מעבירים את מזהה מקור הנתונים ל-handler של VTP בהתאמה אישית, ומאחזרים את כתובת ה-URL של מניפסט מקור הנתונים. בשידורים חיים, טוענים את כתובת ה-URL של המניפסט לתצוגת הווידאו ומתחילים בהפעלה. לשידורי VOD, מעבירים את כתובת ה-URL של המניפסט לשיטה loadThirdPartyStream
של מנהל השידורים. בשיטה הזו נשלחת בקשה לנתוני אירועים של מודעות מ-Ad Manager 360, ואז נטען מניפסט כתובת ה-URL ומתחילה ההפעלה.
בשיטת הנציג failedWithErrorData
, מתעדים את השגיאה. אפשר גם להפעיל את הסטרימינג של הגיבוי. שיטות מומלצות ל-DAI
Objective-C
Swift
הטמעה של handler מותאם אישית של VTP
הפונקציה לטיפול ב-VTP בהתאמה אישית שולחת את מזהה הסטרים של הצופה לשותף הטכני שלכם לסרטונים (VTP), יחד עם כל מידע אחר שה-VTP דורש כדי להחזיר מניפסט של הסטרים שמכיל גם תוכן וגם מודעות ששולבו בו. ספק ה-VTP שלכם יספק הוראות ספציפיות להטמעה של רכיב ה-VTP המותאם אישית.
לדוגמה, תבנית VTP עשויה לכלול כתובת URL של תבנית מניפסט שמכילה את המאקרו
[[STREAMID]]
. בדוגמה הזו, פונקציית ה-handler מוסיפה את מזהה הסטרים במקום המאקרו ומחזירה את כתובת ה-URL של המניפסט שנוצר.
Objective-C
Swift
האזנה לאירועים שקשורים למודעות
הפונקציה IMAStreamManager
קוראת לשיטות IMAStreamManagerDelegate
כדי להעביר אירועים ושגיאות של הזרמת נתונים לאפליקציה.
בדוגמה הזו, נרשום ביומן את אירועי המודעות העיקריים במסוף:
Objective-C
Swift
מחיקה של נכסי IMA DAI
כדי להפסיק את הפעלת הסטרימינג, להפסיק את כל המעקב אחר מודעות ולשחרר את כל נכסי הסטרימינג שנטענו, צריך להתקשר אל IMAStreamManager.destroy()
.
מפעילים את האפליקציה, ואם הפעולה מצליחה, אפשר לבקש ולהפעיל סטרימינג של DAI ב-Google באמצעות IMA SDK. כדי לקבל מידע על תכונות מתקדמות יותר של SDK, אפשר לעיין במדריכים אחרים שמופיעים בסרגל הצד הימני או בדוגמאות ב-GitHub.