במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-i-mobile באמצעות תהליך בחירת הרשת (Mediation), שכוללות שילובים של Waterfall. הוא עוסק בהוספת i-mobile ליחידת מודעות להגדרת תהליך בחירת הרשת, ואיך לשלב את ה-SDK והמתאם של i-mobile אפליקציה.
בממשק מרכז השליטה של i-mobile נעשה שימוש בטקסט ביפנית בתור התוויות שלו, לחצנים ותיאורים. צילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות במדריך הזה, התוויות והלחצנים מתורגמים עם המקבילות שלהם באנגלית בסוגריים.
השילובים והפורמטים של המודעות שנתמכים
המתאם לתהליך בחירת הרשת (Mediation) ל-i-mobile כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מותאם |
דרישות
- יעד הפריסה של iOS מגרסה 12.0 ואילך
ה-SDK העדכני של Google Mobile Ads
השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של i-mobile
שלב 2: הגדרת ביקוש ב-i-mobile Ad Manager בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
שלב 3: מייבאים את ה-SDK והמתאם של i-mobile
שימוש ב-CocoaPods (מומלץ)
מוסיפים את השורה הבאה ל-Podfile של הפרויקט:
pod 'GoogleMobileAdsMediationIMobile'
מריצים את הפקודה הבאה בשורת הפקודה:
pod install --repo-update
שילוב ידני
- מורידים את הגרסה האחרונה של i-mobile SDK ומקשרים את
ImobileSdkAds.framework
בפרויקט. - אפשר להוריד את הגרסה האחרונה של המתאם ל-i-mobile דרך הקישור להורדה
יומן שינויים וגם
מקשר את
IMobileAdapter.framework
בפרויקט.
שלב 4: מוסיפים את הקוד הנדרש
שילוב של SKAdNetwork
יש לפעול לפי מסמכי התיעוד של i-mobile
כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- Ad Manager ב-i-mobile יש את מזהה ה-Spot, Media ID ו-Publisher ID שמיועדים לבדיקות. אפשר למצוא אותם כאן.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-i-mobile, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות i-mobile (Waterfall) מקורות המודעות.
שלבים אופציונליים
שימוש במודעות מותאמות
רינדור המודעות
המתאם של i-mobile מאכלס את הפריטים הבאים
שדות
עבור
GADNativeAd
.
שדה | הנכסים תמיד נכללים במתאם i-mobile |
---|---|
כותרת | |
תמונה | |
גוף | |
סמל האפליקציה | 1 |
קריאה לפעולה | |
Star rating | |
חנות | |
מחיר |
1 במודעות מותאמות, ערכת ה-SDK של i-mobile לא מספקת נכס של סמל אפליקציה. במקום זאת, מתאם i-mobile מאכלס תמונה שקופה בסמל האפליקציה.
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-i-mobile, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות
GADResponseInfo.adNetworkInfoArray
בסיווגים הבאים:
פורמט | שם הכיתה |
---|---|
כרזה | IMobileAdapter |
מעברון | IMobileAdapter |
מותאם | GADMediationAdapterIMobile |
אלו הקודים וההודעות הנלוות שמתאם i-mobile זורק כשמודעה נכשלת להיטען:
קוד שגיאה | סיבה |
---|---|
0-10 | אירעה שגיאה ב-i-mobile SDK. להצגת הקוד אפשר לקבל פרטים נוספים. |
101 | הפרמטרים של שרת i-mobile שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים. |
102 | גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך ב-i-mobile. |
103 | לא הצלחנו להציג מודעה ב-i-mobile. |
104 | i-mobile החזיר מערך ריק של מודעות מותאמות. |
105 | מערכת i-mobile נכשלה בהורדת נכסי מודעות מותאמות. |
106 | מערכת i-mobile לא תומכת בשליחת בקשות להצגת מודעות מעברון מרובות באמצעות אותו מזהה מודעה. |
יומן שינויים של מתאם תהליך בחירת הרשת (Mediation) ב-i-mobile ב-iOS
גרסה 2.3.4.0
- תאימות מאומתת ל-i-mobile SDK 2.3.4.
- נוספה תמיכה בהחזרת גרסת ה-SDK של i-mobile ב-
adSDKVersion
.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 11.2.0.
- i-mobile SDK גרסה 2.3.4.
גרסה 2.3.3.0
- תאימות מאומתת ל-i-mobile SDK 2.3.3.
פותח ונבדק בעזרת:
- גרסה 11.1.0 של Google Mobile Ads SDK.
- i-mobile SDK גרסה 2.3.3.
גרסה 2.3.2.1
- הוסרה השיטה להענקת גישה
willBackgroundApplication
שהוצא משימוש מההטמעות של מודעות באנר, מודעות מעברון ומודעות מותאמות. - נדרשת עכשיו גרסת iOS 12.0 מינימלית.
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
Info.plist
נכלל במסגרות שב-IMobileAdapter.xcframework
.
פותח ונבדק בעזרת:
- גרסה 11.0.1 של Google Mobile Ads SDK.
- SDK של i-mobile גרסה 2.3.2.
גרסה 2.3.2.0
- תאימות מאומתת ל-i-mobile SDK 2.3.2.
- התמיכה בארכיטקטורה של
armv7
הוסרה. - נדרשת עכשיו גרסת iOS 11.0 מינימלית.
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 10.4.0 ואילך של Google Mobile Ads SDK.
פותח ונבדק בעזרת:
- גרסה 10.4.0 של Google Mobile Ads SDK.
- i-mobile SDK גרסה 2.3.2.
גרסה 2.3.1.0
- תאימות מאומתת ל-i-mobile SDK 2.3.1.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 10.3.0.
- i-mobile SDK גרסה 2.3.1.
גרסה 2.3.0.1
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 10.0.0 ואילך של Google Mobile Ads SDK.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 10.0.0.
- i-mobile SDK גרסה 2.3.0.
גרסה 2.3.0.0
- תאימות מאומתת ל-i-mobile SDK 2.3.0.
- מעכשיו נדרשת גרסה 9.8.0 ואילך של Google Mobile Ads SDK.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 9.13.0.
- i-mobile SDK גרסה 2.3.0.
גרסה 2.2.0.1
- כדי להשתמש בתכונה הזו, צריך Google Mobile Ads SDK בגרסה 9.0.0 ואילך.
פותח ונבדק בעזרת:
- גרסה 9.0.0 של Google Mobile Ads SDK.
- i-mobile SDK גרסה 2.2.0.
גרסה 2.2.0.0
- תאימות מאומתת ל-i-mobile SDK גרסה 2.2.0.
פותח ונבדק עם
- Google Mobile Ads SDK גרסה 8.13.0.
- i-mobile SDK גרסה 2.2.0.
גרסה 2.1.0.1
- תלות רגועה ב-Google Mobile Ads SDK בגרסה 8.0.0 ואילך.
פיתוח ובדיקה באמצעות
- Google Mobile Ads SDK גרסה 8.4.0.
- i-mobile SDK גרסה 2.1.0.
גרסה 2.1.0.0
- תאימות מאומתת עם i-mobile SDK בגרסה 2.1.0.
- כדי להשתמש בתכונה הזו נדרשת עכשיו Google Mobile Ads SDK גרסה 8.1.0 ואילך.
- עדכנו את המתאם כך שישתמש בפורמט
.xcframework
.
פותח ונבדק עם
- גרסה 8.1.0 של Google Mobile Ads SDK
- i-mobile SDK גרסה 2.1.0.
גרסה 2.0.33.1
- נוספו הודעות וקודי שגיאה של מתאם סטנדרטי.
- מעכשיו, המתאם מגביל את הבקשות להצגת כמה מודעות מעברון באמצעות אותו מזהה מודעה של i-mobile.
- מעכשיו, ה-Adapter מעביר את הקריאה החוזרת (callback) של
-nativeAdWillLeaveApplication:
כשמקישים על מודעות מותאמות. - כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.68.0 ואילך של Google Mobile Ads SDK.
פותח ונבדק עם
- Google Mobile Ads SDK גרסה 7.68.0.
- i-mobile SDK גרסה 2.0.33.
גרסה 2.0.33.0
- תאימות מאומתת עם i-mobile SDK בגרסה 2.0.33.
- מעכשיו נדרשת גרסה 7.65.0 ואילך של Google Mobile Ads SDK.
- עכשיו נדרשת גרסת iOS 9.0 מינימלית.
פותח ונבדק עם
- Google Mobile Ads SDK גרסה 7.65.0.
- i-mobile SDK גרסה 2.0.33.
גרסה 2.0.32.0
- תאימות מאומתת ל-i-mobile SDK בגרסה 2.0.32.
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.60.0 ואילך של Google Mobile Ads SDK.
- נוספה תמיכה בהתאמת מודעות בגדלים 320x50 ו-320x100 כדי להתאים בצורה טובה יותר לגדלים של בקשות למודעות באנר מותאמות.
- התמיכה בארכיטקטורה של i386 הוסרה.
פותח ונבדק עם
- גרסה 7.60.0 של Google Mobile Ads SDK.
- i-mobile SDK גרסה 2.0.32.
גרסה 2.0.31.0
- תאימות מאומתת ל-i-mobile SDK גרסה 2.0.31.
פיתוח ובדיקה באמצעות
- Google Mobile Ads SDK גרסה 7.53.1.
- גרסה 2.0.31 של i-mobile SDK.
גרסה 2.0.29.0
- זו הגרסה הראשונה
- נוספה תמיכה במודעות באנר, מודעות מעברון ומודעות מותאמות.
פיתוח ובדיקה באמצעות
- Google Mobile Ads SDK גרסה 7.52.0.
- i-mobile SDK גרסה 2.0.29.