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

בחירת פלטפורמה: Android iOS Unity Flutter Android (Legacy)

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

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

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

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

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

דרישות מוקדמות

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

  • ‫Android API ברמה 24 ואילך.
  • ‫maio SDK בגרסה 1.0.7 ואילך.

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

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

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

מעברון

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

ההטבה הופעלה

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

בדף Application Management (ניהול אפליקציות), רושמים את מזהה המדיה. הוא נדרש כדי להגדיר את יחידת המודעות ב-Ad Manager בקטע הבא.

בדף Zone Management (ניהול אזורים), רושמים את מזהה האזור. תצטרכו אותו גם כדי להגדיר את יחידת המודעות ב-Ad Manager בקטע הבא.

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

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

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

נכנסים לחשבון Ad Manager.

עוברים אל Delivery > Yield groups ולוחצים על הכפתור New yield group.

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

לאחר מכן לוחצים על הלחצן הוספת שותף להגדלת נפח התנועה.

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

בוחרים באפשרות maio בתור רשת המודעות, מזינים שם ייחודי ומפעילים את האפשרות תהליך בחירת הרשת (Mediation).

מפעילים את האפשרות איסוף נתונים אוטומטי ומזינים את מזהה ה-API ואת מפתח ה-API שקיבלתם בקטע הקודם.

אחרי שבוחרים את השותף להגדלת נפח תנועת הגולשים, בוחרים באפשרות Mobile SDK Mediation בתור סוג השילוב, באפשרות Android בתור פלטפורמה ובאפשרות פעיל בתור סטטוס. מזינים את מזהה המדיה ואת מזהה האזור שקיבלתם בקטע הקודם. אחר כך מזינים ערך בשדה עלות ברירת מחדל לאלף חשיפות.

בסיום, לוחצים על שמירה בחלק התחתון של הדף.

שלב 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.5.0")
    implementation("com.google.ads.mediation:maio:2.0.9.1")
}

Groovy

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

שילוב ידני

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

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

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

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

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

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

בעלי אפליקציות שמשתמשים בגרסה 11.6.0 ואילך של Google Mobile Ads SDK (Legacy) יקבלו באופן אוטומטי מודעות בדיקה מ-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 ההקשר ששימש לטעינת מודעה לא היה מופע של "פעילות".
104 הבקשה כללה הגבלות שקשורות לגיל, אבל ערכת ה-SDK של maio לא יכולה לקבל אותות שקשורים להגבלות גיל

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

גרסה 2.0.9.1

  • מצמידים את התלות של המתאם ב-Kotlin לגרסה 1.9.0 (גרסת Kotlin המינימלית שנתמכת על ידי GMA NextGen SDK).
  • תוקנה התנהגות ברירת המחדל של הסתעפויות כשל עם הגבלת גיל במהלך בקשות לאתחול מודעות ולטעינת מודעות.

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

  • גרסה 25.4.0 של Google Mobile Ads SDK.
  • גרסה 1.5.0 של Google Mobile Ads Next-Gen SDK.
  • גרסת Maio SDK‏ 2.0.9.1.

גרסה 2.0.9.0

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

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

  • גרסה 25.4.0 של Google Mobile Ads SDK.
  • גרסה 1.3.1 של Google Mobile Ads Next-Gen SDK.
  • גרסת Maio SDK‏ 2.0.9.0.

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

  • הוסרו הפניות ברמת הכיתה ל-Context. יכול לעזור לצמצם בעיות של דליפת זיכרון
  • תאימות מאומתת לגרסה 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.
  • גרסה 2.0.5.0 של Maio SDK.

‫גרסה 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.
  • גרסה 1.1.14 של Maio SDK.

גרסה 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.
  • גרסת Maio SDK‏ 1.1.12.

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

  • המתאם עודכן כך שיפעל עם מחלקת מכונה במקום עם סינגלטון.

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

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