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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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



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

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

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

הערה: אם לא תשלבו את הגרסאות התואמות של i-mobile ו-Google Mobile Ads SDK (Legacy) יכולות להיות בעיות בבנייה.

שילוב עם 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.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.5")
}

Groovy

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 adapter artifacts במאגר 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
קריאה לפעולה
דירוג כוכבים
חנות
מחיר

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

יומן השינויים של מתאם תהליך בחירת הרשת 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.
• גרסת 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 v2.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.
• גרסה 2.3.1 של iMobile SDK.

גרסה 2.3.1.1

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

נבנה ונבדק באמצעות:

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

גרסה 2.3.1.0

• תאימות מאומתת לגרסה i-mobile SDK v2.3.1.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.5.0.

נבנה ונבדק באמצעות:

• גרסה 21.5.0 של Google Mobile Ads SDK.
• גרסה 2.3.1 של iMobile SDK.

גרסה 2.3.0.0

• תאימות מאומתת ל-i-mobile SDK גרסה 2.3.0.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.3.0.

נבנה ונבדק באמצעות:

• גרסה 21.3.0 של Google Mobile Ads SDK.
• גרסה 2.3.0 של IMobile SDK.

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

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

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