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

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

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

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

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

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

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

דרישות

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

• הגרסה העדכנית של Google Mobile Ads SDK

• ביצוע של תהליך בחירת הרשת מדריך לתחילת העבודה

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

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

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

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

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

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

עוברים לכרטיסייה 広告スポット管理 (Ad Spot Management) ולוחצים על הלחצן 新規広告スポット (New Ad Spot).

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

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

חשוב לרשום את パブリッシャー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 בתור רשת המודעות, מזינים שם ייחודי ומפעילים גישור.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

קודי שגיאה

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

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

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

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

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

גרסה 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.
• נוספה תמיכה בהחזרת גרסת 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 שהוצא משימוש 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

• התלות בגרסה 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

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