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

בחירת פלטפורמה: Android חדש Android iOS Unity Flutter

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

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

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

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

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

דרישות

  • רמת API‏ 23 ומעלה ב-Android
  • ‫maio SDK 1.0.7 ואילך

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

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

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

מעברון

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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

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

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

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

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


בכרטיס Waterfall שבקטע Ad Sources, לוחצים על Add Ad Source.

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



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

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


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

בקובץ settings.gradle.kts ברמת הפרויקט, מוסיפים את המאגרים הבאים:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

בקובץ Gradle ברמת האפליקציה, מוסיפים את יחסי התלות הבאים של ההטמעה:

Kotlin

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

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.3.0'
    implementation 'com.google.ads.mediation:maio:2.0.8.2'
}

שילוב ידני

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

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

לא נדרש קוד נוסף לשילוב של maio ב-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 ההקשר ששימש לטעינת המודעה לא היה מופע של Activity.
104 הבקשה כללה טיפול בהגבלות שקשורות לגיל, אבל ערכת ה-SDK של maio לא יכולה לקבל אותות של הגבלות שקשורות לגיל

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

הגרסה הבאה

  • סינון בקשות עם הגבלת גיל ב-maio SDK כשערך חדש של AgeRestrictedTreatment מוגדר כ-CHILD.

גרסה 2.0.8.2

  • סינון בקשות עם הגבלת גיל ל-maio SDK כי הוא לא יכול לקבל אותות עם הגבלת גיל.
  • נוסף מאפיין ליצירת המתאם עם תלות ב-GMA Next-Gen SDK.

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

  • גרסה 25.1.0 של Google Mobile Ads SDK.
  • גרסה 1.1.0 של Google Mobile Ads Next-Gen SDK.
  • גרסת Maio SDK‏ 2.0.8.2.

גרסה 2.0.8.1

  • נוספה תמיכה בפורמט של מודעות באנר

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

  • גרסה 25.0.0 של Google Mobile Ads SDK.
  • גרסה 2.0.8.1 של Maio SDK.

גרסה 2.0.8.0

  • תאימות מאומתת לגרסה 2.0.8 של maio SDK.

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

  • גרסה 24.9.0 של Google Mobile Ads SDK.
  • גרסה 2.0.8.0 של Maio SDK.

גרסה 2.0.7.0

  • תאימות מאומתת לגרסה 2.0.7 של maio SDK.

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

  • גרסה 24.7.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.0.7.0.

גרסה 2.0.6.0

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

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

  • גרסה 24.6.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.0.6.0.

גרסה 2.0.5.0

  • תאימות מאומתת לגרסה 2.0.5 של maio SDK.

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

  • גרסה 24.4.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.0.5.0.

גרסה 2.0.4.0

  • תאימות מאומתת לגרסה 2.0.4 של maio SDK.

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

  • גרסה 24.3.0 של Google Mobile Ads SDK.
  • גרסה 2.0.4.0 של Maio SDK.

גרסה 2.0.3.1

  • עדכנו את רמת ה-API המינימלית הנדרשת ב-Android ל-23.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-24.0.0.

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

  • גרסה 24.0.0 של Google Mobile Ads SDK.
  • גרסה 2.0.3.0 של Maio SDK.

גרסה 2.0.3.0

  • תאימות מאומתת לגרסה 2.0.3.0 של maio SDK.

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

  • גרסה 23.6.0 של Google Mobile Ads SDK.
  • גרסה 2.0.3.0 של Maio SDK.

גרסה 1.1.16.3

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

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

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

גרסה 1.1.16.2

  • המתאם עודכן לשימוש במחלקה החדשה VersionInfo.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.0.0.

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

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

גרסה 1.1.16.1

  • העדכון של compileSdkVersion ו-targetSdkVersion ל-API 31.
  • עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-21.0.0.
  • עדכנו את רמת ה-API המינימלית הנדרשת ב-Android ל-19.

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

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

גרסה 1.1.16.0

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

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

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

גרסה 1.1.15.0

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

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

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

גרסה 1.1.14.0

  • נוספו קודים והודעות שגיאה סטנדרטיים של המתאם.
  • תאימות מאומתת לגרסה 1.1.14 של maio SDK.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.8.0.

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

  • גרסה 19.8.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.1.14.

גרסה 1.1.13.0

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

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

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

גרסה 1.1.12.0

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

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

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

גרסה 1.1.11.1

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

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

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

גרסה 1.1.11.0

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

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

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

גרסה 1.1.10.0

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

גרסה 1.1.8.0

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

גרסה 1.1.7.0

  • תיקוני באגים.
  • תאימות מאומתת לגרסה 1.1.7 של maio SDK.

גרסה 1.1.6.1

  • עדכנו את המתאם כדי לתמוך ב-API החדש של מודעות מתגמלות.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-17.2.0.

גרסה 1.1.6.0

  • תאימות מאומתת לגרסה 1.1.6 של maio SDK.

גרסה 1.1.5.0

  • תאימות מאומתת לגרסה 1.1.5 של maio SDK.

גרסה 1.1.4.0

  • תאימות מאומתת לגרסה 1.1.4 של maio SDK.

גרסה 1.1.3.1

  • המתאם עודכן כדי לפעול עם מחלקת מופעים במקום עם singleton.

גרסה 1.1.3.0

  • תאימות מאומתת לגרסה 1.1.3 של maio SDK.

גרסה 1.1.2.1

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

גרסה 1.1.2.0

  • תאימות מאומתת לגרסה 1.1.2 של maio SDK.

גרסה 1.1.1.1

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

גרסה 1.1.1.0

  • תאימות מאומתת לגרסה 1.1.1 של maio SDK.

גרסה 1.1.0.0

  • תאימות מאומתת לגרסה 1.1.0 של maio SDK.

גרסה 1.0.8.0

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

גרסה 1.0.7.1

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

גרסה 1.0.7.0

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

גרסה 1.0.6.0

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