במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-maio באמצעות תהליך בחירת הרשת (Mediation), שכולל שילובים של Waterfall. נסביר איך להוסיף את maio להגדרה של תהליך בחירת הרשת (Mediation) של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של maio באפליקציה ל-Unity.
בממשק מרכז הבקרה של maio נעשה שימוש בטקסט ביפנית בתוויות, בלחצנים ובתיאורים, וצילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות שכאן, התוויות והלחצנים מוזכרים באנגלית מקבילה לתוויות וללחצנים. לדוגמה, "URL 六價ーム" הוא "סכמת כתובת ה-URL", וכו'.
השילובים והפורמטים של המודעות שנתמכים
למתאם תהליך בחירת הרשת ב-maio יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
דפי ביניים | |
ההטבה הופעלה |
דרישות
- Unity 4 ומעלה
- ה-SDK העדכני של Google Mobile Ads
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלמת התהליך של תהליך בחירת הרשת המדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של maio
קודם כל, נרשמים או מתחברים לחשבון maio. בסרגל הצד שמשמאל, לוחצים על Application management ואז על New app.
בוחרים את הכרטיסייה שתואמת לסוג המודעה המועדף.
פרסומת מרווח ביניים
נותנים שם לאפליקציה, בוחרים את הפלטפורמה ומזינים את כתובת ה-URL של האפליקציה. בחר באפשרות מודעת מעברון בווידאו בתור סוג המודעה, ולחץ על עדכון.
Android
iOS
ההטבה הופעלה
נותנים שם לאפליקציה, בוחרים את הפלטפורמה ומזינים את כתובת ה-URL של האפליקציה. בוחרים באפשרות Video Rewards בתור סוג המודעה ולוחצים על עדכון.
Android
iOS
בדף Application Management שים לב למזהה המדיה. תצטרכו להגדיר את יחידת המודעות AdMob בקטע הבא.
Android
iOS
בדף Zone Management מציינים את Zone ID. בקטע הבא תצטרכו גם להגדיר את AdMob יחידת המודעות.
Android
iOS
שלב 2: הגדרת ביקוש ב-maio AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
שלב 3: מייבאים את ה-SDK והמתאם של maio
מורידים את הגרסה העדכנית של הפלאגין לבחירת רשת המודעות של Google לנייד עבור maio מהקישור להורדה ב-Changelog ל-maio ומחלצים את GoogleMobileAdsMaioMediation.unitypackage
מקובץ ה-zip.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > Import Package > Custom
Package (חבילה) ומוצאים את הקובץ GoogleMobileAdsMaioMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.
לאחר מכן, בוחרים באפשרות Assets > Play Services Resolutionr > Android resolver >
אילוץ סגירה. ספריית Unity Play Services resolver תבצע רזולוציית תלות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android
באפליקציית Unity.
שלב 4: מוסיפים את הקוד הנדרש
Android
לא נדרש קוד נוסף לשילוב עם maio.
iOS
שילוב של SKAdNetwork
עליכם לפעול לפי מסמכי התיעוד של maio כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob
בעלי אפליקציות שמשתמשים בגרסה 7.26.0 ואילך של Google Mobile Ads SDK יקבלו באופן אוטומטי מודעות בדיקה מ-maio בטלפונים ובטאבלטים שרשומים כמכשירי בדיקה בזמן שליחת בקשות.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-maio, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות maio (Waterfall) מקורות המודעות.
קודי שגיאה
אם המתאם לא מקבל מודעה מ-maio, בעלי התוכן הדיגיטלי יכולים לבדוק את השגיאה הבסיסית בתגובה באמצעות ResponseInfo
לפי הסוגים הבאים:
Android
פורמט | שם הכיתה |
---|---|
פרסומת מרווח ביניים | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
ההטבה הופעלה | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
פורמט | שם הכיתה |
---|---|
פרסומת מרווח ביניים | GADMMaioInterstitialAdapter |
ההטבה הופעלה | GADMMaioRewardedAdapter |
אלה הקודים וההודעות הנלוות שמתאם maio זורק כשטעינה של מודעה נכשלת:
Android
קוד שגיאה | הסיבה |
---|---|
0-10 | maio החזירה שגיאה ספציפית ל-SDK. אפשר לקרוא פרטים נוספים בקוד ובמסמכי התיעוד של maio. |
101 | אין ל-Maio מודעה זמינה. |
102 | פרמטרים לא חוקיים של שרת (למשל, חסר מזהה מיקום). |
103 | ההקשר ששימש לטעינת מודעה לא היה מופע של 'פעילות'. |
iOS
קוד שגיאה | הסיבה |
---|---|
0-10 | maio החזירה שגיאה ספציפית ל-SDK. לפרטים נוספים, אפשר לעיין בקוד של maio. |
101 | עדיין אין מודעה זמינה ב-maio. |
102 | פרמטרים לא חוקיים של שרת (למשל, חסר מזהה מיקום). |
103 | המתאם maio לא תומך בפורמט המודעה המבוקש. |
104 | כבר נטענה מודעה לתצורת הרשת הזו. |
יומן שינויים בפלאגין של maio Unity Mediation
גרסה 2.0.3
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.16.3.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 2.1.5.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.0.2
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.16.3.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 2.1.4.0.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 2.0.1
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.16.2.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 2.1.3.0.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 2.0.0
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.16.2.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 2.1.1.0.
- נוצר ונבדק באמצעות גרסה 8.6.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.4.3
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/Maio/
. - תמיכה במתאם ל-Android של Maio בגרסה 1.1.16.2.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 1.6.3.1.
- נוצר ונבדק באמצעות גרסה 8.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.4.2
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.16.1.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 1.6.3.0.
- נוצר ונבדק באמצעות גרסה 7.4.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.4.1
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.16.1.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 1.6.2.0.
- נוצר ונבדק באמצעות גרסה 7.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.4.0
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.16.0.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 1.6.0.1.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.3.6
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.16.0.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 1.5.8.0.
גרסה 1.3.5
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.15.0.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 1.5.6.1.
גרסה 1.3.4
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.11.1.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 1.5.4.0.
גרסה 1.3.3
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.11.1.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 1.5.3.1.
גרסה 1.3.2
- תמיכה במתאם ל-Android של Maio בגרסה 1.1.11.0.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 1.5.2.1.
גרסה 1.3.1
- יש תמיכה במתאם ל-Android של Maio בגרסה 1.1.10.0.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 1.5.1.0.
גרסה 1.3.0
- יש תמיכה במתאם ל-Android של Maio בגרסה 1.1.10.0.
- יש תמיכה במתאם ל-iOS של Maio בגרסה 1.5.0.0.
גרסה 1.2.3
- הפלאגין עודכן כך שיתמוך ב-Rewarded API החדש.
- תומך בגרסה 1.1.7.0 של מתאם maio ל-Android.
- יש תמיכה בגרסה 1.4.6.0 של מתאם iOS ל-maio.
גרסה 1.2.2
- יש תמיכה במתאם ל-Android של maio בגרסה 1.1.6.0.
- יש תמיכה בגרסה 1.4.2.0 של מתאם iOS ל-maio.
גרסה 1.2.1
- יש תמיכה במתאם ל-Android של maio בגרסה 1.1.6.0.
- יש תמיכה בגרסה 1.4.1.0 של מתאם iOS ל-maio.
גרסה 1.2.0
- תמיכה במתאם ל-Android של maio בגרסה 1.1.4.1.
- יש תמיכה בגרסה 1.4.0.0 של מתאם iOS ל-maio.
גרסה 1.1.3
- תמיכה במתאם ל-Android של maio בגרסה 1.1.3.1.
- יש תמיכה בגרסה 1.3.2.0 של מתאם iOS ל-maio.
גרסה 1.1.2
- תומך במתאם ל-Android של maio בגרסה 1.1.3.0.
- יש תמיכה בגרסה 1.3.2.0 של מתאם iOS ל-maio.
גרסה 1.1.1
- תומך במתאם ל-Android של maio בגרסה 1.1.1.0.
- יש תמיכה בגרסה 1.3.1.1 של מתאם iOS ל-maio.
גרסה 1.1.0
- תומך במתאם ל-Android של maio בגרסה 1.1.0.0.
- יש תמיכה בגרסה 1.3.0.0 של מתאם iOS ל-maio.
גרסה 1.0.2
- תמיכה ב-maio Android SDK בגרסה 1.0.8.
- תמיכה ב-maio iOS SDK בגרסה 1.2.19.
גרסה 1.0.1
- תמיכה ב-maio Android SDK בגרסה 1.0.7.
- תמיכה ב-maio iOS SDK בגרסה 1.2.19.
גרסה 1.0.0
- גרסה ראשונה!
- תמיכה ב-maio Android SDK בגרסה 1.0.6.
- תמיכה ב-maio iOS SDK בגרסה 1.2.18.