ערכות IMA SDK מאפשרות לשלב בקלות מודעות מולטימדיה באתרים ובאפליקציות. IMA SDK יכול לשלוח בקשות להצגת מודעות מכל שרת מודעות שתואם ל-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.
דרישות מוקדמות
לפני שמתחילים, צריך:
- אקסקוד 13 ואילך
- שיטה להתקנת IMA SDK:
- Swift Package Manager (מומלץ)
- CocoaPods
- עותק להורדה של IMA 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 SDK, בוחרים את השיטה המועדפת.
מומלץ: התקנת ה-SDK באמצעות Swift Package Manager
החל מגרסה 3.18.4, Interactive Media Ads SDK תומך ב-Swift Package Manager. כדי לייבא את חבילת Swift, פועלים לפי השלבים הבאים.
ב-Xcode, מתקינים את חבילת ה-Swift של IMA DAI SDK: עוברים אל File > Add Packages (קובץ > הוספת חבילות).
בשורת ההודעה שמופיעה, חפשו את מאגר GitHub של IMA DAI SDK Swift Package:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-iosבחר את גרסת חבילת Swift של IMA DAI SDK שברצונך להשתמש בה. בפרויקטים חדשים, משתמשים באפשרות עד הגרסה הראשית הבאה.
אחרי שתסיימו, פלטפורמת Xcode תטפל ביחסי התלות שבחבילה ותוריד אותם ברקע. לפרטים נוספים על הוספת יחסי תלות בחבילה, אפשר לעיין במאמר של Apple.
התקנת ערכת פיתוח תוכנה IMA DAI באמצעות CocoaPods
CocoaPods הוא כלי לניהול תלויות בפרויקטים של Xcode, שמאפשר להתקין את IMA DAI SDK. מידע נוסף על התקנה או שימוש ב-CocoaPods זמין במאמרי העזרה של CocoaPods. אחרי שמתקינים את CocoaPods, משתמשים בהוראות האלה כדי להתקין את IMA DAI SDK:
באותה תיקייה שבה נמצא הקובץ PodServingExample.xcodeproj, יוצרים קובץ טקסט בשם Podfile ומוסיפים את ההגדרות הבאות:
מהספרייה שמכילה את ה-Podfile, הפעל את:
pod install --repo-update
הורדה והתקנה של ה-SDK באופן ידני
אם אינך מעוניין להשתמש ב-Swift Package Manager, הורד והוסף ידנית את IMA SDK לפרויקט שלך.
יצירת נגן וידאו פשוט
הטמע נגן וידאו בבקר התצוגה הראשי שלך; עטוף נגן AV בתצוגת ממשק משתמש. IMA SDK משתמש בתצוגת ממשק המשתמש כדי להציג רכיבי ממשק משתמש של מודעות.
Objective-C
Swift
אתחול של הכלי לטעינת מודעות
מייבאים את IMA SDK לבקר התצוגה ומאמצים את הפרוטוקולים
IMAAdsLoaderDelegate
ו-
IMAStreamManagerDelegate כדי לטפל באירועים של טוען המודעות ומנהל הסטרימינג.
הוסף את המאפיינים הפרטיים הבאים כדי לאחסן רכיבי IMA SDK מרכזיים:
-
IMAAdsLoader- מנהל בקשות לשידור לאורך משך החיים של האפליקציה. -
IMAAdDisplayContainer– הטיפול בהוספה ובניהול של רכיבי ממשק משתמש של מודעות. -
IMAAVPlayerVideoDisplay– מתקשר בין IMA SDK לבין נגן המדיה ומטפל במטא-נתונים מתוזמנים. -
IMAStreamManager– מנהל את הפעלת הסטרימינג ומפעיל אירועים שקשורים למודעות.
מפעילים את טוען המודעות, את מאגר המודעות ואת תצוגת הווידאו אחרי שהתצוגה נטענת.
Objective-C
Swift
שליחת בקשה לסטרימינג
כשמשתמש לוחץ על לחצן ההפעלה, צריך לשלוח בקשה חדשה להזרמת נתונים.
משתמשים בכיתה
IMAPodStreamRequest
לשידורים חיים. עבור שידורי VOD, השתמשו ב-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
ה-handler המותאם אישית של 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.