שילוב של i-mobile עם תהליך בחירת הרשת (Mediation)

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

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

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

המתאם לתהליך בחירת הרשת (Mediation) ל-i-mobile כולל את היכולות הבאות:

דרישות

• Android API ברמה 21 ואילך

• ה-SDK העדכני של Google Mobile Ads

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

שלב 1: הגדרת ההגדרות בממשק המשתמש של i-mobile

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

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

שילוב עם Android Studio (מומלץ)

בקובץ settings.gradle.kts ברמת הפרויקט, מוסיפים את הפרטים הבאים מאגרים:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile.github.io/adnw-sdk-android")
    }
  }
}

לאחר מכן, מוסיפים את יחסי התלות וההגדרות הבאים להטמעה בקובץ build.gradle.kts ברמת האפליקציה. להשתמש בגרסאות האחרונות של מתאם ו-SDK של i-mobile:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

שילוב ידני

1. מורידים את הגרסה האחרונה של i-mobile SDK, מחלצים את הקובץ android-ad-sdk.aar בתיקייה sdk ומוסיפים אותו לפרויקט.

2. עוברים אל פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) של מתאם i-mobile. במאגר Maven של Google. בוחרים את הגרסה האחרונה, מורידים את הקובץ .aar של מתאם i-mobile ומוסיפים אותו לפרויקט.

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

לא נדרש קוד נוסף לשילוב של i-mobile.

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

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

חשוב לרשום את מכשיר הבדיקה ל- Ad Manager ב-i-mobile יש את מזהה ה-Spot, Media ID ו-Publisher ID שמיועדים לבדיקות. אפשר למצוא אותם כאן.

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

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

שלבים אופציונליים

שימוש במודעות מותאמות

רינדור המודעות

המתאם של i-mobile מאכלס את הפריטים הבאים שדות עבור NativeAd.

¹ במודעות מותאמות, ערכת ה-SDK של i-mobile לא מספקת נכס של סמל אפליקציה. במקום זאת, מתאם i-mobile מאכלס תמונה שקופה בסמל האפליקציה.

קודי שגיאה

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

אלו הקודים וההודעות הנלוות שמתאם i-mobile זורק כשמודעה נכשלת להיטען:

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

גרסה 2.3.2.0

• תאימות מאומתת ל-i-mobile SDK גרסה 2.3.2.

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

• גרסה 23.1.0 של Google Mobile Ads SDK
• IMobile SDK גרסה 2.3.2.

גרסה 2.3.1.2

• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 23.0.0.
• תאימות מאומתת ל-i-mobile SDK גרסה 2.3.1.

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

• Google Mobile Ads SDK גרסה 23.0.0.
• IMobile SDK גרסה 2.3.1.

גרסה 2.3.1.1

• המתאם עודכן כדי להשתמש במחלקה החדשה VersionInfo.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 22.0.0.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK גרסה 22.0.0.
• IMobile SDK גרסה 2.3.1.

גרסה 2.3.1.0

• תאימות מאומתת ל-i-mobile SDK גרסה 2.3.1.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 21.5.0.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK גרסה 21.5.0.
• IMobile SDK גרסה 2.3.1.

גרסה 2.3.0.0

• תאימות מאומתת עם i-mobile SDK v2.3.0.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.3.0.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK בגרסה 21.3.0.
• IMobile SDK גרסה 2.3.0.

גרסה 2.0.23.1

• compileSdkVersion ו-targetSdkVersion עודכנו ל-API 31.
• עדכנת את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-21.0.0.
• רמת ה-API המינימלית הנדרשת ב-Android עודכנה ל-19.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK גרסה 21.0.0.
• IMobile SDK גרסה 2.0.23.

גרסה 2.0.23.0

• תאימות מאומתת עם i-mobile SDK v2.0.23.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 20.5.0.

פותח ונבדק עם

• גרסה 20.5.0 של Google Mobile Ads SDK.
• IMobile SDK גרסה 2.0.23.

גרסה 2.0.22.2

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

פותח ונבדק עם

• Google Mobile Ads SDK בגרסה 20.1.0.
• IMobile SDK גרסה 2.0.22.

גרסה 2.0.22.1

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

פותח ונבדק עם

• גרסה 20.0.0 של Google Mobile Ads SDK.
• IMobile SDK גרסה 2.0.22.

גרסה 2.0.22.0

• תאימות מאומתת ל-i-mobile SDK גרסה 2.0.22.
• עדכנו את המתאם כך שיתמוך בבקשות להצגת מודעות באנר מותאמות בתוך תוכן.

פותח ונבדק עם

• Google Mobile Ads SDK בגרסה 19.1.0.
• IMobile SDK גרסה 2.0.22.

גרסה 2.0.21.0

• תאימות מאומתת ל-i-mobile SDK גרסה 2.0.21.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.1.0.
• נוספה תמיכה בהתאמה לעומס של מודעות באנר מותאמות.

פותח ונבדק עם

• גרסה 19.1.0 של Google Mobile Ads SDK
• IMobile SDK גרסה 2.0.21.

גרסה 2.0.20.2

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

פותח ונבדק עם

• Google Mobile Ads SDK גרסה 18.3.0.
• IMobile SDK גרסה 2.0.20.

גרסה 2.0.20.1

• המתאם מחזיר עכשיו יחס גובה-רוחב של mediaContent שאינו אפס.

פותח ונבדק עם

• Google Mobile Ads SDK גרסה 18.2.0.
• IMobile SDK גרסה 2.0.20.

גרסה 2.0.20.0

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