במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-i-mobile באמצעות תהליך בחירת הרשת (Mediation), שמכסה שילובים של Waterfall. נסביר איך להוסיף את i-mobile להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של i-mobile באפליקציית Unity.
בממשק של מרכז הבקרה של i-mobile נעשה שימוש בטקסט ביפנית עבור התוויות, הלחצנים והתיאורים שלו. צילומי המסך במדריך הזה לא תורגמו. עם זאת, התיאורים וההוראות במדריך הזה מתורגמים באמצעות סוגריים ותוויות מתורגמות בשפה האנגלית.
שילובים נתמכים ופורמטים נתמכים של מודעות
המתאם של AdMob תהליך בחירת הרשת ב-i-mobile כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
פרסומת מרווח ביניים | |
ההטבה הופעלה |
דרישות
- Unity 5.6 ואילך
- ה-SDK העדכני של מודעות Google לנייד
- כדי לפרוס ב-Android
- Android API ברמת 19 ואילך
- כדי לפרוס ב-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 לגישור עבור i-mobile מהקישור להורדה ב-Changelog ולחלץ את GoogleMobileAdsIMobileMediation.unitypackage
מקובץ ה-zip.
בעורך הפרויקטים ב-Unity, בוחרים באפשרות Assets > Import Package > Custom Package ומוצאים את הקובץ GoogleMobileAdsIMobileMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על Import.
לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force Solution. ספריית Unity Play Services Solutionr תבצע פתרון תלויי מההתחלה ותעתיק את יחסי התלות המוצהרים לספרייה 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. |
יומן שינויים של פלאגין Unity Mediation של i-mobile
גרסה 1.3.2
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/IMobile/
. - יש תמיכה במתאם i-mobile Android בגרסה 2.3.1.1.
- תומך במתאם i-mobile iOS בגרסה 2.3.2.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.1.0 נוצרה ונבדקה.
גרסה 1.3.1
- תומך במתאם ל-Android בגרסה 2.3.0.0 של i-mobile.
- יש תמיכה במתאם i-mobile iOS בגרסה 2.3.0.1.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.4.1.
גרסה 1.3.0
- תומך במתאם ל-Android בגרסה 2.3.0.0 של i-mobile.
- יש תמיכה במתאם i-mobile iOS בגרסה 2.3.0.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.3.1.
גרסה 1.2.2
- יש תמיכה במתאם i-mobile Android בגרסה 2.0.23.1.
- יש תמיכה במתאם i-mobile ל-iOS בגרסה 2.2.0.1.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.2.
גרסה 1.2.1
- יש תמיכה במתאם i-mobile Android בגרסה 2.0.23.0.
- יש תמיכה במתאם i-mobile ל-iOS בגרסה 2.2.0.1.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.0.
גרסה 1.2.0
- יש תמיכה במתאם i-mobile Android בגרסה 2.0.23.0.
- יש תמיכה במתאם i-mobile iOS בגרסה 2.2.0.0.
גרסה 1.1.0
- יש תמיכה במתאם i-mobile Android בגרסה 2.0.22.2.
- יש תמיכה במתאם i-mobile iOS בגרסה 2.1.0.1.
גרסה 1.0.2
- יש תמיכה במתאם i-mobile Android בגרסה 2.0.22.0.
- יש תמיכה במתאם i-mobile iOS בגרסה 2.0.32.0.
גרסה 1.0.1
- יש תמיכה במתאם i-mobile Android בגרסה 2.0.21.0.
- יש תמיכה במתאם i-mobile iOS בגרסה 2.0.31.0.
גרסה 1.0.0
- השקה ראשונה!
- יש תמיכה במתאם i-mobile Android בגרסה 2.0.20.1.
- תומך במתאם i-mobile iOS בגרסה 2.0.29.0.