במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-maio באמצעות תהליך בחירת הרשת (Mediation), שכוללות שילובים של Waterfall. המאמר מסביר איך להוסיף את maio ליחידת מודעות הגדרת תהליך בחירת הרשת, ואיך לשלב את ה-SDK והמתאם של maio אפליקציית Unity.
בממשק מרכז הבקרה של maio נעשה שימוש בטקסט ביפנית בתור התוויות, הלחצנים ותיאורים, וצילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות שכאן, התוויות והלחצנים מתייחס אליהם על ידי מקורות מקבילים באנגלית. "URL insertーム", לדוגמה, היא 'סכמת כתובת ה-URL', וכן הלאה.
השילובים והפורמטים של המודעות הנתמכים
למתאם תהליך בחירת הרשת ב-maio יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
דפי ביניים | |
ההטבה הופעלה |
דרישות
- Unity 4 ומעלה
- ה-SDK העדכני של Google Mobile Ads
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של maio
שלב 2: הגדרת ביקוש ב-maio Ad Manager בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
שלב 3: מייבאים את ה-SDK והמתאם של maio
OpenUPM-CLI
אם יש לכם את OpenUPM-CLI תוכל להתקין את Google Mobile Ads הפלאגין של תהליך בחירת הרשת (Mediation) ל-Unity לפרויקט שלך, על ידי הרצת הפקודה הבאה מספריית השורש של הפרויקט:
openupm add com.google.ads.mobile.mediation.maio
OpenUPM
בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את הגדרות מנהל החבילות של Unity.
בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמרשם היקף עם את הפרטים הבאים:
- שם:
OpenUPM
- כתובת אתר:
https://package.openupm.com
- היקפים:
com.google
לאחר מכן עוברים אל חלון > Package Manager כדי לפתוח את Unity Package Manager וגם בוחרים באפשרות My Registries (הרישומים שלי) בתפריט הנפתח.
בוחרים את החבילה Google Mobile Ads maio Mediation ואז לוחצים על התקנה.
חבילת Unity
כדאי להוריד את הגרסה האחרונה של הפלאגין לבחירת רשת (Mediation) של Google Ads לנייד עבור
maio מקישור ההורדה ב-
ה
יומן שינויים
ומחלצים את הקטע
GoogleMobileAdsMaioMediation.unitypackage
מהמיקוד
חדש.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets (נכסים) > ייבוא חבילה >
Custom Package (חבילה מותאמת אישית) ומוצאים את
GoogleMobileAdsMaioMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על
ייבוא.
בשלב הבא בוחרים באפשרות נכסים > פותר הבעיות של Play Services >
Android resolve > סגירה ידנית. המקודד של Unity Play Services
תבצע רזולוציית תלות מאפס ותעתיק את
יחסי תלות מוצהרים בספרייה Assets/Plugins/Android
של
אפליקציית Unity.
שלב 4: מוסיפים את הקוד הנדרש
Android
לא צריך קוד נוסף כדי לשלב ב-maio.
iOS
שילוב של SKAdNetwork
פועלים לפי מסמכי התיעוד של Maio.
כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- Ad Manager
בעלי אפליקציות שמשתמשים בגרסה 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.
- תמיכה במתאם maio ל-iOS בגרסה 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.
- תמיכה במתאם maio ל-iOS בגרסה 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 החדש.
- יש תמיכה במתאם ל-Android של maio בגרסה 1.1.7.0.
- יש תמיכה בגרסה 1.4.6.0 של מתאם iOS ל-maio.
גרסה 1.2.2
- תמיכה במתאם Android של maio בגרסה 1.1.6.0.
- תמיכה במתאם iOS של maio בגרסה 1.4.2.0.
גרסה 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.
- תמיכה במתאם iOS של maio בגרסה 1.3.2.0.
גרסה 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.
- תמיכה במתאם iOS של maio בגרסה 1.3.0.0.
גרסה 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
- גרסה ראשונה!
- תמיכה ב-Android SDK מגרסה 1.0.6 ואילך.
- תמיכה ב-maio iOS SDK בגרסה 1.2.18.