במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-i-mobile באמצעות תהליך בחירת הרשת (Mediation) ב-AdMob, שמתייחס לשילובים של רשתות ב-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, לוחצים על הכרטיסייה שפת iDEAL/アプ管理 (ניהול אתר/אפליקציה) ועל הלחצן של הפלטפורמה של האפליקציה.
ממלאים את הטופס ולוחצים על הלחצן 新規登録 (Sign up).
כדי ליצור מיקום מודעה חדש, בוחרים את האפליקציה בכרטיסייה אתר/ניהול אפליקציות.
מנווטים אל הכרטיסייה 広告及管理 (ניהול מיקומי מודעות) ולוחצים על הלחצן 🔐規広告をる (New Ad Spot).
לאחר מכן, ממלאים את הטופס ומציינים את הפרטים הבאים: 広告スポット名 (Ad Spot name), 広告スポットサイズ (Ad Spot size) ופרטים נוספים. לאחר מכן, לוחצים על הלחצן 新規登録 (Sign up).
מיקום המודעה החדש מוכן. כדי להציג את פרטי השילוב, לוחצים על הלחצן アプリ設定取得 (קבלת הגדרות האפליקציה).
חשוב לשים לב ל-パ元nowrapーID (מזהה בעל האתר), לבקשアID (מזהה מדיה), ול-設備名稱 (מזהה Spot). תצטרכו את הפרמטרים האלה בהמשך, כשתקבעו את i-mobile לצורכי תהליך בחירת הרשת בממשק המשתמש של AdMob.
שלב 2: הגדרת ביקוש ב-i-mobile AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
עליך להוסיף i-mobile לתצורה של תהליך בחירת הרשת של יחידת המודעות.
קודם נכנסים לחשבון AdMob. לאחר מכן נכנסים לכרטיסייה תהליך בחירת הרשת (Mediation). אם יש קבוצה קיימת לבחירת רשת שאתם רוצים לשנות, צריך ללחוץ על השם של הקבוצה לבחירת רשת כדי לערוך אותה, ולדלג לקטע הוספה i-mobile כמקור מודעות.
כדי ליצור קבוצה חדשה לבחירת רשת, בוחרים באפשרות יצירת קבוצה לבחירת רשת (Mediation).
מזינים את פורמט המודעה ואת הפלטפורמה, ולוחצים על המשך.
נותנים שם לקבוצה לבחירת רשת (Mediation) ובוחרים מיקומים גיאוגרפיים לטירגוט. בשלב הבא, מגדירים את הסטטוס של הקבוצה לבחירת רשת למופעלת ולוחצים על הוספת יחידות של מודעות.
משייכים את הקבוצה הזו לבחירת רשת לאחת או יותר מיחידות המודעותAdMob הקיימות. לאחר מכן לוחצים על סיום.
עכשיו אתם אמורים לראות שהכרטיס של יחידות המודעות מאוכלס ביחידות של המודעות שבחרתם:
הוספה של i-mobile כמקור מודעות
בכרטיס Waterfall בקטע מקורות מודעות, בוחרים באפשרות הוספת מקור מודעות. לאחר מכן בוחרים i-mobile.
בוחרים באפשרות i-mobile ומפעילים את המתג Optimize. עליכם להזין את Login name and API Passwordשקיבלתם בסעיף הקודם כדי להגדיר אופטימיזציה של מקורות מודעות עבורi-mobile. לאחר מכן מזינים ערך של עלות בפועל לאלף חשיפות עבורi-mobile ולוחצים על המשך.
אם כבר יש לכם מיפוי של i-mobile, תוכלו לבחור אותו. אם לא, לוחצים על הוספת מיפוי.
לאחר מכן, מזינים את Publisher ID, Media ID and Spot IDשקיבלתם בקטע הקודם. לאחר מכן לוחצים על סיום.
שלב 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: בדיקה מעשית של ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-AdMob. חברת i-mobile מספקת מזהה מודעה, מזהה מדיה ומזהה בעל אפליקציה לצורך בדיקה. אפשר למצוא אותם כאן.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-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 שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים. |
| 102 | גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך ב-i-mobile. |
| 103 | המערכת של i-mobile לא הצליחה להציג מודעה. |
| 104 | i-mobile החזיר מערך ריק של מודעות מותאמות. |
| 105 | מערכת i-mobile נכשלה בהורדת נכסי מודעות מותאמות. |
| 106 | פלטפורמת i-mobile לא תומכת בשליחת בקשות להצגת מודעות מעברון מרובות באמצעות אותו מזהה מודעה. |
יומן השינויים של מתאם תהליך בחירת הרשת ל-iOS של i-mobile
גרסה 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.
פותח ונבדק בעזרת:
- 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.
הקוד נוצר ונבדק באמצעות:
- גרסה 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.
הקוד נוצר ונבדק באמצעות:
- 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.
- i-mobile SDK גרסה 2.3.1.
גרסה 2.3.0.1
- כדי להשתמש בתכונה הזו, צריך עכשיו להשתמש ב-Google Mobile Ads SDK בגרסה 10.0.0 ואילך.
הקוד נוצר ונבדק באמצעות:
- 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.
הקוד נוצר ונבדק באמצעות:
- 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 ואילך.
פותח ונבדק עם
- גרסה 8.4.0 של Google Mobile Ads SDK.
- 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
- נוספו קודים והודעות סטנדרטיים של שגיאות במתאם.
- מעכשיו, המתאם מגביל את הבקשות להצגת כמה מודעות מעברון באמצעות אותו מזהה מודעה של 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.
פותח ונבדק עם
- גרסה 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.
- i-mobile SDK גרסה 2.0.29.