במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-i-mobile באמצעות תהליך בחירת הרשת (Mediation), שכוללות שילובים של Waterfall. הוא עוסק בהוספת i-mobile ליחידת מודעות להגדרת תהליך בחירת הרשת, ואיך לשלב את ה-SDK והמתאם של i-mobile אפליקציית Unity.
בממשק מרכז השליטה של i-mobile נעשה שימוש בטקסט ביפנית בתור התוויות שלו, לחצנים ותיאורים. צילומי המסך במדריך הזה לא ותרגום. עם זאת, בתיאורים ובהוראות במדריך הזה, התוויות והלחצנים מתורגמים עם המקבילות שלהם באנגלית בסוגריים.
השילובים והפורמטים של המודעות שנתמכים
Ad Manager מתאם תהליך בחירת הרשת עבור i-mobile כולל היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה |
דרישות
- Unity 5.6 ומעלה
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של i-mobile
שלב 2: הגדרת הביקוש ל-i-mobile בממשק המשתמש של Ad Manager
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
שלב 3: מייבאים את ה-SDK והמתאם של i-mobile
OpenUPM-CLI
אם יש לכם את OpenUPM-CLI תוכל להתקין את Google Mobile Ads i-mobile הפלאגין של תהליך בחירת הרשת (Mediation) ל-Unity לפרויקט שלך, על ידי הרצת הפקודה הבאה מספריית השורש של הפרויקט:
openupm add com.google.ads.mobile.mediation.imobile
OpenUPM
בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > הגדרות פרויקט > Package Manager כדי לפתוח את הגדרות של מנהל החבילות של Unity.
בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר שמוגדר לפי היקף עם הפרטים הבאים:
- שם:
OpenUPM
- כתובת אתר:
https://package.openupm.com
- היקפים:
com.google
לאחר מכן, עוברים אל Window > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries בתפריט הנפתח.
בוחרים בחבילה תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads ב-i-mobile ואז לוחצים על התקנה.
חבילת Unity
כדאי להוריד את הגרסה האחרונה של הפלאגין לבחירת רשת (Mediation) של Google Ads לנייד עבור
i-mobile מקישור ההורדה ב-
ה
יומן שינויים
ומחלצים את הקטע
GoogleMobileAdsIMobileMediation.unitypackage
מהמיקוד
חדש.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets (נכסים) > ייבוא חבילה >
Custom Package (חבילה מותאמת אישית) ומוצאים את
GoogleMobileAdsIMobileMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על
ייבוא.
בשלב הבא בוחרים באפשרות נכסים > פותר הבעיות של Play Services >
Android resolve > סגירה ידנית. המקודד של Unity Play Services
תבצע רזולוציית תלות מאפס ותעתיק את
יחסי תלות מוצהרים בספרייה Assets/Plugins/Android
של
אפליקציית Unity.
שלב 4: נדרש קוד נוסף
Android
לא נדרש קוד נוסף בשילוב של i-mobile.
iOS
שילוב של SKAdNetwork
פועלים לפי המסמכים של i-mobile כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- Ad Manager ב-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 | ה-SDK של i-mobile החזיר שגיאה. להצגת הקוד אפשר לקבל פרטים נוספים. |
101 | ל-i-mobile נדרש הקשר Activity כדי לטעון מודעות. |
102 | הפרמטרים של שרת i-mobile שהוגדרו ב Ad Manager ממשק המשתמש חסרים/לא חוקיים. |
103 | גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-i-mobile. |
104 | הקריאה החוזרת (callback) של טעינת המודעות המותאמות ב-i-mobile החזירה רשימה ריקה של מודעות מותאמות. |
iOS
קוד שגיאה | סיבה |
---|---|
0-10 | אירעה שגיאה ב-i-mobile SDK. אפשר לקרוא פרטים נוספים בקטע קוד. |
101 | הפרמטרים של שרת i-mobile שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים. |
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.
- תמיכה במתאם i-mobile ל-iOS בגרסה 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.
- תמיכה במתאם i-mobile ל-iOS בגרסה 2.3.2.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.1.0.
גרסה 1.3.1
- תומך במתאם ל-Android של i-mobile בגרסה 2.3.0.0.
- תמיכה במתאם i-mobile ל-iOS בגרסה 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.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.0.0.
גרסה 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.