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

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

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

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

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

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

דרישות

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

• ה-SDK העדכני של מודעות Google לנייד

• השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

בשלב הבא, ממלאים את הטופס: מזינים את הפרטים הבאים: 広告スポッ באזור (Ad Spot Spot), 広告スポッורגサズ (גודל מיקום המודעה) ופרטים נוספים. לאחר מכן, לוחצים על הלחצן connect規登録 (Sign up) (הרשמה).

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

חשוב לרשום את パリッッャーID (Publisher ID), badgeデアID (Media ID) וスポッקירID (Spot ID). תצטרכו את הפרמטרים האלה מאוחר יותר כשתגדירו את i-mobile לגישור ב Ad Manager ממשק המשתמש.

Android

iOS

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

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

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

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

הערה: אם לא משלבים את הגרסה התואמת של i-mobile ושל Google Mobile Ads SDK, עלולות להיווצר בעיות ב-build.

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

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

pod 'GoogleMobileAdsMediationIMobile'

משורת הפקודה:

pod install --repo-update

שילוב ידני

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

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

שילוב של SKAdNetwork

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

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

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

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

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

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

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

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

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

הצגת מודעות

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

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

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

קודי שגיאה

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

מבנה הקורס	שם הכיתה
כרזה	IMobileAdapter
פרסומת מרווח ביניים	IMobileAdapter
מותאם	GADMediationAdapterIMobile

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

קוד שגיאה	סיבה
0-99	i-mobile SDK החזיר שגיאה. לפרטים נוספים, ראו קוד.
101	i-mobile מחייב הקשר Activity כדי לטעון מודעות.
102	פרמטרים של שרת i-mobile שהוגדרו Ad Manager בממשק המשתמש חסרים/לא חוקיים.
103	גודל המודעה המבוקש אינו תואם גודל מודעת באנר הנתמך על ידי i-mobile.
104	הקריאה החוזרת (callback) שהושלמה בעקבות טעינת המודעות המותאמות של i-mobile החזירה רשימה ריקה של מודעות מותאמות.
0-10	i-mobile SDK החזיר שגיאה. לפרטים נוספים, ראו קוד.
101	פרמטרים של שרת i-mobile שהוגדרו Ad Manager בממשק המשתמש חסרים/לא חוקיים.
102	גודל המודעה המבוקש אינו תואם גודל מודעת באנר הנתמך על ידי i-mobile.
103	i-mobile לא הצליח להציג מודעה.
104	i-mobile החזיר מערך ריק של מודעות מותאמות.
105	i-mobile לא הצליחה להוריד את הנכסים שמצורפים למודעות המותאמות.
106	i-mobile לא תומך בבקשה להצגת מודעות מעברון מרובות באמצעות אותו מזהה Spot.

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

גרסה 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.
• i-mobile SDK גרסה 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.

נוצר ונבדק בעזרת:

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

גרסה 2.3.0.1

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

נוצר ונבדק בעזרת:

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

גרסה 2.3.0.0

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

נוצר ונבדק בעזרת:

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

גרסה 2.2.0.1

• מעכשיו יש צורך בגרסה 9.0.0 ואילך של Google Mobile Ads SDK.

נוצר ונבדק בעזרת:

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

גרסה 2.2.0.0

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

נוצר ונבדק עם

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

גרסה 2.1.0.1

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

נוצר ונבדק עם

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

גרסה 2.1.0.0

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

נוצר ונבדק עם

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

גרסה 2.0.33.1

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

נוצר ונבדק עם

• גרסה 7.68.0 של Google Mobile Ads SDK.
• 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 לפחות.

נוצר ונבדק עם

• גרסה 7.65.0 של Google Mobile Ads SDK.
• 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.

גרסה

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

נוצר ונבדק עם

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

גרסה 2.0.29.0

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

נוצר ונבדק עם

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