שילוב של 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 ואילך

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

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

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

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

כדי ליצור אתר פרסום חדש, בוחרים את האפליקציה בכרטיסייה サPLATFORM/アプリ管理 (Site/Application Management).

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

create_ad_spot

בשלב הבא, ממלאים את הטופס: מזינים את הפרטים הבאים: 広告スポッ באזור (Ad Spot Spot), 広告スポッורגサズ (גודל מיקום המודעה) ופרטים נוספים. לאחר מכן, לוחצים על הלחצן connect規登録 (Sign up) (הרשמה).

new_ad_spot_form

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

ad_spot_list

חשוב לרשום את パリッッャーID (Publisher ID), badgeデアID (Media ID) וスポッקירID (Spot ID). תצטרכו את הפרמטרים האלה מאוחר יותר כשתגדירו את i-mobile לגישור ב Ad Manager ממשק המשתמש.

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

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

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

עבור אל הצגה > קבוצות תפוקה ולחץ על הלחצן קבוצת תפוקה חדשה.

מזינים שם ייחודי לקבוצת התפוקה, מגדירים את הסטטוס ל-Active, בוחרים את פורמט המודעה ומגדירים את סוג המלאי לאפליקציה לנייד. בקטע Targeting > Inventory (טירגוט > מלאי) בוחרים את יחידת המודעות בקטע Inventory (מלאי) וMobile application שרוצים להוסיף להם את תהליך בחירת הרשת.

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

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

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

מפעילים את האפשרות Automatic data collection (איסוף נתונים אוטומטי) ומזינים את הערךLogin name and API Password

אחרי שבוחרים באפשרות Yield partner, בוחרים ב-Mobile SDK Mediation בתור סוג השילוב, ב-Android בתור הפלטפורמה וב-Active בתור Status. מזינים את Publisher ID, Media ID and Spot ID התקבל בקטע הקודם. לאחר מכן, מזינים ערך של עלות ברירת מחדל לאלף חשיפות.

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

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

בקובץ 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.2.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. בוחרים בגרסה האחרונה ומורידים את i-mobile את הקובץ .aar של המתאם, ומוסיפים אותו לפרויקט.

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

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

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

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

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

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

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

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

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

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

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

שדה הנכסים תמיד נכללים במתאם i-mobile
כותרת
תמונה
גוף
סמל האפליקציה 1
קריאה לפעולה
Star rating
חנות
מחיר

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

קודי שגיאה

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

פורמט שם הכיתה
כרזה com.google.ads.mediation.imobile.IMobileAdapter
מעברון com.google.ads.mediation.imobile.IMobileAdapter
מותאם com.google.ads.mediation.imobile.IMobileMediationAdapter

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

קוד שגיאה סיבה
0-99 אירעה שגיאה ב-i-mobile SDK. להצגת הקוד אפשר לקבל פרטים נוספים.
101 ל-i-mobile נדרש הקשר Activity כדי לטעון מודעות.
102 הפרמטרים של שרת i-mobile שהוגדרו ב Ad Manager ממשק המשתמש חסרים/לא חוקיים.
103 גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך ב-i-mobile.
104 הקריאה החוזרת (callback) של טעינת המודעות המותאמות ב-i-mobile החזירה רשימה ריקה של מודעות מותאמות.
0-10 אירעה שגיאה ב-i-mobile SDK. להצגת הקוד אפשר לקבל פרטים נוספים.
101 הפרמטרים של שרת i-mobile שהוגדרו ב Ad Manager ממשק המשתמש חסרים/לא חוקיים.
102 גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך ב-i-mobile.
103 לא הצלחנו להציג מודעה ב-i-mobile.
104 i-mobile החזיר מערך ריק של מודעות מותאמות.
105 הורדת הנכסים של המודעות המותאמות ב-i-mobile נכשלה.
106 ב-i-mobile אין תמיכה בשליחת בקשה למספר מודעות מעברון באמצעות אותו מזהה Spot.

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

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

גרסה

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

פותח ונבדק עם

  • 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

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