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

בחירת פלטפורמה: Android iOS Unity Flutter Android (Legacy)

במדריך הזה מוסבר איך להשתמש ב-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

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

new_ad_spot_form

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

ad_spot_list

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

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

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

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

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

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

  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 modulemap.

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

  • גרסה 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.
  • נוספה תמיכה להחזרת גרסת ה-SDK של i-mobile ב-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.
  • גרסה 2.2.0 של i-mobile SDK.

גרסה 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

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

פותח ונבדק עם

  • גרסה 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

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