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

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

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

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

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

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

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

• ‫Android API ברמה 24 ואילך.

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

• הגדרת תהליך בחירת הרשת.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

עוברים אל Delivery > Yield groups ולוחצים על הכפתור New yield group.

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

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

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

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

מפעילים את האפשרות איסוף נתונים אוטומטי ומזינים את שם המשתמש ואת סיסמת ה-API.

אחרי שבוחרים את השותף של קבוצת התפוקה, בוחרים באפשרות Mobile SDK Mediation בתור סוג השילוב, באפשרות Android בתור פלטפורמה ובאפשרות פעיל בתור סטטוס. מזינים את מזהה בעל האפליקציה, מזהה המדיה ומזהה המיקום שקיבלתם בקטע הקודם. אחר כך מזינים ערך בשדה עלות ברירת מחדל לאלף חשיפות.

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

שלב 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: בודקים את ההטמעה

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

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

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

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

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

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

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

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

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

קודי שגיאה

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

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

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

גרסה 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.
• גרסת i-mobile 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.
• גרסת i-mobile 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.
• גרסת i-mobile SDK‏ 2.3.2.

גרסה 2.3.2.2

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

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

• גרסה 25.1.0 של Google Mobile Ads SDK.
• גרסת i-mobile 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.
• גרסת i-mobile SDK‏ 2.3.2.

גרסה 2.3.2.0

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

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

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

גרסה 2.3.1.2

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

נבנה ונבדק עם

• גרסה 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.
• גרסת i-mobile SDK‏ 2.0.20.

גרסה 2.0.20.0

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