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

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

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

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

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

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

דרישות

• Android API ברמה 21 ואילך

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

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

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

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

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

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

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

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

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

לאחר מכן, ממלאים את הטופס ומציינים את הפרטים הבאים: 広告スポット名 (Ad Spot name),‏ 広告スポットサイズ (Ad Spot size) ופרטים נוספים. לאחר מכן, לוחצים על הלחצן 新規登録 (Sign up).

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

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

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

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

נכנסים לחשבון Ad Manager.

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

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

לאחר מכן, לוחצים על הלחצן Add yield partner (הוספת שותף להגדלת התשואה).

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

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

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

אחרי שבוחרים את שותף ה-Yield, בוחרים באפשרות Mobile SDK Mediation בתור סוג השילוב, בוחרים באפשרות Android בתור פלטפורמה ובוחרים באפשרות Active בתור סטטוס. מזינים את מזהה בעל התוכן הדיגיטלי, את מזהה המדיה ואת מזהה הקליפ שהתקבלו בקטע הקודם. לאחר מכן, מזינים ערך Default CPM.

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

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

שלב 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.6.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

שילוב ידני

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 מספקת מזהה מודעה, מזהה מדיה ומזהה בעל אפליקציה לצורך בדיקה. אפשר למצוא אותם כאן.

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

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

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

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

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

עיבוד מודעות

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

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

¹ במודעות מותאמות, ערכת ה-SDK של i-mobile לא מספקת נכס של סמל אפליקציה. במקום זאת, מתאם 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	כדי לטעון מודעות, נדרש הֶקשר Activity ב-i-mobile.
102	הפרמטרים של שרת i-mobile שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים.
103	גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-i-mobile.
104	פונקציית ה-callback של i-mobile להצלחה של טעינת מודעות מותאמות לאתר החזירה רשימה ריקה של מודעות מותאמות לאתר.

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

גרסה 2.3.2.0

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

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

• Google Mobile Ads SDK בגרסה 23.1.0.
• IMobile SDK גרסה 2.3.2.

גרסה 2.3.1.2

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

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

• Google Mobile Ads SDK בגרסה 23.0.0.
• IMobile SDK בגרסה 2.3.1.

גרסה 2.3.1.1

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

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

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

גרסה 2.3.1.0

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

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

• Google Mobile Ads SDK בגרסה 21.5.0.
• IMobile SDK בגרסה 2.3.1.

גרסה 2.3.0.0

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

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

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

גרסה 2.0.23.1

• עודכנו compileSdkVersion ו-targetSdkVersion ל-API 31.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 21.0.0.
• עדכנו את רמת ה-API המינימלית הנדרשת ל-Android ל-19.

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

• Google Mobile Ads SDK בגרסה 21.0.0.
• IMobile SDK גרסה 2.0.23.

גרסה 2.0.23.0

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

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

• Google Mobile Ads SDK בגרסה 20.5.0.
• IMobile SDK גרסה 2.0.23.

גרסה 2.0.22.2

• נוספו קודים והודעות סטנדרטיים של שגיאות במתאם.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-20.1.0.

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

• Google Mobile Ads SDK בגרסה 20.1.0.
• IMobile SDK גרסה 2.0.22.

גרסה 2.0.22.1

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

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

• Google Mobile Ads SDK בגרסה 20.0.0.
• IMobile SDK גרסה 2.0.22.

גרסה 2.0.22.0

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

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

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

גרסה 2.0.21.0

• תאימות מאומתת עם i-mobile SDK v2.0.21.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-19.1.0.
• הוספנו תמיכה בשינוי הגודל של מודעות באנר מותאמות.

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

• Google Mobile Ads SDK בגרסה 19.1.0.
• IMobile SDK מגרסה 2.0.21.

גרסה 2.0.20.2

• הוספנו תמיכה בגדלים גמישים של מודעות באנר.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-18.3.0.

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

• Google Mobile Ads SDK בגרסה 18.3.0.
• IMobile SDK מגרסה 2.0.20.

גרסה 2.0.20.1

• המתאם מחזיר עכשיו יחס גובה-רוחב של mediaContent שאינו אפס.

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

• Google Mobile Ads SDK בגרסה 18.2.0.
• IMobile SDK מגרסה 2.0.20.

גרסה 2.0.20.0

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