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

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

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

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

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

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

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

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

• הגרסה העדכנית של Google Mobile Ads SDK (Legacy).

• הגדרת תהליך בחירת הרשת (Mediation) ב-AdMob.

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

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

מוסיפים את האפליקציה למרכז הבקרה של i-mobile בלחיצה על הכרטיסייה サイト／アプリ管理 (ניהול אתר/אפליקציה) ועל הלחצן של הפלטפורמה של האפליקציה.

ממלאים את הטופס ולוחצים על הכפתור 新規登録 (הרשמה).

כדי ליצור מיקום חדש למודעות, בוחרים את האפליקציה בכרטיסייה サイト／アプリ管理 (ניהול אתרים/אפליקציות).

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

‫אחר כך ממלאים את הטופס ומציינים את 広告スポット名 (שם מיקום המודעה), 広告スポットサイズ (גודל מיקום המודעה) ופרטים נוספים. אחר כך לוחצים על הכפתור 新規登録 (הרשמה).

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

שימו לב לערכים של パブリッシャーID (מזהה בעל האפליקציה), メディアID (מזהה המדיה) ו-スポットID (מזהה המיקום). תצטרכו את הפרמטרים האלה בהמשך, כשתגדירו את i-mobile לתהליך בחירת הרשת (Mediation) בממשק המשתמש של AdMob.

עדכון של הקובץ app-ads.txt

‫ Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.

כדי להטמיע את app-ads.txt ב-i-mobile, אפשר לעיין בשאלות הנפוצות שלהם.

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

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

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

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

כדי ליצור קבוצה חדשה לבחירת רשת, לוחצים על יצירת קבוצה לבחירת רשת (Mediation).

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

נותנים שם לקבוצה לבחירת רשת ובוחרים את המיקומים לטירגוט. לאחר מכן, מגדירים את הסטטוס של קבוצת ה-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")
    }
  }
}

בקובץ Gradle ברמת האפליקציה, מוסיפים את יחסי התלות הבאים להטמעה:

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

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.5'
}

שילוב ידני

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

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

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

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

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

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

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

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

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

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

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

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

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

המתאם של i-mobile מאכלס את השדות הבאים של מודעות מותאמות מסוג Advanced ב-NativeAd.

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

קודי שגיאה

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

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

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

הגרסה הבאה

• המתאם עודכן כך שישתמש ב-API של InitializationCompleteCallback.onInitializationFailed(AdError).
• רמת ה-API המינימלית הנדרשת ב-Android עודכנה ל-24.
• תוקנה בעיה שבה קריאות חוזרות (callbacks) של טעינה והצגה של מודעות מעברון לא הועברו כי מאזין ריק נרשם ב-i-mobile SDK.

גרסה 2.3.2.5

• מצמידים את התלות של המתאם ב-Kotlin לגרסה 1.9.0 (גרסת Kotlin המינימלית שנתמכת על ידי GMA NextGen SDK).
• תוקנה התנהגות ברירת המחדל של הסתעפויות כשל שמוגבלות לפי גיל במהלך בקשות לאתחול מודעות ולטעינת מודעות.

נבנה ונבדק עם:

• גרסה 25.4.0 של Google Mobile Ads SDK.
• גרסה 1.4.0 של Google Mobile Ads Next-Gen SDK.
• גרסת IMobile SDK‏ 2.3.2.

גרסה 2.3.2.4

• סינון בקשות עם הגבלת גיל ל-i-mobile SDK כש-AgeRestrictedTreatment החדש מוגדר כ-CHILD.

נבנה ונבדק עם:

• גרסה 25.4.0 של Google Mobile Ads SDK.
• גרסה 1.2.0 של Google Mobile Ads Next-Gen SDK.
• גרסת IMobile SDK‏ 2.3.2.

גרסה 2.3.2.3

• מסננים בקשות עם הגבלת גיל ל-i-mobile SDK כי הוא לא יכול לקבל אותות עם הגבלת גיל.

נבנה ונבדק עם:

• גרסה 25.1.0 של Google Mobile Ads SDK.
• גרסה 1.1.0 של Google Mobile Ads Next-Gen SDK.
• גרסת IMobile SDK‏ 2.3.2.

גרסה 2.3.2.2

• נוסף מאפיין ליצירת המתאם עם תלות ב-GMA Next-Gen SDK.
• העברנו את ההטמעות של מודעות באנר, מודעות מעברון ומודעות מותאמות מה-API הישן ל-API החדש.

נבנה ונבדק עם:

• גרסה 25.1.0 של Google Mobile Ads SDK.
• גרסת IMobile SDK‏ 2.3.2.

גרסה 2.3.2.1

• רמת ה-API המינימלית הנדרשת ב-Android עודכנה ל-23.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-24.0.0.

נבנה ונבדק עם:

• גרסה 24.0.0 של Google Mobile Ads SDK.
• גרסת IMobile SDK‏ 2.3.2.

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

נבנה ונבדק עם:

• גרסה 23.0.0 של Google Mobile Ads SDK.
• גרסת IMobile SDK‏ 2.3.1.

גרסה 2.3.1.1

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

נבנה ונבדק עם:

• גרסה 22.0.0 של Google Mobile Ads SDK.
• גרסת IMobile SDK‏ 2.3.1.

‫גרסה 2.3.1.0

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

נבנה ונבדק עם:

• גרסה 21.5.0 של Google Mobile Ads SDK.
• גרסת IMobile SDK‏ 2.3.1.

גרסה 2.3.0.0

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

נבנה ונבדק עם:

• גרסה 21.3.0 של Google Mobile Ads SDK.
• גרסת i-mobile SDK‏ 2.3.0.

גרסה 2.0.23.1

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

נבנה ונבדק עם:

• גרסה 21.0.0 של Google Mobile Ads SDK.
• גרסת IMobile SDK‏ 2.0.23.

גרסה 2.0.23.0

• תאימות מאומתת עם i-mobile SDK גרסה 2.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.

נבנה ונבדק עם

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

נבנה ונבדק עם

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

נבנה ונבדק עם

• גרסה 18.3.0 של Google Mobile Ads SDK.
• גרסת IMobile SDK‏ 2.0.20.

גרסה 2.0.20.1

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

נבנה ונבדק עם

• גרסה 18.2.0 של Google Mobile Ads SDK.
• גרסת IMobile SDK‏ 2.0.20.

גרסה 2.0.20.0

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