במדריך הזה מוסבר איך משתמשים ב-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
נרשמים או מתחברים לחשבון i-mobile.
מוסיפים את האפליקציה למרכז הבקרה של i-mobile בלחיצה על הכרטיסייה サ/アプリ管理 (Site/Application Management) ועל הלחצן של הפלטפורמה של האפליקציה.
Android
iOS
ממלאים את הטופס ולוחצים על הלחצן shared規登録 (הרשמה).
Android
iOS
כדי ליצור אתר פרסום חדש, בוחרים את האפליקציה בכרטיסייה サPLATFORM/アプリ管理 (Site/Application Management).
Android
iOS
מנווטים אל הכרטיסייה 広告スポッ管理 (ניהול מיקומי מודעות) ולחץ על הלחצן IMPORTANT規広告スポッ עלייה (מיקום מודעה חדש).
בשלב הבא, ממלאים את הטופס: מזינים את הפרטים הבאים: 広告スポッ באזור (Ad Spot Spot), 広告スポッורגサズ (גודל מיקום המודעה) ופרטים נוספים. לאחר מכן, לוחצים על הלחצן connect規登録 (Sign up) (הרשמה).
מיקום המודעה החדש מוכן. כדי לראות את פרטי השילוב, לוחצים על הלחצן アプリ及定元得 (Get App settings).
חשוב לרשום את パリッッャーID (Publisher ID), badgeデアID (Media ID) וスポッקירID (Spot ID). תצטרכו את הפרמטרים האלה מאוחר יותר כשתגדירו את i-mobile לגישור ב Ad Manager ממשק המשתמש.
Android
iOS
שלב 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-99 | אירעה שגיאה ב-i-mobile SDK. להצגת הקוד אפשר לקבל פרטים נוספים. |
| 101 | ל-i-mobile נדרש הקשר Activity כדי לטעון מודעות. |
| 102 | הפרמטרים של שרת i-mobile שהוגדרו ב Ad Manager ממשק המשתמש חסרים/לא חוקיים. |
| 103 | גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך ב-i-mobile. |
| 104 | הקריאה החוזרת (callback) של טעינת המודעות המותאמות ב-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 אין תמיכה בשליחת בקשה למספר מודעות מעברון באמצעות אותו מזהה Spot. |
יומן שינויים של מתאם תהליך בחירת הרשת (Mediation) ב-i-mobile ב-iOS
גרסה 2.3.4.0
- תאימות מאומתת ל-i-mobile SDK 2.3.4.
- נוספה תמיכה בהחזרת גרסת i-mobile SDK ב-
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כלול ב-frameworks בתוך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.
- SDK של i-mobile גרסה 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.
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 8.1.0 ואילך של Google Mobile Ads SDK.
- המתאם עודכן לפורמט
.xcframework.
פותח ונבדק עם
- גרסה 8.1.0 של Google Mobile Ads SDK
- i-mobile SDK גרסה 2.1.0.
גרסה 2.0.33.1
- נוספו הודעות וקודי שגיאה של מתאם סטנדרטי.
- המתאם מגביל עכשיו את הבקשות להצגת כמה מודעות מעברון באמצעות אותו מזהה Spot של i-mobile.
- המתאם מעביר עכשיו את הקריאה החוזרת של
-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.
- i-mobile SDK גרסה 2.0.31.
גרסה 2.0.29.0
- זו הגרסה הראשונה
- נוספה תמיכה במודעות באנר, מודעות מעברון ומודעות מותאמות.
פותח ונבדק עם
- Google Mobile Ads SDK גרסה 7.52.0.
- גרסה 2.0.29 של i-mobile SDK.