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

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

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

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

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

דרישות

• רמת API ‏23 ומעלה ב-Android

• ‫maio SDK 1.0.7 ואילך

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בוחרים באפשרות maio בתור רשת מודעות, מזינים שם ייחודי ומפעילים גישור.

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

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

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

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

שילוב ידני

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

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

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

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

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

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

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

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

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

קודי שגיאה

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

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

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

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

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