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

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

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

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

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

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

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

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

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

  • רמת API ב-Android‏ 24 ואילך.
  • ‫maio SDK 1.0.7 ואילך.

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

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

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

מעברון

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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

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

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

מפעילים את האפשרות איסוף נתונים אוטומטי ומזינים את מזהה ה-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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:maio:2.0.9.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:maio:2.0.9.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

שילוב ידני

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

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

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

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

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

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

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

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

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

קודי שגיאה

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

פורמט שם הסיווג
מעברון 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

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

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

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