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

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

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

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

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

דרישות

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

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

• קוראים את המדריך לתחילת העבודה בנושא גישור.

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

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

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

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

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

עוברים לכרטיסייה 広告スポット管理 (Ad Spot Management) ולוחצים על הלחצן 新規広告スポット (New Ad Spot).

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

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

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

עוברים אל הצגה > קבוצות אופטימיזציה ולוחצים על הלחצן קבוצת אופטימיזציה חדשה.

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

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

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

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

מפעילים את האפשרות איסוף נתונים אוטומטי ומזינים את שם הכניסה וסיסמת ה-API.

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

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

שלב 3: ייבוא של i-mobile SDK ו-Adapter

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

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

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

לאחר מכן, בקובץ build.gradle.kts ברמת האפליקציה, מוסיפים את התלות וההגדרות הבאות של ההטמעה. משתמשים בגרסאות העדכניות של i-mobile SDK והמתאם:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

שילוב ידני

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

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

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

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

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

שלב 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 Mediation Adapter

גרסה 2.3.2.1

• עדכנו את רמת ה-API המינימלית הנדרשת ב-Android ל-23.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-24.0.0.

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

• גרסה 24.0.0 של Google Mobile Ads SDK.
• גרסה 2.3.2 של iMobile SDK.

גרסה 2.3.2.0

• תאימות מאומתת ל-i-mobile SDK v2.3.2.

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

• גרסה 23.1.0 של Google Mobile Ads SDK.
• גרסה 2.3.2 של iMobile SDK.

גרסה 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 v2.3.0.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.3.0.

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

• גרסה 21.3.0 של Google Mobile Ads SDK.
• גרסת SDK של iMobile‏ 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.
• גרסה 2.0.23 של iMobile SDK.

גרסה 2.0.23.0

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

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

• גרסה 20.5.0 של Google Mobile Ads SDK.
• גרסה 2.0.23 של iMobile SDK.

גרסה 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.
• גרסה 2.0.21 של iMobile SDK.

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

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