במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-maio באמצעות תהליך בחירת הרשת (Mediation), שכוללות שילובים של Waterfall. המאמר מסביר איך להוסיף את maio ליחידת מודעות הגדרת תהליך בחירת הרשת, ואיך לשלב את ה-SDK והמתאם של maio אפליקציה אחת (Android )
בממשק מרכז הבקרה של maio נעשה שימוש בטקסט ביפנית בתור התוויות, הלחצנים ותיאורים, וצילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות של מדריך זה, תוויות ולחצנים ומזכירים את המונחים המקבילים להם באנגלית. "URL insertーム", לדוגמה, היא 'סכמת כתובת ה-URL'.
השילובים והפורמטים של המודעות שנתמכים
למתאם תהליך בחירת הרשת ב-maio יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מותאם |
דרישות
- Android API ברמה 21 ואילך
- maio SDK 1.0.7 ואילך
ה-SDK העדכני של Google Mobile Ads
השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של maio
קודם כל, נרשמים או מתחברים לחשבון maio. בסרגל הצד שמשמאל, לוחצים על Application management ואז על New app.
בוחרים את הכרטיסייה שתואמת לסוג המודעה המועדף.
פרסומת מרווח ביניים
נותנים שם לאפליקציה, בוחרים את הפלטפורמה ומזינים את כתובת ה-URL של האפליקציה. בחר באפשרות מודעת מעברון בווידאו בתור סוג המודעה, ולחץ על עדכון.
ההטבה הופעלה
נותנים שם לאפליקציה, בוחרים את הפלטפורמה ומזינים את כתובת ה-URL של האפליקציה. בוחרים באפשרות Video Rewards בתור סוג המודעה ולוחצים על עדכון.
בדף Application Management שים לב למזהה המדיה. תצטרכו להגדיר את יחידת המודעות Ad Manager בקטע הבא.
בדף Zone Management מציינים את Zone ID. בקטע הבא תצטרכו גם להגדיר את Ad Manager יחידת המודעות.
שלב 2: הגדרת ביקוש ב-maio Ad Manager בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
נכנסים לחשבון Ad Manager.
עבור אל הצגה > קבוצות תפוקה ולחץ על הלחצן קבוצת תפוקה חדשה.
מזינים שם ייחודי לקבוצת התפוקה, מגדירים את הסטטוס ל-Active, בוחרים את פורמט המודעה ומגדירים את סוג המלאי לאפליקציה לנייד. בקטע Targeting > Inventory (טירגוט > מלאי) בוחרים את יחידת המודעות בקטע Inventory (מלאי) וMobile application שרוצים להוסיף להם את תהליך בחירת הרשת.
לאחר מכן לוחצים על הלחצן הוספת שותף תפוקה.
אם כבר יש לכם שותף תפוקה עבורmaio, אתם יכולים לבחור אותו. אם לא, בוחרים באפשרות יצירת שותף תפוקה חדש.
בוחרים באפשרות maio בתור רשת המודעות, מזינים שם ייחודי ומפעילים את תהליך בחירת הרשת.
מפעילים את האפשרות Automatic data collection (איסוף נתונים אוטומטי) ומזינים את הערךAPI ID and API KEY שקיבלתם בסעיף הקודם.
אחרי שבוחרים באפשרות Yield partner, בוחרים ב-Mobile SDK Mediation בתור סוג השילוב, ב-Android בתור הפלטפורמה וב-Active בתור Status. מזינים את Media ID and Zone ID התקבל בקטע הקודם. לאחר מכן, מזינים ערך של עלות ברירת מחדל לאלף חשיפות.
לסיום, לוחצים על שמירה בחלק התחתון של הדף.
שלב 3: מייבאים את ה-SDK והמתאם של maio
שילוב עם Android Studio (מומלץ)
בקובץ settings.gradle.kts
ברמת הפרויקט, מוסיפים את הפרטים הבאים
מאגרים:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
לאחר מכן, בקובץ build.gradle.kts
ברמת האפליקציה מוסיפים את הפרטים הבאים
ותלויות אישיות בהטמעות. להשתמש בגרסאות האחרונות של
maio SDK ומתאם:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
שילוב ידני
- הורדת הגרסה האחרונה של maio Android SDK ומוסיפים אותו לפרויקט שלכם.
- עוברים אל פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) של מתאם Maio ב-Maven Repository של Google. בוחרים את הגרסה העדכנית ביותר, מורידים את קובץ.aar של מתאם maio ומוסיפים אותו לפרויקט.
שלב 4: מוסיפים את הקוד הנדרש
לא נדרש קוד נוסף כדי לשלב ב-maio Android.
שלב 5: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- Ad Manager
בעלי אפליקציות שמשתמשים בגרסה 11.6.0 ואילך של Google Mobile Ads SDK יקבלו באופן אוטומטי מודעות בדיקה מ-maio בטלפונים ובטאבלטים שרשומים כמכשירי בדיקה בזמן שליחת הבקשות.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-maio, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות maio (Waterfall) מקורות המודעות.
קודי שגיאה
אם המתאם לא מקבל מודעה מ-maio,
בעלי התוכן הדיגיטלי יכולים לבדוק את השגיאה הבסיסית בתגובה עם המודעה באמצעות
ResponseInfo.getAdapterResponses()
בסיווגים הבאים:
פורמט | שם הכיתה |
---|---|
מעברון | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
ההטבה הופעלה | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
אלה הקודים וההודעות הנלוות שמתאם maio זורק כשטעינה של מודעה נכשלת:
קוד שגיאה | סיבה |
---|---|
0-10 | maio החזירה שגיאה ספציפית ל-SDK. להצגת הקוד והמסמכים של maio אפשר לקבל פרטים נוספים. |
101 | אין ל-Maio מודעה זמינה. |
102 | פרמטרים לא חוקיים של שרת (למשל, חסר מזהה מיקום). |
103 | ההקשר ששימש לטעינת מודעה לא היה מופע של 'פעילות'. |
יומן שינויים של מתאם תהליך בחירת הרשת (Mediation) ב-maio ב-Android
גרסה 1.1.16.3
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 23.0.0.
- תאימות מאומתת ל-maio SDK גרסה 1.1.16.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 23.0.0.
- Maio SDK גרסה 1.1.16.
גרסה 1.1.16.2
- המתאם עודכן כדי להשתמש במחלקה החדשה
VersionInfo
. - הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 22.0.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 22.0.0.
- Maio SDK גרסה 1.1.16.
גרסה 1.1.16.1
compileSdkVersion
ו-targetSdkVersion
עודכנו ל-API 31.- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 21.0.0.
- רמת ה-API המינימלית הנדרשת ב-Android עודכנה ל-19.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 21.0.0.
- Maio SDK גרסה 1.1.16.
גרסה 1.1.16.0
- קודי השגיאה עודכנו כדי לתעד שגיאות נוספות ב-maio.
- תאימות מאומתת ל-maio SDK גרסה 1.1.16.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.4.0.
פותח ונבדק בעזרת:
- גרסה 20.4.0 של Google Mobile Ads SDK.
- Maio SDK גרסה 1.1.16.
גרסה 1.1.15.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.15.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 20.0.0.
פותח ונבדק בעזרת:
- גרסה 20.0.0 של Google Mobile Ads SDK.
- גרסה 1.1.15 של Maio SDK.
גרסה 1.1.14.0
- נוספו הודעות וקודי שגיאה של מתאם סטנדרטי.
- תאימות מאומתת ל-maio SDK גרסה 1.1.14.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 19.8.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 19.8.0.
- Maio SDK גרסה 1.1.14.
גרסה 1.1.13.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.13.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 19.5.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 19.5.0.
- Maio SDK גרסה 1.1.13.
גרסה 1.1.12.0
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.4.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 19.4.0.
- Maio SDK גרסה 1.1.12.
גרסה 1.1.11.1
- כדי להגביל את הצגת המודעות, בקשות להצגת מודעות ייכשלו באופן מיידי אם אין ל-maio מודעה מוכנה להצגה.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.1.0.
פותח ונבדק בעזרת:
- גרסה 19.1.0 של Google Mobile Ads SDK
- גרסה 1.1.11 של Maio SDK.
גרסה 1.1.11.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.11.
- עדכנת את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-18.3.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 18.3.0.
- גרסה 1.1.11 של Maio SDK.
גרסה 1.1.10.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.10.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-18.2.0.
גרסה 1.1.8.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.8.
- עדכנת את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-18.1.0.
גרסה 1.1.7.0
- תיקוני באגים.
- תאימות מאומתת ל-maio SDK גרסה 1.1.7.
גרסה 1.1.6.1
- המתאם עודכן כדי לתמוך בממשק החדש של Rewarded API.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 17.2.0.
גרסה 1.1.6.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.6.
גרסה 1.1.5.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.5.
גרסה 1.1.4.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.4.
גרסה 1.1.3.1
- המתאם עודכן כך שיפעל עם מחלקה של מכונה במקום סינגלטון.
גרסה 1.1.3.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.3.
גרסה 1.1.2.1
- פונקציות האתחול המעודכנות עודכנו במתאם.
גרסה 1.1.2.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.2.
גרסה 1.1.1.1
- המתאם עודכן כדי להפעיל את אירוע המודעה
onRewardedVideoComplete()
.
גרסה 1.1.1.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.1.
גרסה 1.1.0.0
- תאימות מאומתת ל-maio SDK גרסה 1.1.0.
גרסה 1.0.8.0
- תאימות מאומתת ל-maio SDK גרסה 1.0.8.
גרסה 1.0.7.1
- תוקנה בעיה שעלולה לגרום ל-NullPointerחריגים להתרחש כאשר מודעות נכשלו לטעינה.
גרסה 1.0.7.0
- נוספה האפשרות להפעיל מצב בדיקה על ידי הוספת המזהה של מכשיר הבדיקה ל-
AdRequest
. - תאימות מאומתת ל-maio SDK גרסה 1.0.7.
גרסה 1.0.6.0
- גרסה ראשונה!
- הוספנו תמיכה במודעות מעברון ובמודעות וידאו מתגמלות.