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

בחירת פלטפורמה: Android iOS Unity Flutter Android (מדור קודם)

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

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

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

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

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

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

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

• רמת API ב-Android‏ 24 ואילך.

• הגרסה העדכנית של GMA Next-Gen SDK.

• הגדרת תהליך בחירת הרשת (Mediation) ב-AdMob.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בכרטיס Waterfall שבקטע מקורות מודעות, לוחצים על הוספת מקור מודעות.

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

הערה: צריך להגדיר אופטימיזציה של מקורות מודעות רק פעם אחת לכל רשת.

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



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

הערה: תהליך האופטימיזציה של מקורות המודעות נמשך כמה ימים, עד שנאספים מספיק נתונים כדי לחשב במדויק את העלות בפועל לאלף חשיפות (eCPM) ברשת מסוימת בתהליך בחירת הרשת. בינתיים, סטטוס האופטימיזציה של מקור המודעות הוא PENDING, לכן צריך להגדיר ידנית ערך של עלות בפועל לאלף חשיפות לרשת. אחרי שאפשר לחשב את העלות בפועל לאלף חשיפות, מקור המודעות מתחיל לעדכן באופן אוטומטי את העלות בפועל לאלף חשיפות בשבילכם.

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

הערה: אם לא משלבים את הגרסאות התואמות של i-mobile ו-GMA Next-Gen SDK, עלולות להיווצר בעיות ב-build.

שילוב עם Android Studio (מומלץ)

בקובץ settings.gradle.kts ברמת הפרויקט, מוסיפים את המאגרים הבאים:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile.github.io/adnw-sdk-android")
    }
  }
}

בקובץ Gradle ברמת האפליקציה, מוסיפים את יחסי התלות וההגדרות הבאים:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.5")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.5'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

שילוב ידני

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

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

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

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

צריך להעביר את ההקשר של Activity כשמציגים מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.בלי הקשר של פעילות, טעינת המודעה תיכשל.

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

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

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

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

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

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

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

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

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

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

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

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

קודי שגיאה

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

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

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

הגרסה הבאה

• המתאם עודכן כך שישתמש ב-API של InitializationCompleteCallback.onInitializationFailed(AdError).
• רמת ה-API המינימלית הנדרשת ב-Android עודכנה ל-24.
• תוקנה בעיה שבה קריאות חוזרות (callbacks) של טעינה והצגה של מודעות מעברון לא הועברו כי מאזין ריק נרשם ב-i-mobile SDK.

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

גרסה 2.3.2.2

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

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

• גרסה 25.1.0 של Google Mobile Ads SDK.
• גרסת IMobile 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.
• גרסת IMobile 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 v2.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 בגרסה 2.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 גרסה 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.

נבנה ונבדק עם

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

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