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

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

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

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

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

שילוב
בידינג
מפל
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה
מותאם

דרישות

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

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

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

כדי להוסיף את האפליקציה למרכז השליטה של i-mobile, לוחצים על הכרטיסייה שפת iDEAL/アプ管理 (ניהול אתר/אפליקציה) ועל הלחצן של הפלטפורמה של האפליקציה.

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

כדי ליצור נקודת פרסום חדשה, בוחרים את האפליקציה בכרטיסייה donーモプ管理 (ניהול אתר/אפליקציה).

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

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

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

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

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

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

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

נותנים שם לקבוצה לבחירת רשת (Mediation) ובוחרים מיקומים גיאוגרפיים לטירגוט. בשלב הבא, מגדירים את הסטטוס של הקבוצה לבחירת רשת למופעלת ולוחצים על הוספת יחידות של מודעות.

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

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

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

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

בוחרים באפשרות i-mobile ומפעילים את המתג Optimize. עליכם להזין את Login name and API Passwordשקיבלתם בסעיף הקודם כדי להגדיר אופטימיזציה של מקורות מודעות עבורi-mobile. לאחר מכן מזינים ערך של עלות בפועל לאלף חשיפות עבורi-mobile ולוחצים על המשך.

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

לאחר מכן, מזינים את 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.5.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.

שדה הנכסים תמיד נכללים במתאם 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 ערכת ה-SDK של i-mobile החזירה שגיאה. פרטים נוספים זמינים במאמר קוד.
101 כדי לטעון מודעות, נדרשת ל-i-mobile הקשר Activity.
102 הפרמטרים של שרת i-mobile שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
103 גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-i-mobile.
104 פונקציית ה-callback של i-mobile להצלחה של טעינת מודעות מותאמות לאתר החזירה רשימה ריקה של מודעות מותאמות לאתר.

יומן שינויים של מתאם תהליך בחירת הרשת (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 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.

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

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

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