במדריך הזה נסביר איך משתמשים ב-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).
המקום להצגת מודעה החדש מוכן. כדי להציג את פרטי השילוב, לוחצים על הלחצן アプリ設定取得 (קבלת הגדרות האפליקציה).
שימו לב לPublisher ID (מזהה בעל התוכן הדיגיטלי), ל-Media ID (מזהה המדיה) ול-Spot ID (מזהה הסרטון). תצטרכו את הפרמטרים האלה מאוחר יותר כשתקבעו את i-mobile לצורכי תהליך בחירת הרשת בממשק המשתמש של Ad Manager.
שלב 2: מגדירים את הביקוש מ-i-mobile בממשק המשתמש של Ad Manager
הגדרת הגדרות בחירת הרשת ליחידת המודעות
נכנסים לחשבון Ad Manager.
עוברים אל הצגה > קבוצות תשואה ולוחצים על הלחצן קבוצת תשואה חדשה.
מזינים שם ייחודי לקבוצת התשואה, מגדירים את הסטטוס ל-פעיל, בוחרים את פורמט המודעה ומגדירים את סוג המלאי ל-אפליקציה לנייד. בקטע טירגוט > מלאי, בוחרים את יחידת המודעות בקטע מלאי ו-אפליקציה לנייד שרוצים להוסיף אליה תהליך בחירת הרשת.
לאחר מכן, לוחצים על הלחצן Add yield partner (הוספת שותף להגדלת התשואה).
אם כבר יש לכם שותף להגדלת ההכנסות ב-i-mobile, תוכלו לבחור בו. אם לא, בוחרים באפשרות יצירת שותף חדש להגדלת ההכנסות.
בוחרים באפשרות i-mobile בתור רשת המודעות, מזינים שם ייחודי ומפעילים את בחירת הרשת.
מפעילים את האפשרות איסוף נתונים אוטומטי ומזינים את שם הכניסה ואת סיסמת ה-API.
אחרי שבוחרים את שותף ה-Yield, בוחרים באפשרות Mobile SDK Mediation בתור סוג השילוב, באפשרות iOS בתור פלטפורמה ובאפשרות Active בתור סטטוס. מזינים את מזהה בעל התוכן הדיגיטלי, את מזהה המדיה ואת מזהה הקליפ שהתקבלו בקטע הקודם. לאחר מכן, מזינים ערך Default CPM.
בסיום, לוחצים על שמירה בתחתית הדף.
שלב 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: בדיקה מעשית של ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-Ad Manager. חברת 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 | ערכת ה-SDK של i-mobile החזירה שגיאה. פרטים נוספים זמינים במאמר קוד. |
| 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כך שיכלול שלושה רכיבים במקום ארבעה.
הקוד נוצר ונבדק באמצעות:
- 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.
הקוד נוצר ונבדק באמצעות:
- 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.
- 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.
הקוד נוצר ונבדק באמצעות:
- 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.