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

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

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

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

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

דרישות

• יעד הפריסה של iOS מגרסה 12.0 ואילך

• ה-SDK העדכני של Google Mobile Ads

• השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה

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

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

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

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

שימוש ב-CocoaPods (מומלץ)

מוסיפים את השורה הבאה ל-Podfile של הפרויקט:

pod 'GoogleMobileAdsMediationIMobile'

מריצים את הפקודה הבאה בשורת הפקודה:

pod install --repo-update

שילוב ידני

• מורידים את הגרסה האחרונה של i-mobile SDK ומקשרים את ImobileSdkAds.framework בפרויקט.
• אפשר להוריד את הגרסה האחרונה של המתאם ל-i-mobile דרך הקישור להורדה יומן שינויים וגם מקשר את IMobileAdapter.framework בפרויקט.

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

שילוב של SKAdNetwork

יש לפעול לפי מסמכי התיעוד של i-mobile כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.

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

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

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

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

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

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

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

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

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

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

קודי שגיאה

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

אלו הקודים וההודעות הנלוות שמתאם i-mobile זורק כשמודעה נכשלת להיטען:

יומן שינויים של מתאם תהליך בחירת הרשת (Mediation) ב-i-mobile ב-iOS

גרסה 2.3.4.0

• תאימות מאומתת ל-i-mobile SDK 2.3.4.
• נוספה תמיכה בהחזרת גרסת ה-SDK של i-mobile ב-adSDKVersion.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK גרסה 11.2.0.
• i-mobile SDK גרסה 2.3.4.

גרסה 2.3.3.0

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

פותח ונבדק בעזרת:

• גרסה 11.1.0 של Google Mobile Ads SDK.
• i-mobile SDK גרסה 2.3.3.

גרסה 2.3.2.1

• הוסרה השיטה להענקת גישה willBackgroundApplication שהוצא משימוש מההטמעות של מודעות באנר, מודעות מעברון ומודעות מותאמות.
• נדרשת עכשיו גרסת iOS 12.0 מינימלית.
• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
• Info.plist נכלל במסגרות שב-IMobileAdapter.xcframework.

פותח ונבדק בעזרת:

• גרסה 11.0.1 של Google Mobile Ads SDK.
• SDK של i-mobile גרסה 2.3.2.

גרסה 2.3.2.0

• תאימות מאומתת ל-i-mobile SDK 2.3.2.
• התמיכה בארכיטקטורה של armv7 הוסרה.
• נדרשת עכשיו גרסת iOS 11.0 מינימלית.
• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 10.4.0 ואילך של Google Mobile Ads SDK.

פותח ונבדק בעזרת:

• גרסה 10.4.0 של Google Mobile Ads SDK.
• i-mobile SDK גרסה 2.3.2.

גרסה 2.3.1.0

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

פותח ונבדק בעזרת:

• Google Mobile Ads SDK גרסה 10.3.0.
• i-mobile SDK גרסה 2.3.1.

גרסה 2.3.0.1

• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 10.0.0 ואילך של Google Mobile Ads SDK.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK גרסה 10.0.0.
• i-mobile SDK גרסה 2.3.0.

גרסה 2.3.0.0

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

פותח ונבדק בעזרת:

• Google Mobile Ads SDK גרסה 9.13.0.
• i-mobile SDK גרסה 2.3.0.

גרסה 2.2.0.1

• כדי להשתמש בתכונה הזו, צריך Google Mobile Ads SDK בגרסה 9.0.0 ואילך.

פותח ונבדק בעזרת:

• גרסה 9.0.0 של Google Mobile Ads SDK.
• i-mobile SDK גרסה 2.2.0.

גרסה 2.2.0.0

• תאימות מאומתת ל-i-mobile SDK גרסה 2.2.0.

פותח ונבדק עם

• Google Mobile Ads SDK גרסה 8.13.0.
• i-mobile SDK גרסה 2.2.0.

גרסה 2.1.0.1

• תלות רגועה ב-Google Mobile Ads SDK בגרסה 8.0.0 ואילך.

פיתוח ובדיקה באמצעות

• Google Mobile Ads SDK גרסה 8.4.0.
• i-mobile SDK גרסה 2.1.0.

גרסה 2.1.0.0

• תאימות מאומתת עם i-mobile SDK בגרסה 2.1.0.
• כדי להשתמש בתכונה הזו נדרשת עכשיו Google Mobile Ads SDK גרסה 8.1.0 ואילך.
• עדכנו את המתאם כך שישתמש בפורמט .xcframework.

פותח ונבדק עם

• גרסה 8.1.0 של Google Mobile Ads SDK
• i-mobile SDK גרסה 2.1.0.

גרסה 2.0.33.1

• נוספו הודעות וקודי שגיאה של מתאם סטנדרטי.
• מעכשיו, המתאם מגביל את הבקשות להצגת כמה מודעות מעברון באמצעות אותו מזהה מודעה של i-mobile.
• מעכשיו, ה-Adapter מעביר את הקריאה החוזרת (callback) של -nativeAdWillLeaveApplication: כשמקישים על מודעות מותאמות.
• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.68.0 ואילך של Google Mobile Ads SDK.

פותח ונבדק עם

• Google Mobile Ads SDK גרסה 7.68.0.
• i-mobile SDK גרסה 2.0.33.

גרסה 2.0.33.0

• תאימות מאומתת עם i-mobile SDK בגרסה 2.0.33.
• מעכשיו נדרשת גרסה 7.65.0 ואילך של Google Mobile Ads SDK.
• עכשיו נדרשת גרסת iOS 9.0 מינימלית.

פותח ונבדק עם

• Google Mobile Ads SDK גרסה 7.65.0.
• i-mobile SDK גרסה 2.0.33.

גרסה 2.0.32.0

• תאימות מאומתת ל-i-mobile SDK בגרסה 2.0.32.
• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.60.0 ואילך של Google Mobile Ads SDK.
• נוספה תמיכה בהתאמת מודעות בגדלים 320x50 ו-320x100 כדי להתאים בצורה טובה יותר לגדלים של בקשות למודעות באנר מותאמות.
• התמיכה בארכיטקטורה של i386 הוסרה.

פותח ונבדק עם

• גרסה 7.60.0 של Google Mobile Ads SDK.
• i-mobile SDK גרסה 2.0.32.

גרסה 2.0.31.0

• תאימות מאומתת ל-i-mobile SDK גרסה 2.0.31.

פיתוח ובדיקה באמצעות

• Google Mobile Ads SDK גרסה 7.53.1.
• גרסה 2.0.31 של i-mobile SDK.

גרסה 2.0.29.0

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

פיתוח ובדיקה באמצעות

• Google Mobile Ads SDK גרסה 7.52.0.
• i-mobile SDK גרסה 2.0.29.