במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-i-mobile באמצעות תהליך בחירת הרשת (Mediation), שכוללות שילובים של Waterfall. הוא עוסק בהוספת i-mobile ליחידת מודעות להגדרת תהליך בחירת הרשת, ואיך לשלב את ה-SDK והמתאם של i-mobile אפליקציית Unity.
בממשק מרכז השליטה של i-mobile נעשה שימוש בטקסט ביפנית בתור התוויות שלו, לחצנים ותיאורים. צילומי המסך במדריך הזה לא ותרגום. עם זאת, בתיאורים ובהוראות של מדריך זה, תוויות ולחצנים מתורגמים באותיות המקבילות שלהם באנגלית בסוגריים.
השילובים והפורמטים של המודעות שנתמכים
AdMob מתאם תהליך בחירת הרשת עבור i-mobile כולל היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה |
דרישות
- Unity 5.6 ומעלה
- ה-SDK העדכני של Google Mobile Ads
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (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 לגישור ב AdMob ממשק המשתמש.
Android
iOS
שלב 2: הגדרת ביקוש ב-i-mobile AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
שלב 3: מייבאים את ה-SDK והמתאם של i-mobile
הורדת הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ל-i-mobile
מהקישור להורדה ביומן השינויים
ומחלצים את הערך GoogleMobileAdsIMobileMediation.unitypackage
מה-ZIP
חדש.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > (נכסים >) ייבוא חבילה >
חבילה מותאמת אישית ומוצאים את GoogleMobileAdsIMobileMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על
ייבוא.
בשלב הבא בוחרים באפשרות נכסים > המקודד של Play Services > מקודד Android >
סגירה ידנית. ספריית Unity Play Services מקודדת תפעל
של יחסי התלות מההתחלה ומעתיקים את יחסי התלות המוצהרים
הספרייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 4: נדרש קוד נוסף
Android
לא נדרש קוד נוסף בשילוב של i-mobile.
iOS
שילוב של SKAdNetwork
יש לפעול לפי מסמכי התיעוד של i-mobile
כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob ב-i-mobile יש את מזהה ה-Spot, Media ID ו-Publisher ID שמיועדים לבדיקות. אפשר למצוא אותם כאן.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-i-mobile, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות i-mobile (Waterfall) מקורות המודעות.
קודי שגיאה
אם המתאם לא מקבל מודעה מ-i-mobile, בעלי התוכן הדיגיטלי יכולים לבדוק
שגיאה בסיסית מהתגובה של המודעה באמצעות ResponseInfo
בסיווגים הבאים:
Android
פורמט | שם הכיתה |
---|---|
כרזה | com.google.ads.mediation.imobile.IMobileAdapter |
מעברון | com.google.ads.mediation.imobile.IMobileAdapter |
מותאם | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
פורמט | שם הכיתה |
---|---|
כרזה | IMobileAdapter |
מעברון | IMobileAdapter |
מותאם | GADMediationAdapterIMobile |
אלו הקודים וההודעות הנלוות שמתאם i-mobile זורק כשמודעה נכשלת להיטען:
Android
קוד שגיאה | סיבה |
---|---|
0-99 | אירעה שגיאה ב-i-mobile SDK. להצגת הקוד אפשר לקבל פרטים נוספים. |
101 | ל-i-mobile נדרש הקשר Activity כדי לטעון מודעות. |
102 | הפרמטרים של שרת i-mobile שהוגדרו ב AdMob ממשק המשתמש חסרים/לא חוקיים. |
103 | גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך ב-i-mobile. |
104 | הקריאה החוזרת (callback) של טעינת המודעות המותאמות ב-i-mobile החזירה רשימה ריקה של מודעות מותאמות. |
iOS
קוד שגיאה | סיבה |
---|---|
0-10 | אירעה שגיאה ב-i-mobile SDK. אפשר לקרוא פרטים נוספים בקטע קוד. |
101 | הפרמטרים של שרת i-mobile שהוגדרו ב AdMob ממשק המשתמש חסרים/לא חוקיים. |
102 | גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך ב-i-mobile. |
103 | לא הצלחנו להציג מודעה ב-i-mobile. |
104 | i-mobile החזיר מערך ריק של מודעות מותאמות. |
105 | הורדת הנכסים של המודעות המותאמות ב-i-mobile נכשלה. |
106 | ב-i-mobile אין תמיכה בשליחת בקשה למספר מודעות מעברון באמצעות אותו מזהה Spot. |
יומן שינויים בפלאגין של i-mobile Unity Mediation
גרסה 1.3.5
- תומך במתאם ל-Android של i-mobile בגרסה 2.3.2.0.
- תומכת במתאם iOS של i-mobile בגרסה 2.3.4.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.3.4
- תומך במתאם ל-Android של i-mobile בגרסה 2.3.1.2.
- תומכת במתאם iOS של i-mobile בגרסה 2.3.4.0.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 1.3.3
- תומך במתאם ל-Android של i-mobile בגרסה 2.3.1.1.
- תומכת במתאם iOS של i-mobile בגרסה 2.3.3.0.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 1.3.2
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/IMobile/
. - תומך במתאם ל-Android של i-mobile בגרסה 2.3.1.1.
- תומכת במתאם iOS של i-mobile בגרסה 2.3.2.0.
- נוצר ונבדק באמצעות גרסה 8.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.3.1
- תומך במתאם ל-Android של i-mobile בגרסה 2.3.0.0.
- תומכת במתאם iOS של i-mobile בגרסה 2.3.0.1.
- נוצר ונבדק באמצעות גרסה 7.4.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.3.0
- תומך במתאם ל-Android של i-mobile בגרסה 2.3.0.0.
- תומכת במתאם iOS של i-mobile בגרסה 2.3.0.0.
- נוצר ונבדק באמצעות גרסה 7.3.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.2.2
- תומך במתאם ל-Android של i-mobile בגרסה 2.0.23.1.
- תומכת במתאם iOS של i-mobile בגרסה 2.2.0.1.
- נוצר ונבדק באמצעות גרסה 7.0.2 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.2.1
- תומך במתאם ל-Android של i-mobile בגרסה 2.0.23.0.
- תומכת במתאם iOS של i-mobile בגרסה 2.2.0.1.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.2.0
גרסה 1.1.0
גרסה 1.0.2
גרסה 1.0.1
גרסה 1.0.0
- גרסה ראשונה!
- תומך במתאם ל-Android של i-mobile בגרסה 2.0.20.1.
- תומכת במתאם iOS של i-mobile בגרסה 2.0.29.0.