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

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

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

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

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

שילוב
בידינג
מפל
פורמטים
כרזה
פרסומת מרווח ביניים
ההטבה הופעלה
מותאם

דרישות

• Android API ברמת 19 ואילך

• ה-SDK העדכני של מודעות Google לנייד

• השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה

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

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

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

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

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

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

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

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

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

חשוב לרשום את パリッッャー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

הערה: אם לא משלבים את הגרסה התואמת של i-mobile ושל Google Mobile Ads SDK, עלולות להיווצר בעיות ב-build.

שילוב עם 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.0.0")
    implementation("com.google.ads.mediation:imobile:2.3.1.1")
}

שילוב ידני

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

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

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

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

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

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

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

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

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

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

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

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

הצגת מודעות

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

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

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

קודי שגיאה

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

מבנה הקורס	שם הכיתה
כרזה	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.

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

הגרסה הבאה

• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.4.0.

גרסה 2.3.1.1

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

נוצר ונבדק בעזרת:

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

גרסה

• תאימות מאומתת עם 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.

גרסה

• תאימות מאומתת עם 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.

גרסה

• תאימות מאומתת עם 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.

גרסה

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

נוצר ונבדק עם

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

גרסה

• תאימות מאומתת עם 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.

גרסה

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