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

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

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

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

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

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

דרישות מוקדמות

לפני שממשיכים, צריך לוודא את הפרטים הבאים:

  • יעד פריסה 13.0 ומעלה ב-iOS.

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

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

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

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

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

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

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

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

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

נותנים שם לקבוצה לבחירת רשת ובוחרים את המיקומים לטירגוט. אחר כך מגדירים את הסטטוס של קבוצת בחירת הרשת (Mediation) כמופעל ולוחצים על הוספת יחידות מודעות.

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

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

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


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

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




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



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

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

מומלץ: להשתמש ב-Swift Package Manager

לפני שממשיכים, צריך לוודא שגרסת המתאם היא לפחות 2.3.4.2.

כדי להוסיף תלות בחבילה לפרויקט:

  1. ב-Xcode, עוברים אל File > Add Package Dependencies...‎ (קובץ > הוספת יחסי תלות בין חבילות).

  2. בהנחיה שמופיעה, מחפשים את כתובת ה-URL הבאה של החבילה:

    https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git
    
  3. בקטע Dependency Rule, בוחרים באפשרות Branch.

  4. בשדה הטקסט, מזינים main.

שילוב ידני

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

שימוש ב-CocoaPods

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

    pod 'GoogleMobileAdsMediationIMobile'
    
  • מריצים את הפקודה הבאה משורת הפקודה:

    pod install --repo-update

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

הטמעה של SKAdNetwork

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

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

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

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

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

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

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

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

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

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

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

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

קודי שגיאה

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

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

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

קוד שגיאה סיבה
0-10 ‫i-mobile SDK החזיר שגיאה. פרטים נוספים זמינים בקוד.
101 פרמטרים של שרת i-mobile שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
102 גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-i-mobile.
103 ‫i-mobile לא הצליחה להציג מודעה.
104 ‫i-mobile החזיר מערך ריק של מודעות מותאמות.
105 ‫i-mobile לא הצליחה להוריד נכסים שמצורפים למודעות מותאמות.
106 ב-i-mobile אין תמיכה בבקשות לכמה מודעות מעברון באמצעות אותו מזהה מיקום.
107 מסננים בקשות עם הגבלת גיל ל-i-mobile SDK כי הוא לא יכול לקבל אותות עם הגבלת גיל.

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

גרסה 2.3.4.8

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

נבנה ונבדק עם:

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

גרסה 2.3.4.7

  • סינון בקשות עם הגבלת גיל ל-SDK של i-mobile כש-ageRestrictedTreatment החדש מוגדר ל-GADAgeRestrictedTreatmentChild.

נבנה ונבדק עם:

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

גרסה 2.3.4.6

  • מסננים בקשות עם הגבלת גיל ל-i-mobile SDK כי הוא לא יכול לקבל אותות עם הגבלת גיל.

נבנה ונבדק עם:

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

גרסה 2.3.4.5

  • עודכנה התלות ב-Google Mobile Ads SDK לגרסה 13.0.0.

נבנה ונבדק עם:

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

גרסה 2.3.4.4

  • גרסת iOS המינימלית של CocoaPods עודכנה ל-13.0.

נבנה ונבדק עם:

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

גרסה 2.3.4.3

  • תוקנו שמות הכותרות של המסגרת והמטרייה במפת המודולים של IMobileAdapter.

נבנה ונבדק עם:

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

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

‫גרסה 2.3.2.1

  • הסרנו את שיטת ה-delegate‏ 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.
  • גרסת i-mobile SDK‏ 2.2.0.

גרסה 2.2.0.0

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

נבנה ונבדק עם

  • גרסה 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.
  • גרסה 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.
  • המתאם מעביר עכשיו את הקריאה החוזרת (callback) של -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

  • תאימות מאומתת עם i-mobile SDK בגרסה 2.0.32.
  • עכשיו נדרשת גרסה 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

  • תאימות מאומתת עם 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.