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

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

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

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

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

דרישות

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

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

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

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

נרשמים או נכנסים לחשבון i-mobile.

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

ממלאים את הטופס ולוחצים על הלחצן 新規登録 (Sign up).

כדי ליצור מיקום פרסום חדש, בוחרים את האפליקציה בכרטיסייה אתר/ניהול אפליקציות.

עוברים לכרטיסייה 広告スポット管理 (ניהול מיקומי מודעות) ולוחצים על הלחצן 新規広告スポット (מיקום מודעה חדש).

לאחר מכן, ממלאים את הטופס ומציינים את הפרטים הבאים: 広告スポット名 (Ad Spot name),‏ 広告スポットサイズ (Ad Spot size) ופרטים נוספים. לאחר מכן, לוחצים על הלחצן 新規登録 (Sign up).

המקום להצגת מודעה החדש מוכן. כדי להציג את פרטי השילוב, לוחצים על הלחצן アプリ設定取得 (קבלת הגדרות האפליקציה).

שימו לב למזהה בעל התוכן הדיגיטלי (Publisher ID), למזהה המדיה (Media ID) ולמזהה המודעות (Spot ID). תצטרכו את הפרמטרים האלה בהמשך, כשתקבעו את i-mobile לצורכי תהליך בחירת הרשת בממשק המשתמש של AdMob.

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

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

צריך להוסיף את i-mobile להגדרות בחירת הרשת של יחידת המודעות.

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

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

מזינים את פורמט המודעה ואת הפלטפורמה ולוחצים על המשך.

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

משייכים את הקבוצה לבחירת רשת (Mediation) הזו לאחת או יותר מיחידות המודעות הקיימות ב-AdMob. לאחר מכן לוחצים על סיום.

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

הוספה של i-mobile כמקור מודעות

שלב 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.6.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

שילוב ידני

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

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

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

אין צורך בקוד נוסף לשילוב עם i-mobile.

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

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

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

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

כדי לוודא שאתם מקבלים מודעות בדיקה מ-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 v2.3.2.

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

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

גרסה 2.3.1.2

• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-23.0.0.
• תאימות מאומתת עם i-mobile SDK v2.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 v2.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.

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

• Google Mobile Ads SDK בגרסה 20.5.0.
• 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.

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

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

גרסה 2.0.22.0

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

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

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

גרסה 2.0.21.0

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

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

• Google Mobile Ads SDK בגרסה 19.1.0.
• 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

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