במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-MAIO באמצעות תהליך בחירת הרשת, כולל שילובים של רשתות ב-Waterfall. במדריך מוסבר איך להוסיף את maio להגדרות תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של maio באפליקציה של Unity.
בממשק של מרכז הבקרה של maio נעשה שימוש בטקסט ביפנית בתווית, בלחצנים ובתיאורים, והצילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות שבהמשך, נעשה שימוש בשמות האנגליים של התוויות והלחצנים. לדוגמה, 'URL スキーム' הוא 'URL Scheme'.
השילובים והפורמטים של המודעות הנתמכים
למתאם בחירת הרשת של MAI יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
מודעת באנר | |
דפי ביניים | |
ההטבה הופעלה |
דרישות
- Unity 4 ואילך
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- כדי לפרוס ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדרה בו ה-Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של MAIO
קודם כול, נרשמים או נכנסים לחשבון maio. לוחצים על הלחצן Application management (ניהול אפליקציות) בסרגל הצד הימני, ואז לוחצים על New app (אפליקציה חדשה).
בוחרים את הכרטיסייה שתואמת לסוג המודעה המועדף.
מזינים את השם של האפליקציה, בוחרים את הפלטפורמה ומספקים את כתובת ה-URL של האפליקציה. בוחרים באפשרות מודעת מעברון וידאו בתור סוג המודעה ולוחצים על עדכון.
מזינים את השם של האפליקציה, בוחרים את הפלטפורמה ומספקים את כתובת ה-URL של האפליקציה. בוחרים באפשרות Video Rewards בתור סוג המודעה ולוחצים על עדכון.
בדף Application Management, מציינים את Media ID. הוא נדרש להגדרת יחידת המודעות ב-AdMob בקטע הבא.
בדף Zone Management, מציינים את Zone ID. תצטרכו להשתמש בו גם כדי להגדיר את יחידת המודעות ב-AdMob בקטע הבא.
שלב 2: הגדרת ביקוש של Maio בממשק המשתמש של AdMob
הגדרת הגדרות בחירת הרשת ליחידת המודעות
להוראות, אפשר לעיין בשלב 2 במדריך ל-Android.
להוראות, אפשר לעיין בשלב 2 במדריך ל-iOS.
שלב 3: מייבאים את ה-SDK ואת המתאם של maio
אם OpenUPM-CLI מותקן, אפשר להתקין את הפלאגין של Google Mobile Ads לממשק בחירת הרשת (Mediation) של MAIO ל-Unity בפרויקט באמצעות הפקודה הבאה מהספרייה ברמה הבסיסית של הפרויקט:
openupm add com.google.ads.mobile.mediation.maio
בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את הגדרות מנהל החבילות של Unity.
בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר שמוגדר לפי היקף עם הפרטים הבאים:
- שם:
OpenUPM
- כתובת אתר:
https://package.openupm.com
- היקפים:
com.google
לאחר מכן, עוברים אל Window > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries בתפריט הנפתח.
בוחרים בחבילה Google Mobile Ads maio Mediation ולוחצים על Install.
מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור maiO מהקישור להורדה שמופיע בChangelog ומחלצים את הקובץ GoogleMobileAdsMaioMediation.unitypackage
מקובץ ה-zip.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > Import Package > Custom Package ומאתרים את הקובץ GoogleMobileAdsMaioMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.
לאחר מכן בוחרים באפשרות נכסים > מנהל יחסי תלות חיצוניים > Android Resolver > Force Resolve. ספריית External Dependency Manager תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות שהוצהרו לתיקייה Assets/Plugins/Android
באפליקציה שלכם ב-Unity.
שלב 4: מוסיפים את הקוד הנדרש
לא נדרשת הטמעת קוד נוספת לשילוב עם MAI.
שילוב עם SKAdNetwork
פועלים לפי המסמכים של maiO כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בדיקה מעשית של ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-AdMob.
בעלי אפליקציות שמשתמשים בגרסה 7.26.0 ואילך של Google Mobile Ads SDK יקבלו באופן אוטומטי מודעות לבדיקה מ-maiO בטלפונים ובטאבלטים שרשומים בתור מכשירים לבדיקה כשהם שולחים בקשות.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-maio, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות maio (Waterfall).
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-MAIO, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות ResponseInfo
בקטגוריות הבאות:
פורמט | שם הכיתה |
---|---|
מעברון | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
ההטבה הופעלה | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
פורמט | שם הכיתה |
---|---|
מעברון | GADMMaioInterstitialAdapter |
ההטבה הופעלה | GADMMaioRewardedAdapter |
אלה הקודים וההודעות שמופיעים במתאם MAIO כשהמודעה לא נטענת:
קוד שגיאה | סיבה |
---|---|
0-10 | ה-maiO החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים בקוד ובמסמכי התיעוד של maio. |
101 | אין מודעה זמינה ל-Maio. |
102 | פרמטרים לא חוקיים של שרת (למשל, חסר מזהה מיקום מודעה). |
103 | ההקשר ששימש לטעינת מודעה לא היה מופע של 'פעילות'. |
קוד שגיאה | סיבה |
---|---|
0-10 | ה-maiO החזיר שגיאה ספציפית ל-SDK. לפרטים נוספים, אפשר לעיין בקוד של maio. |
101 | עדיין אין מודעה זמינה ב-maiO. |
102 | פרמטרים לא חוקיים של שרת (למשל, חסר מזהה מיקום מודעה). |
103 | מתאם MAIO לא תומך בפורמט המודעה המבוקש. |
104 | כבר נטענה מודעה להגדרת הרשת הזו. |
יומן השינויים של הפלאגין של maio לבחירת רשת ב-Unity
גרסה 2.0.4
- תמיכה במתאם Android של maio בגרסה 1.1.16.3.
- תמיכה במתאם maio ל-iOS בגרסה 2.1.5.1.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.3.0.
גרסה 2.0.3
- תמיכה במתאם Android של maio בגרסה 1.1.16.3.
- תמיכה במתאם maio ל-iOS בגרסה 2.1.5.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.
גרסה 2.0.2
- תמיכה במתאם Android של maio בגרסה 1.1.16.3.
- תמיכה במתאם maio ל-iOS בגרסה 2.1.4.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.0.0.
גרסה 2.0.1
- תמיכה במתאם Android של maio מגרסה 1.1.16.2.
- תמיכה במתאם maio ל-iOS בגרסה 2.1.3.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.0.0.
גרסה 2.0.0
- תמיכה במתאם Android של maio מגרסה 1.1.16.2.
- תמיכה במתאם maio ל-iOS בגרסה 2.1.1.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.6.0.
גרסה 1.4.3
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/Maio/
. - תמיכה במתאם Android של maio מגרסה 1.1.16.2.
- תמיכה במתאם iOS של maio בגרסה 1.6.3.1.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.1.0.
גרסה 1.4.2
- תמיכה במתאם Android של maio מגרסה 1.1.16.1.
- תמיכה במתאם maio ל-iOS בגרסה 1.6.3.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.4.0.
גרסה 1.4.1
- תמיכה במתאם Android של maio מגרסה 1.1.16.1.
- תמיכה במתאם iOS של maio בגרסה 1.6.2.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.1.0.
גרסה 1.4.0
- תמיכה במתאם Android של maio מגרסה 1.1.16.0.
- תמיכה במתאם maio ל-iOS בגרסה 1.6.0.1.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.0.0.
גרסה 1.3.6
- תמיכה במתאם Android של maio מגרסה 1.1.16.0.
- תמיכה במתאם maio ל-iOS בגרסה 1.5.8.0.
גרסה 1.3.5
- תמיכה במתאם Android של maio בגרסה 1.1.15.0.
- תמיכה במתאם maio ל-iOS בגרסה 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.
- תמיכה במתאם maio ל-iOS בגרסה 1.5.2.1.
גרסה 1.3.1
- תמיכה במתאם Android של maio בגרסה 1.1.10.0.
- תמיכה במתאם maio ל-iOS בגרסה 1.5.1.0.
גרסה 1.3.0
- תמיכה במתאם Android של maio בגרסה 1.1.10.0.
- תמיכה במתאם maio ל-iOS בגרסה 1.5.0.0.
גרסה 1.2.3
- עדכנו את הפלאגין כך שיתמוך ב-Rewarded API החדש.
- תמיכה במתאם Android של maio בגרסה 1.1.7.0.
- תמיכה במתאם iOS של maio בגרסה 1.4.6.0.
גרסה 1.2.2
- תמיכה במתאם Android של maio בגרסה 1.1.6.0.
- תמיכה במתאם iOS של maio בגרסה 1.4.2.0.
גרסה 1.2.1
- תמיכה במתאם Android של maio בגרסה 1.1.6.0.
- תמיכה במתאם iOS של maio בגרסה 1.4.1.0.
גרסה 1.2.0
- תמיכה במתאם Android של maio בגרסה 1.1.4.1.
- תמיכה במתאם iOS של maio בגרסה 1.4.0.0.
גרסה 1.1.3
- התמיכה מתבצעת במתאם Android של maio בגרסה 1.1.3.1.
- תמיכה במתאם iOS של maio בגרסה 1.3.2.0.
גרסה 1.1.2
- תמיכה במתאם Android של maio בגרסה 1.1.3.0.
- תמיכה במתאם iOS של maio בגרסה 1.3.2.0.
גרסה 1.1.1
- תמיכה במתאם Android של maio מגרסה 1.1.1.0.
- תמיכה במתאם iOS של maio בגרסה 1.3.1.1.
גרסה 1.1.0
- תמיכה במתאם Android של maio מגרסה 1.1.0.0.
- תמיכה במתאם iOS של maio בגרסה 1.3.0.0.
גרסה 1.0.2
- תמיכה ב-Android SDK מגרסה 1.0.8.
- יש תמיכה ב-maiO iOS SDK מגרסה 1.2.19.
גרסה 1.0.1
- תמיכה ב-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.