שילוב של MAio עם גישור

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

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

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

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

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

דרישות

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

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

שלב 2: הגדרת ביקוש ב-maio Ad Manager בממשק המשתמש

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

בקובץ 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")
}

שילוב ידני

שלב 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

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