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

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

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

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

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

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

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

• רמת API ב-Android‏ 24 ומעלה.

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

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

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

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

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

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

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

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

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

המיקום החדש להצגת מודעות מוכן. כדי לראות את פרטי השילוב, לוחצים על הכפתור アプリ設定取得 (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 > קבוצות תפוקה ולוחצים על הכפתור קבוצת תפוקה חדשה.

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

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

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

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

מפעילים את האפשרות איסוף נתונים אוטומטי ומזינים את שם המשתמש ואת סיסמת ה-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.

‫¹ במודעות מותאמות, i-mobile SDK לא מספק נכס של סמל אפליקציה. במקום זאת, המתאם של 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.
• גרסת IMobile 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 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 v2.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 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.
• גרסה 2.0.22 של IMobile SDK.

גרסה 2.0.22.0

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

פותח ונבדק עם

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

גרסה 2.0.21.0

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

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