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

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

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

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

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

שילוב
בידינג
מפל
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה
מותאם

דרישות

  • Android API ברמה 21 ואילך
  • SDK של maio בגרסה 1.0.7 ואילך

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

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

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

מעברון

מזינים את השם של האפליקציה, בוחרים את הפלטפורמה ומספקים את כתובת ה-URL של האפליקציה. בוחרים באפשרות מודעת מעברון וידאו בתור סוג המודעה ולוחצים על עדכון.

ההטבה הופעלה

מזינים את השם של האפליקציה, בוחרים את הפלטפורמה ומספקים את כתובת ה-URL של האפליקציה. בוחרים באפשרות Video Rewards בתור סוג המודעה ולוחצים על עדכון.

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

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

בנוסף למזהה המדיה ולמזהה האזור, תצטרכו מזהה API ומפתח API כדי להגדיר את מזהה יחידת המודעות לצורך תהליך בחירת הרשת (Mediation). בדף Reporting API, מתעדים את מזהה ה-API ואת מפתח ה-API.

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

הגדרת הגדרות בחירת הרשת ליחידת המודעות

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

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

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

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

נותנים שם לקבוצה לבחירת רשת ובוחרים את המיקומים לטירגוט. לאחר מכן, מגדירים את הסטטוס של קבוצת בחירת הרשת ל-מופעל ולוחצים על הוספת יחידות מודעות.

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

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

הוספת MAI כמקור מודעות


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

בוחרים באפשרות maio ומפעילים את המתג Optimize. מזינים את מזהה ה-API ואת מפתח ה-API שהתקבלו בקטע הקודם כדי להגדיר אופטימיזציה של מקורות המודעות ב-maio. לאחר מכן, מזינים ערך של עלות בפועל לאלף חשיפות עבור maio ולוחצים על המשך.



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

בשלב הבא, מזינים את Media ID ואת Zone ID שהתקבלו בקטע הקודם. לאחר מכן לוחצים על סיום.


שלב 3: מייבאים את ה-SDK ואת המתאם של maio

מוסיפים את המאגרים הבאים לקובץ 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.6.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

שילוב ידני

  • מורידים את הגרסה האחרונה של maio Android SDK ומוסיפים אותה לפרויקט.
  • עוברים אל ארטיפקטים של מתאם maio במאגר Maven של Google. בוחרים את הגרסה האחרונה, מורידים את הקובץ ‎.aar של מתאם maio ומוסיפים אותו לפרויקט.

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

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

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

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

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

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

יומן השינויים של מתאם בחירת הרשת של 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.
  • גרסת SDK של Maio‏ 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

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

גרסה 1.1.11.0

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

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

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

גרסה 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

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

גרסה 1.1.5.0

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

גרסה 1.1.4.0

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

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

גרסה 1.0.7.1

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

גרסה 1.0.7.0

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

גרסה 1.0.6.0

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