ערכות ה-SDK של IMA מאפשרות לשלב בקלות מודעות מולטימדיה באתרים ובאפליקציות. ערכות ה-SDK של IMA יכולות לבקש מודעות מכל שרת מודעות שתואם ל-VAST ולנהל את ההפעלה של המודעות באפליקציות. באמצעות ערכות ה-SDK של IMA DAI, האפליקציות שולחות בקשה לשידור של מודעת וידאו ותוכן וידאו – VOD או תוכן בשידור חי. לאחר מכן, ה-SDK מחזיר שידור וידאו משולב, כך שלא תצטרכו לנהל את המעבר בין סרטון המודעה לסרטון התוכן באפליקציה.
בחירת פתרון ה-DAI הרצוי
שירות DAI מלא
המדריך הזה מראה איך לשלב את IMA DAI SDK באפליקציית נגן וידאו פשוטה. אם אתם רוצים לראות דוגמה לשילוב מלא או לפעול לפיה, תוכלו להוריד את BasicExample מ-GitHub.
סקירה כללית על הטמעת מודעות דינמיות (DAI) ב-IMA
הטמעת IMA DAI כוללת ארבעה רכיבים עיקריים של SDK, כפי שמתואר במדריך הזה:
IMAAdDisplayContainer
– אובייקט קונטיינר שנמצא מעל אלמנט ההפעלה של הסרטון ומכיל את רכיבי ממשק המשתמש של המודעה.IMAAdsLoader
– אובייקט שמבקש שידורים ומטפל באירועים שמופעל על ידי אובייקטים של תגובות לבקשות של שידורים. צריך ליצור רק אובייקט אחד של Ads Loader, שאפשר לעשות בו שימוש חוזר לאורך כל חיי האפליקציה.IMAStreamRequest
– הערך יכול להיותIMAVODStreamRequest
אוIMALiveStreamRequest
. אובייקט שמגדיר בקשת סטרימינג. בקשות להפעלת שידורים יכולות להיות לשידורים חיים או לשידורים לפי דרישה. הבקשות כוללות מזהה תוכן, מפתח API או אסימון אימות ופרמטרים אחרים.IMAStreamManager
– אובייקט שמטפל בזרמים של הטמעת מודעות דינמיות ובאינטראקציות עם הקצה העורפי של DAI. מנהל הסטרימינג מטפל גם בפניות מעקב (ping) ומעביר אירועי סטרימינג ומודעות לבעלי התוכן הדיגיטלי.
דרישות מוקדמות
לפני שמתחילים, צריך את הדברים הבאים:
- Xcode מגרסה 13 ואילך
- CocoaPods (מומלץ), Swift Package Manager או עותק שהורדתם של IMA DAI SDK ל-iOS
צריך גם את הפרמטרים שמשמשים לשליחת בקשה לסטרימינג מ-IMA SDK. דוגמאות לפרמטרים של בקשות מפורטות במאמר מקורות נתונים לדוגמה.
פרמטרים של שידורים חיים | |
---|---|
מפתח נכס |
מפתח הנכס שמזהה את השידור החי ב-Google Ad Manager. דוגמה: c-rArva4ShKVIAkNfy6HUQ
|
פרמטרים של סטרימינג של VOD | |
מזהה של מקור התוכן |
מזהה מקור התוכן מ-Google Ad Manager. דוגמה: 2548831
|
מזהה סרטון |
מזהה הסרטון מ-Google Ad Manager. דוגמה: tears-of-steel
|
יצירת פרויקט חדש ב-Xcode
ב-Xcode, יוצרים פרויקט iOS חדש באמצעות Objective-C. נותנים לפרויקט את השם BasicExample.
הוספת IMA DAI SDK לפרויקט Xcode
אפשר להשתמש באחת משלוש השיטות הבאות כדי להתקין את IMA DAI SDK.
התקנת ה-SDK באמצעות CocoaPods (האפשרות המועדפת)
CocoaPods הוא מנהל יחסי תלות לפרויקטים ב-Xcode, והוא השיטה המומלצת להתקנת IMA DAI SDK. מידע נוסף על התקנה של CocoaPods או על שימוש בו זמין במסמכי העזרה של CocoaPods. אחרי שתתקינו את CocoaPods, תוכלו להשתמש בהוראות הבאות כדי להתקין את IMA DAI SDK:
באותה ספרייה שבה נמצא הקובץ BasicExample.xcodeproj, יוצרים קובץ טקסט בשם Podfile ומוסיפים את ההגדרות הבאות:
בתיקייה שמכילה את Podfile, מריצים את הפקודה:
pod install --repo-update`
כדי לוודא שההתקנה בוצעה בהצלחה, פותחים את הקובץ BasicExample.xcworkspace ומוודאים שהוא מכיל שני פרויקטים: BasicExample ו-Pods (היחסי התלות שהותקנו על ידי CocoaPods).
התקנת ה-SDK באמצעות Swift Package Manager
Interactive Media Ads SDK תומך ב-Swift Package Manager החל מגרסה 3.18.4. כדי לייבא את חבילת 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
בוחרים את הגרסה של חבילת Swift של IMA DAI SDK שבה רוצים להשתמש. בפרויקטים חדשים, מומלץ להשתמש באפשרות עד לגרסה הראשית הבאה.
בסיום, Xcode פותר את יחסי התלות בחבילות ומוריד אותן ברקע. למידע נוסף על הוספת יחסי תלות בין חבילות, אפשר לעיין במאמר של Apple.
הורדה והתקנה ידניות של ה-SDK
אם אתם לא רוצים להשתמש ב-Swift Package Manager או ב-CocoaPods, תוכלו להוריד את IMA DAI SDK ולהוסיף אותו לפרויקט באופן ידני.
יצירת נגן וידאו פשוט
הטמעת נגן וידאו ב-View Controller הראשי באמצעות נגן AV שמקובץ בתצוגת UI. מערכת IMA SDK משתמשת בתצוגת ממשק המשתמש כדי להציג רכיבי ממשק משתמש של מודעות.
איך מאתחלים את הטעינה של המודעות
מייבאים את IMA SDK למנהל התצוגה ומשתמשים בפרוטוקולים IMAAdsLoaderDelegate
ו-IMAStreamManagerDelegate
כדי לטפל באירועים של מנהל הסטרימינג ושל מערך המודעות.
מוסיפים את המאפיינים הפרטיים הבאים כדי לאחסן רכיבים מרכזיים של IMA SDK:
IMAAdsLoader
– ניהול בקשות הסטרימינג במהלך כל משך החיים של האפליקציה.IMAAdDisplayContainer
– הקוד הזה מטפל בהוספה ובניהול של רכיבים בממשק המשתמש של מודעות.IMAAVPlayerVideoDisplay
– רכיב שמקשר בין IMA SDK לבין נגן המדיה ומטפל במטא-נתונים מתוזמנים.IMAStreamManager
– ניהול ההפעלה של הסטרימינג והפעלת אירועים שקשורים למודעות.
מאתחלים את מערך הטעינה של המודעות, את מאגר המודעות ואת תצוגת הסרטון אחרי שהתצוגה נטענת.
שליחת בקשה להעברת נתונים
כשמשתמש לוחץ על לחצן ההפעלה, שולחים בקשה חדשה לשידור. משתמשים ב-class IMALiveStreamRequest
לשידורים חיים. להעברות VOD, משתמשים במחלקה IMAVODStreamRequest
.
בקשת הסטרימינג כוללת את הפרמטרים של הסטרימינג, וגם הפניה לקונטיינר של תצוגת המודעות ולתצוגת הווידאו.
הקשבה לאירועי טעינה של שידורים
הכיתה IMAAdsLoader
קורא לשיטות IMAAdsLoaderDelegate
אם האתחול של בקשת הסטרימינג הצליח או נכשל.
בשיטת הענקת הגישה adsLoadedWithData
, מגדירים את IMAStreamManagerDelegate
ומאתחלים את מנהל הסטרימינג. בזמן האינטליגנציה, מנהל הסטרימינג מתחיל את ההפעלה.
מתעדים את השגיאה ביומן של שיטת הענקת הגישה failedWithErrorData
. אפשר גם להפעיל את סטרימינג הגיבוי. שיטות מומלצות ל-DAI
האזנה לאירועים של מודעות
הפונקציה IMAStreamManager
קורא לשיטות IMAStreamManagerDelegate
כדי להעביר לאפליקציה אירועים ושגיאות של סטרימינג.
בדוגמה הזו, מתעדים ביומן במסוף את אירועי המודעות הראשיים:
מפעילים את האפליקציה. אם היא פועלת, אפשר לבקש ולנגן שידורים של Google DAI באמצעות IMA SDK. למידע נוסף על תכונות מתקדמות יותר של SDK, אפשר לעיין במדריכים נוספים שמפורטים בסרגל הצד שבו אתם נמצאים עכשיו, או בדוגמאות ב-GitHub.