במדריך הזה מוסבר איך משתמשים ב-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
מדריך לתחילת העבודה בנושא בחירת הרשת
שלב 1: הגדרת ההגדרות בממשק המשתמש של i-mobile
נרשמים או נכנסים לחשבון i-mobile.
כדי להוסיף את האפליקציה למרכז הבקרה של i-mobile, לוחצים על הכרטיסייה サイト／アプリ管理 (ניהול אתר/אפליקציה) ואז על הלחצן של הפלטפורמה של האפליקציה.
Android
iOS
ממלאים את הטופס ולוחצים על הלחצן 新規登録 (Sign up).
Android
iOS
כדי ליצור מיקום מודעה חדש, בוחרים את האפליקציה בכרטיסייה אתר/ניהול אפליקציות.
Android
iOS
עוברים לכרטיסייה 広告スポット管理 (ניהול מיקומי מודעות) ולוחצים על הלחצן 新規広告スポット (מיקום מודעה חדש).
לאחר מכן, מלא את הטופס. לשם כך, עליך להזין את השם 広告及及化 (שם Ad Spot), 広告カ化 correctly悺 (גודל מיקום מודעה) ופרטים נוספים. לאחר מכן, לוחצים על הלחצן 新規登録 (Sign up).
המקום להצגת מודעה החדש מוכן. כדי להציג את פרטי השילוב, לוחצים על הלחצן アプリ設定取得 (קבלת הגדרות האפליקציה).
חשוב לשמור את הפרטים הבאים: パ及ーID (Publisher ID), רליアID (מזהה מדיה), ו-六價ID (Spot ID). יהיה צורך בפרמטרים האלה מאוחר יותר במהלך ההגדרה i-mobile לתהליך בחירת הרשת (Mediation) בממשק המשתמש של AdMob.
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-10 | ערכת ה-SDK של i-mobile החזירה שגיאה. להצגת הקוד אפשר לקבל פרטים נוספים. |
| 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.1
- עדכנו את
CFBundleShortVersionStringכך שיכיל שלושה רכיבים במקום ארבעה.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 11.10.0.
- 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.
פותח ונבדק בעזרת:
- גרסה 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.
- 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.
הקוד נוצר ונבדק באמצעות:
- גרסה 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
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 9.0.0 ואילך של Google Mobile Ads SDK.
הקוד נוצר ונבדק באמצעות:
- גרסה 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.