שילוב maio עם תהליך בחירת הרשת (Mediation)

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-maio באמצעות תהליך בחירת הרשת (Mediation) ב-AdMob, כולל שילובים של Waterfall. נסביר איך להוסיף את maio להגדרה של תהליך בחירת הרשת (Mediation) של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של maio באפליקציהAndroid .

בממשק מרכז הבקרה של maio נעשה שימוש בטקסט ביפנית בתוויות, בלחצנים ובתיאורים, וצילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות במדריך הזה, התוויות והלחצנים מופיעים עם השמות שלהם באנגלית. לדוגמה, 'URL 六價ーム' הוא 'סכמת כתובת ה-URL'.

השילובים והפורמטים של המודעות שנתמכים

למתאם בחירת הרשת של maio יש את היכולות הבאות:

דרישות

• Android API ברמה 21 ואילך

• maio SDK 1.0.7 ואילך

• הגרסה העדכנית ביותר של Google Mobile Ads SDK

• מדריך לתחילת העבודה בנושא בחירת הרשת

שלב 1: הגדרת ההגדרות בממשק המשתמש של maio

קודם כול, נרשמים או נכנסים לחשבון maio. לוחצים על הלחצן Application management (ניהול אפליקציות) בסרגל הצד הימני ואז על New app (אפליקציה חדשה).

בוחרים את הכרטיסייה שתואמת לסוג המודעה המועדף.

בדף Application Management, מציינים את Media ID. הוא נדרש להגדרת יחידת המודעות ב-AdMob בקטע הבא.

בדף Zone Management, מציינים את Zone ID. הוא גם יידרש להגדרת יחידת המודעות ב-AdMob בקטע הבא.

שלב 2: הגדרת ביקוש של Maio בממשק המשתמש של AdMob

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

עליך להוסיף maio לתצורה של תהליך בחירת הרשת של יחידת המודעות.

קודם נכנסים לחשבון AdMob. לאחר מכן נכנסים לכרטיסייה תהליך בחירת הרשת (Mediation). אם יש קבוצה קיימת לבחירת רשת שאתם רוצים לשנות, צריך ללחוץ על השם של הקבוצה לבחירת רשת כדי לערוך אותה, ולדלג לקטע הוספה maio כמקור מודעות.

כדי ליצור קבוצה חדשה לבחירת רשת, בוחרים באפשרות יצירת קבוצה לבחירת רשת (Mediation).

מזינים את פורמט המודעה ואת הפלטפורמה, ולוחצים על המשך.

נותנים שם לקבוצה לבחירת רשת (Mediation) ובוחרים מיקומים גיאוגרפיים לטירגוט. בשלב הבא, מגדירים את הסטטוס של הקבוצה לבחירת רשת למופעלת ולוחצים על הוספת יחידות של מודעות.

משייכים את הקבוצה הזו לבחירת רשת לאחת או יותר מיחידות המודעותAdMob הקיימות. לאחר מכן לוחצים על סיום.

עכשיו אתם אמורים לראות שהכרטיס של יחידות המודעות מאוכלס ביחידות של המודעות שבחרתם:

הוספה של maio כמקור מודעות

בכרטיס Waterfall בקטע מקורות מודעות, בוחרים באפשרות הוספת מקור מודעות. לאחר מכן בוחרים maio.

אם כבר יש לכם מיפוי של maio, תוכלו לבחור אותו. אם לא, לוחצים על הוספת מיפוי.

לאחר מכן, מזינים את 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 ברמת האפליקציה. להשתמש בגרסאות העדכניות ביותר של ה-SDK והמתאם של maiO:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

שילוב ידני

• מורידים את הגרסה האחרונה של maio Android SDK ומוסיפים אותה לפרויקט.
• עוברים אל פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) של מתאם Maio ב-Maven Repository של Google. בוחרים את הגרסה האחרונה, מורידים את הקובץ ‎.aar של מתאם maio ומוסיפים אותו לפרויקט.

שלב 4: מוסיפים את הקוד הנדרש

לא נדרש קוד נוסף לשילוב של MAI ב-Android.

שלב 5: בודקים את ההטמעה

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ב-AdMob.

בעלי אפליקציות שמשתמשים בגרסה 11.6.0 ואילך של Google Mobile Ads SDK יקבלו באופן אוטומטי מודעות בדיקה מ-maiO בטלפונים ובטאבלטים שרשומים כמכשירי בדיקה כשהם שולחים בקשות.

אימות מודעות לבדיקה

כדי לוודא שאתם מקבלים מודעות בדיקה מ-maio, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות maio (Waterfall).

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-MAIO, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות ResponseInfo.getAdapterResponses() בכיתות הבאות:

אלה הקודים וההודעות הנלוות שמתאם maio זורק כשטעינה של מודעה נכשלת:

יומן השינויים של מתאם בחירת הרשת של maio ל-Android

גרסה 1.1.16.3

• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-23.0.0.
• תאימות מאומתת עם גרסת SDK של maio‏ 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.
• גרסת SDK של Maio‏ 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.
• גרסת SDK של Maio‏ 1.1.16.

גרסה 1.1.16.0

• קודי השגיאה עודכנו כדי לתעד שגיאות נוספות ב-maio.
• תאימות מאומתת עם גרסת SDK של maio‏ 1.1.16.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-20.4.0.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK בגרסה 20.4.0.
• גרסת SDK של Maio‏ 1.1.16.

גרסה 1.1.15.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.1.15.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-20.0.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 20.0.0.
• גרסת SDK של Maio‏ 1.1.15.

גרסה 1.1.14.0

• נוספו קודים והודעות סטנדרטיים של שגיאות במתאם.
• תאימות מאומתת עם גרסת SDK של maio‏ 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

• תאימות מאומתת עם גרסת SDK של maio‏ 1.1.13.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 19.5.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 19.5.0.
• גרסת SDK של Maio‏ 1.1.13.

גרסה 1.1.12.0

• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.4.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK גרסה 19.4.0.
• גרסת SDK של Maio‏ 1.1.12.

גרסה 1.1.11.1

• כדי להגביל את זמן הקצאת הזמן, בקשות להצגת מודעות יידחו באופן מיידי אם ל-MAIO אין מודעה מוכנה להצגה.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 19.1.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 19.1.0.
• גרסה 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

• תאימות מאומתת עם גרסת SDK של maio‏ 1.1.10.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-18.2.0.

גרסה 1.1.8.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.1.8.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-18.1.0.

גרסה 1.1.7.0

• תיקוני באגים.
• תאימות מאומתת עם גרסת SDK של maio‏ 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

• תאימות מאומתת עם גרסת SDK של maio‏ 1.1.3.

גרסה 1.1.2.1

• עדכנו את המתאם עם פונקציות מודרניות של הפעלה.

גרסה 1.1.2.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.1.2.

גרסה 1.1.1.1

• עדכנו את המתאם כדי להפעיל את אירוע המודעה onRewardedVideoComplete().

גרסה 1.1.1.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.1.1.

גרסה 1.1.0.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.1.0.

גרסה 1.0.8.0

• תאימות מאומתת ל-maio SDK גרסה 1.0.8.

גרסה 1.0.7.1

• תוקנה בעיה שעלולה לגרום ל-NullPointerExceptions להתרחש כשהמודעות לא נטענות.

גרסה 1.0.7.0

• נוספה האפשרות להפעיל מצב בדיקה על ידי הוספת המזהה של מכשיר הבדיקה ל-AdRequest.
• תאימות מאומתת ל-maio SDK גרסה 1.0.7.

גרסה 1.0.6.0

• הגרסה הראשונה!
• הוספנו תמיכה במודעות מעברון ובמודעות וידאו מתגמלות.