במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-i-mobile באמצעות תהליך בחירת הרשת, כולל שילובים של Waterfall. במאמר מוסבר איך להוסיף את i-mobile להגדרות בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של i-mobile באפליקציה iOS .
בממשק של לוח הבקרה של i-mobile, התוויות, הלחצנים והתיאורים מופיעים בטקסט יפני. צילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות במדריך הזה, תוויות ולחצנים מתורגמים עם המקבילות שלהם באנגלית בסוגריים.
השילובים והפורמטים של המודעות הנתמכים
למתאם בחירת הרשת ל-i-mobile יש את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| מפל | |
| פורמטים | |
| מודעת באנר | |
| מעברון | |
| ההטבה הופעלה | |
| מותאם | |
דרישות
- יעד הפריסה של iOS מגרסה 12.0 ואילך
הגרסה העדכנית ביותר של Google Mobile Ads SDK
מדריך לתחילת העבודה בנושא בחירת הרשת
שלב 1: הגדרת ההגדרות בממשק המשתמש של i-mobile
נרשמים או מתחברים לחשבון i-mobile.
כדי להוסיף את האפליקציה למרכז הבקרה של i-mobile, לוחצים על הכרטיסייה サイト／アプリ管理 (ניהול אתר/אפליקציה) ואז על הלחצן של הפלטפורמה של האפליקציה.
ממלאים את הטופס ולוחצים על הלחצן 新規登録 (Sign up).
כדי ליצור מיקום מודעה חדש, בוחרים את האפליקציה בכרטיסייה אתר/ניהול אפליקציות.
עוברים לכרטיסייה 広告スポット管理 (ניהול מיקומי מודעות) ולוחצים על הלחצן 新規広告スポット (מיקום מודעה חדש).
לאחר מכן, ממלאים את הטופס ומציינים את הפרטים הבאים: 広告スポット名 (Ad Spot name), 広告スポットサイズ (Ad Spot size) ופרטים נוספים. לאחר מכן, לוחצים על הלחצן 新規登録 (Sign up).
המקום להצגת מודעות החדש מוכן. כדי להציג את פרטי השילוב, לוחצים על הלחצן アプリ設定取得 (קבלת הגדרות האפליקציה).
חשוב לשים לב ל-パ元nowrapーID (מזהה בעל האתר), לבקשアID (מזהה מדיה), ול-設備名稱 (מזהה Spot). תצטרכו את הפרמטרים האלה בהמשך, כשתקבעו את i-mobile לצורכי תהליך בחירת הרשת בממשק המשתמש של AdMob.
שלב 2: מגדירים את הביקוש ל-i-mobile בממשק המשתמש של Ad Manager
שלב 3: מייבאים את ה-SDK ואת המתאם של i-mobile
שימוש ב-CocoaPods (מומלץ)
מוסיפים את השורה הבאה ל-Podfile של הפרויקט:
pod 'GoogleMobileAdsMediationIMobile'
מריצים את הפקודה הבאה בשורת הפקודה:
pod install --repo-update
שילוב ידני
- מורידים את הגרסה האחרונה של i-mobile SDK ומקשרים את
ImobileSdkAds.frameworkבפרויקט. - מורידים את הגרסה האחרונה של מתאם i-mobile מהקישור להורדה בChangelog ומהקישור
IMobileAdapter.frameworkבפרויקט.
שלב 4: מוסיפים את הקוד הנדרש
שילוב עם SKAdNetwork
פועלים לפי המסמכים של i-mobile כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.
שלב 5: בדיקה מעשית של ההטמעה
שלבים אופציונליים
שימוש במודעות מותאמות
עיבוד מודעות
מתאם 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 לא תומכת בשליחת בקשות להצגת מודעות מעברון מרובות באמצעות אותו מזהה מודעה. |
יומן השינויים של מתאם תהליך בחירת הרשת ל-iOS של i-mobile
גרסה 2.3.4.1
- עדכנו את
CFBundleShortVersionStringכך שיכלול שלושה רכיבים במקום ארבעה.
הקוד נוצר ונבדק באמצעות:
- גרסה 11.10.0 של Google Mobile Ads SDK.
- i-mobile SDK גרסה 2.3.4.
גרסה 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.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 11.1.0.
- i-mobile SDK גרסה 2.3.3.
גרסה 2.3.2.1
- הוסרה שיטת הענקת הגישה (delegate) הקודמת
willBackgroundApplicationמהטמעות של מודעות באנר, מודעות מעברון ומודעות מותאמות. - נדרשת עכשיו גרסת iOS 12.0 מינימלית.
- מעכשיו נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
Info.plistנכלל במסגרות שב-IMobileAdapter.xcframework.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 11.0.1.
- i-mobile SDK גרסה 2.3.2.
גרסה 2.3.2.0
- התאימות אומתה עם i-mobile SDK 2.3.2.
- הסרת התמיכה בארכיטקטורה
armv7. - עכשיו נדרשת גרסת iOS מגרסה 11.0 ואילך.
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 10.4.0 ואילך של Google Mobile Ads SDK.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 10.4.0.
- i-mobile SDK גרסה 2.3.2.
גרסה 2.3.1.0
- תאימות מאומתת ל-i-mobile SDK 2.3.1.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK גרסה 10.3.0.
- SDK של i-mobile גרסה 2.3.1.
גרסה 2.3.0.1
- מעכשיו נדרשת גרסה 10.0.0 ואילך של Google Mobile Ads SDK.
הקוד נוצר ונבדק באמצעות:
- גרסה 10.0.0 של Google Mobile Ads SDK.
- 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
- מעכשיו נדרשת גרסה 9.0.0 ואילך של Google Mobile Ads SDK.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 9.0.0.
- 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.
פותח ונבדק עם
- Google Mobile Ads SDK בגרסה 8.1.0.
- i-mobile SDK גרסה 2.1.0.
גרסה 2.0.33.1
- נוספו קודים והודעות סטנדרטיים של שגיאות במתאם.
- מעכשיו, המתאם מגביל את הבקשות להצגת כמה מודעות מעברון באמצעות אותו מזהה מודעה של i-mobile.
- מעכשיו, ה-Adapter מעביר את הקריאה החוזרת
-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.
פותח ונבדק עם
- Google Mobile Ads SDK בגרסה 7.60.0.
- 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.
- i-mobile SDK גרסה 2.0.29.