שילוב של MAio עם גישור

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

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

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

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

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

דרישות

• Android API ברמת 19 ואילך

• maio SDK 1.0.7 ואילך

• ה-SDK העדכני של מודעות Google לנייד

• השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה

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

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

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

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

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

הערה: כברירת מחדל, ניתן לדלג על מודעות מעברון של maio.

ההטבה הופעלה

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

הערה: כברירת מחדל, לא ניתן לדלג על מודעות וידאו מתגמלות של maio.

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

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

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

הערה: אם זו הפעם הראשונה שאתם מגדירים חשבון maio, יכול להיות שתצטרכו לפנות לצוות התמיכה של maio כדי שיונפקו לכם מזהה API ומפתח 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 התקבל בקטע הקודם. לאחר מכן, מזינים ערך של עלות ברירת מחדל לאלף חשיפות.

חשוב: Media ID צריך להיות משויך לאפליקציה המטורגטת, כמו maio בממשק המשתמש.

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

הערה: איסוף הנתונים באופן אוטומטי נמשך כמה ימים לפני שהוא יכול לחשב במדויק את הערך של העלות הדינמית לאלף חשיפות ברשת שבה נערך תהליך בחירת הרשת. אחרי שאפשר יהיה לחשב את העלות בפועל לאלף חשיפות, היא תתעדכן באופן אוטומטי.

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

הערה: אם לא משלבים את הגרסה התואמת של maio ואת הגרסה של Google Mobile Ads SDK, עלולות להיווצר בעיות ב-build.

שילוב עם 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:23.0.0")
    implementation("com.google.ads.mediation:maio:1.1.16.2")
}

שילוב ידני

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

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

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

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

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

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

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

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

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

הגרסה הבאה

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

גרסה 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 נוספות.
• התאימות מאומתת ל-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.
• Maio SDK גרסה 1.1.15.

גרסה 1.1.14.0

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

נוצר ונבדק בעזרת:

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

גרסה 1.1.13.0

• תאימות מאומתת עם maio SDK גרסה 1.1.13.
• הגרסה המינימלית הנדרשת של 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

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

נוצר ונבדק בעזרת:

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

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

• המתאם עודכן ועכשיו הוא תומך ב-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

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

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

• תוקנה בעיה שגרמה ל-NullPointerDisabled כשמודעות נכשלות בטעינה.

גרסה 1.0.7.0

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

גרסה 1.0.6.0

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