במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-maio באמצעות תהליך בחירת הרשת (Mediation), כולל שילובים של Waterfall. נסביר איך להוסיף את maio להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את המתאם וה-SDK של maio באפליקציית Unity.
בממשק מרכז הבקרה של maio נעשה שימוש בטקסט ביפנית עבור התוויות, הלחצנים והתיאורים שלו, וצילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות שכאן, התוויות והלחצנים מתייחסים לתוויות המקבילות שלהן באנגלית. לדוגמה,"כתובת URL スーム", הוא "סכמת כתובת URL", וכן הלאה.
שילובים נתמכים ופורמטים נתמכים של מודעות
המתאם של תהליך בחירת הרשת ב-maio כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
דפי ביניים | |
ההטבה הופעלה |
דרישות
- Unity 4 ואילך
- ה-SDK העדכני של מודעות Google לנייד
- כדי לפרוס ב-Android
- Android API ברמת 19 ואילך
- כדי לפרוס ב-iOS
- יעד הפריסה של iOS הוא 12.0 ומעלה
- פרויקט Unity פועל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- משלימים את ההוראות של תהליך בחירת הרשת (Mediation) המדריך לתחילת העבודה
שלב 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 Mobile Ads לגישור עבור maio מהקישור להורדה ב-Changelog ל-maio ומחלצים את GoogleMobileAdsMaioMediation.unitypackage
מקובץ ה-zip.
בעורך הפרויקטים ב-Unity, בוחרים באפשרות נכסים > ייבוא חבילה > בהתאמה אישית
חבילה ומוצאים את הקובץ GoogleMobileAdsMaioMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על ייבוא.
לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force Solution. ספריית Unity Play Services Solutionr תבצע פתרון תלויי מההתחלה ותעתיק את יחסי התלות המוצהרים לספרייה 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 (Bidding) and 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 | למאיה אין מודעה זמינה. |
102 | פרמטרים לא חוקיים של השרת (למשל, חסר מזהה מיקום). |
103 | ההקשר ששימש לטעינת מודעה לא היה מופע 'פעילות'. |
iOS
קוד שגיאה | סיבה |
---|---|
0-10 | maio החזיר שגיאה ספציפית ל-SDK. למידע נוסף אפשר לעיין בקוד של maio. |
101 | ל-maio עדיין אין מודעה זמינה. |
102 | פרמטרים לא חוקיים של השרת (למשל, חסר מזהה מיקום). |
103 | המתאם של maio לא תומך בפורמט המודעה המבוקש. |
104 | כבר נטענה מודעה עבור תצורת הרשת הזו. |
יומן שינויים של פלאגין הגישור של maio Unity
גרסה 2.0.0
- יש תמיכה במתאם maio ל-Android בגרסה 1.1.16.2.
- יש תמיכה במתאם maio ל-iOS בגרסה 2.1.1.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.6.0.
גרסה 1.4.3
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/Maio/
. - יש תמיכה במתאם maio ל-Android בגרסה 1.1.16.2.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.6.3.1.
- אפליקציית Google Mobile Ads Unity גרסה 8.1.0 נוצרה ונבדקה.
גרסה 1.4.2
- יש תמיכה במתאם maio ל-Android בגרסה 1.1.16.1.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.6.3.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.4.0.
גרסה 1.4.1
- יש תמיכה במתאם maio ל-Android בגרסה 1.1.16.1.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.6.2.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.1.0.
גרסה 1.4.0
- יש תמיכה במתאם maio ל-Android בגרסה 1.1.16.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.6.0.1.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.0.
גרסה 1.3.6
- יש תמיכה במתאם maio ל-Android בגרסה 1.1.16.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.5.8.0.
גרסה 1.3.5
- יש תמיכה במתאם maio ל-Android בגרסה 1.1.15.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.5.6.1.
גרסה 1.3.4
- יש תמיכה במתאם maio ל-Android בגרסה 1.1.11.1.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.5.4.0.
גרסה 1.3.3
- יש תמיכה במתאם maio ל-Android בגרסה 1.1.11.1.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.5.3.1.
גרסה 1.3.2
- יש תמיכה במתאם maio ל-Android בגרסה 1.1.11.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.5.2.1.
גרסה 1.3.1
- יש תמיכה במתאם maio ל-Android בגרסה 1.1.10.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.5.1.0.
גרסה 1.3.0
- יש תמיכה במתאם maio ל-Android בגרסה 1.1.10.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.5.0.0.
גרסה 1.2.3
- הפלאגין עודכן כך שיתמוך בממשק ה-API החדש של מתגמלות.
- תומך במתאם maio ל-Android בגרסה 1.1.7.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.4.6.0.
גרסה 1.2.2
- תומך במתאם maio ל-Android בגרסה 1.1.6.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.4.2.0.
גרסה 1.2.1
- תומך במתאם maio ל-Android בגרסה 1.1.6.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.4.1.0.
גרסה 1.2.0
- תומך במתאם maio ל-Android בגרסה 1.1.4.1.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.4.0.0.
גרסה 1.1.3
- תומך במתאם maio ל-Android בגרסה 1.1.3.1.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.3.2.0.
גרסה 1.1.2
- תומך במתאם maio ל-Android בגרסה 1.1.3.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.3.2.0.
גרסה 1.1.1
- תומך במתאם maio ל-Android בגרסה 1.1.1.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 1.3.1.1.
גרסה 1.1.0
- תומך במתאם maio ל-Android בגרסה 1.1.0.0.
- יש תמיכה במתאם maio ל-iOS בגרסה 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
- השקה ראשונה!
- תומך ב-maio Android SDK בגרסה 1.0.6.
- יש תמיכה ב-maio iOS SDK בגרסה 1.2.18.