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

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

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

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

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

דרישות

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

• הגרסה העדכנית של 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 לגישור בממשק המשתמש של 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. לאחר מכן, עוברים לכרטיסייה גישור. אם יש לכם קבוצה קיימת לבחירת רשת שאתם רוצים לשנות, לוחצים על השם של הקבוצה כדי לערוך אותה וממשיכים אל הוספת i-mobile כמקור מודעות.

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

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

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

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

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

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

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

שימוש ב-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: בדיקת ההטמעה

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

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

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

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

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

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

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

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

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

קודי שגיאה

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

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

יומן השינויים של מתאם i-mobile ל-iOS

הגרסה הבאה

• מפעילים את האפשרויות ‎-fobjc-arc ו-‎-fstack-protector-all.

גרסה 2.3.4.2

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

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

• גרסה 12.0.0 של Google Mobile Ads SDK.
• גרסה 2.3.4 של i-mobile SDK.

גרסה 2.3.4.1

• התפקיד של CFBundleShortVersionString עודכן כך שיש בו שלושה רכיבים במקום ארבעה.

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

• גרסה 11.10.0 של Google Mobile Ads SDK.
• גרסה 2.3.4 של i-mobile SDK.

גרסה 2.3.4.0

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

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

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

גרסה 2.3.3.0

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

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

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

גרסה 2.3.2.1

• הוסר delegate method שהוצא משימוש (deprecated) מההטמעות של מודעות באנר, מודעות ביניים ומודעות מותאמות.willBackgroundApplication
• נדרשת עכשיו גרסת iOS מינימלית של 12.0.
• מעכשיו נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
• הכללה של Info.plist במסגרות בתוך IMobileAdapter.xcframework.

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

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

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

גרסה 2.3.1.0

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

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

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

גרסה 2.3.0.1

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

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

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

גרסה 2.3.0.0

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

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

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

גרסה 2.2.0.1

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

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

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

גרסה 2.2.0.0

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

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

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

גרסה 2.1.0.1

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

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

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

גרסה 2.1.0.0

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

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

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

גרסה 2.0.33.1

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

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

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

גרסה 2.0.33.0

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

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

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

גרסה 2.0.32.0

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

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

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

גרסה 2.0.31.0

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

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

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

גרסה 2.0.29.0

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

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

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