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

קודם כל, נרשמים או מתחברים לחשבון maio. בסרגל הצד שמשמאל, לוחצים על Application management ואז על New app.

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

פרסומת מרווח ביניים

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

ההטבה הופעלה

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

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

בדף Zone Management מציינים את Zone ID. בקטע הבא תצטרכו גם להגדיר את Ad Manager יחידת המודעות.

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

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

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

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

עבור אל הצגה > קבוצות תפוקה ולחץ על הלחצן קבוצת תפוקה חדשה.

מזינים שם ייחודי לקבוצת התפוקה, מגדירים את הסטטוס ל-Active, בוחרים את פורמט המודעה ומגדירים את סוג המלאי לאפליקציה לנייד. בקטע Targeting > Inventory (טירגוט > מלאי) בוחרים את יחידת המודעות בקטע Inventory (מלאי) וMobile application שרוצים להוסיף להם את תהליך בחירת הרשת.

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

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

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

מפעילים את האפשרות Automatic data collection (איסוף נתונים אוטומטי) ומזינים את הערךAPI ID and API KEY שקיבלתם בסעיף הקודם.

אחרי שבוחרים באפשרות Yield partner, בוחרים ב-Mobile SDK Mediation בתור סוג השילוב, ב-Android בתור הפלטפורמה וב-Active בתור Status. מזינים את Media ID and Zone ID התקבל בקטע הקודם. לאחר מכן, מזינים ערך של עלות ברירת מחדל לאלף חשיפות.

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

שלב 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.2.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 ההקשר ששימש לטעינת מודעה לא היה מופע של 'פעילות'.
0-10 maio החזירה שגיאה ספציפית ל-SDK. צפייה הקוד של maio אפשר לקבל פרטים נוספים.
101 עדיין אין מודעה זמינה ב-maio.
102 פרמטרים לא חוקיים של שרת (למשל, חסר מזהה מיקום).
103 המתאם maio לא תומך בפורמט המודעה המבוקש.
104 כבר נטענה מודעה לתצורת הרשת הזו.

יומן שינויים של מתאם תהליך בחירת הרשת (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

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