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

בחירת פלטפורמה: Android iOS Unity Flutter Android (גרסה קודמת)

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-i-mobile באמצעות תהליך בחירת הרשת (Mediation), כולל שילובים של שיטת ה-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) בממשק המשתמש של Ad Manager.

עדכון של הקובץ app-ads.txt

‫ Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, צרו קובץ app-ads.txt ל-Ad Manager.

כדי להטמיע את app-ads.txt ב-i-mobile, אפשר לעיין בשאלות הנפוצות שלהם.

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

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

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

עוברים אל Delivery > Yield groups ולוחצים על הכפתור New yield group.

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

אחר כך לוחצים על הלחצן הוספת שותף תפוקה.

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

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

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

אחרי שבוחרים את השותף של קבוצת התפוקה, בוחרים באפשרות Mobile SDK Mediation בתור סוג השילוב, באפשרות iOS בתור פלטפורמה ובאפשרות פעיל בתור סטטוס. מזינים את מזהה בעל האפליקציה, מזהה המדיה ומזהה המיקום שקיבלתם בקטע הקודם. אחר כך מזינים ערך בשדה עלות ברירת מחדל לאלף חשיפות.

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

שלב 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.

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

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

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

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

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

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

המתאם של i-mobile מאכלס את השדות הבאים של 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 שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים.
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

  • סינון בקשות עם הגבלת גיל ל-i-mobile SDK כש-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

  • תאימות מאומתת עם גרסה 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.
  • גרסת i-mobile SDK‏ 2.0.29.