במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-i-mobile באמצעות תהליך בחירת הרשת, כולל שילובים של רשימת הרשתות. במאמר מוסבר איך להוסיף את i-mobile להגדרות בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של i-mobile באפליקציה של Unity.
בממשק של לוח הבקרה של i-mobile, התוויות, הלחצנים והתיאורים מופיעים בטקסט יפני. צילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות במדריך הזה, תוויות ולחצנים מתורגמים עם המקבילות שלהם באנגלית בסוגריים.
השילובים והפורמטים של המודעות הנתמכים
למתאם בחירת הרשת של AdMob ל-i-mobile יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
מודעת באנר | |
מעברון | |
ההטבה הופעלה |
דרישות
- Unity מגרסה 5.6 ואילך
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- כדי לפרוס ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדרה בו Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של i-mobile
נרשמים או נכנסים לחשבון i-mobile.
כדי להוסיף את האפליקציה למרכז הבקרה של i-mobile, לוחצים על הכרטיסייה サイト/アプリ管理 (ניהול אתר/אפליקציה) ואז על הלחצן של הפלטפורמה של האפליקציה.
ממלאים את הטופס ולוחצים על הלחצן 新規登録 (Sign up).
כדי ליצור מיקום מודעה חדש, בוחרים את האפליקציה בכרטיסייה אתר/ניהול אפליקציות.
עוברים לכרטיסייה 広告スポット管理 (ניהול מיקומי מודעות) ולוחצים על הלחצן 新規広告スポット (מיקום מודעה חדש).
לאחר מכן, ממלאים את הטופס ומציינים את הפרטים הבאים: 広告スポット名 (Ad Spot name), 広告スポットサイズ (Ad Spot size) ופרטים נוספים. לאחר מכן, לוחצים על הלחצן 新規登録 (Sign up).
המיקום החדש למודעה מוכן. כדי להציג את פרטי השילוב, לוחצים על הלחצן アプリ設定取得 (קבלת הגדרות האפליקציה).
שימו לב לPublisher ID (מזהה בעל התוכן הדיגיטלי), ל-Media ID (מזהה המדיה) ול-Spot ID (מזהה הסרטון). תצטרכו את הפרמטרים האלה מאוחר יותר כשתקבעו את i-mobile לצורכי תהליך בחירת הרשת בממשק המשתמש של AdMob.
שלב 2: מגדירים את הביקוש מ-i-mobile בממשק המשתמש של AdMob
הגדרת הגדרות בחירת הרשת ליחידת המודעות
להוראות, אפשר לעיין בשלב 2 במדריך ל-Android.
להוראות, אפשר לעיין בשלב 2 במדריך ל-iOS.
שלב 3: מייבאים את ה-SDK ואת המתאם של i-mobile
אם התקנתם את OpenUPM-CLI, תוכלו להתקין את הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ל-Unity בפרויקט שלכם. לשם כך, מריצים את הפקודה הבאה מהספרייה ברמה הבסיסית (root) של הפרויקט:
openupm add com.google.ads.mobile.mediation.imobile
בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את הגדרות מנהל החבילות של Unity.
בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר שמוגדר לפי היקף עם הפרטים הבאים:
- שם:
OpenUPM
- כתובת אתר:
https://package.openupm.com
- היקפים:
com.google
לאחר מכן, עוברים אל Window > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries בתפריט הנפתח.
בוחרים בחבילה Google Mobile Ads i-mobile Mediation ולוחצים על Install.
מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ל-i-mobile מקישור ההורדה שמופיע בChangelog ומחלצים את הקובץ GoogleMobileAdsIMobileMediation.unitypackage
מקובץ ה-zip.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > Import Package > Custom Package ומאתרים את הקובץ GoogleMobileAdsIMobileMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.
לאחר מכן בוחרים באפשרות נכסים > מנהל יחסי תלות חיצוניים > Android Resolver > Force Resolve. ספריית External Dependency Manager תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות שהוצהרו לתיקייה Assets/Plugins/Android
באפליקציה שלכם ב-Unity.
שלב 4: נדרש קוד נוסף
אין צורך בקוד נוסף לשילוב עם i-mobile.
שילוב עם SKAdNetwork
פועלים לפי המסמכים של i-mobile כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בדיקה מעשית של ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-AdMob. חברת i-mobile מספקת מזהה מודעה, מזהה מדיה ומזהה בעל אפליקציה לצורך בדיקה. אפשר למצוא אותם כאן.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-i-mobile, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות i-mobile (Waterfall).
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-i-mobile, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות ResponseInfo
בקטגוריות הבאות:
פורמט | שם הכיתה |
---|---|
מודעת באנר | com.google.ads.mediation.imobile.IMobileAdapter |
מעברון | com.google.ads.mediation.imobile.IMobileAdapter |
מותאם | com.google.ads.mediation.imobile.IMobileMediationAdapter |
פורמט | שם הכיתה |
---|---|
מודעת באנר | IMobileAdapter |
מעברון | IMobileAdapter |
מותאם | GADMediationAdapterIMobile |
אלה הקודים וההודעות הנלוות שמתקבלים מהמתאם i-mobile כשלא ניתן לטעון מודעה:
קוד שגיאה | סיבה |
---|---|
0-99 | ערכת ה-SDK של i-mobile החזירה שגיאה. פרטים נוספים זמינים במאמר קוד. |
101 | כדי לטעון מודעות, ל-i-mobile נדרש הֶקשר Activity . |
102 | פרמטרים של שרת i-mobile שהוגדרו בממשק המשתמש של AdMob חסרים או לא חוקיים. |
103 | גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-i-mobile. |
104 | פונקציית ה-callback של i-mobile להצלחה של טעינת מודעות מותאמות לאתר החזירה רשימה ריקה של מודעות מותאמות לאתר. |
קוד שגיאה | סיבה |
---|---|
0-10 | ערכת ה-SDK של i-mobile החזירה שגיאה. פרטים נוספים זמינים במאמר קוד. |
101 | פרמטרים של שרת i-mobile שהוגדרו בממשק המשתמש של AdMob חסרים או לא חוקיים. |
102 | גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-i-mobile. |
103 | המערכת של i-mobile לא הצליחה להציג מודעה. |
104 | i-mobile החזיר מערך ריק של מודעות מותאמות. |
105 | מערכת i-mobile לא הצליחה להוריד נכסי מודעות מותאמות. |
106 | מערכת i-mobile לא תומכת בשליחת בקשות להצגת מודעות מעברון מרובות באמצעות אותו מזהה מודעה. |
יומן השינויים של פלאגין תהליך בחירת הרשת של i-mobile Unity
גרסה 1.3.6
- תמיכה במתאם Android של i-mobile מגרסה 2.3.2.0.
- תמיכה במתאם i-mobile ל-iOS בגרסה 2.3.4.1.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.3.0.
גרסה 1.3.5
- תמיכה במתאם Android של i-mobile מגרסה 2.3.2.0.
- תמיכה במתאם i-mobile ל-iOS בגרסה 2.3.4.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.
גרסה 1.3.4
- תמיכה במתאם i-mobile ל-Android בגרסה 2.3.1.2.
- תמיכה במתאם i-mobile ל-iOS בגרסה 2.3.4.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.0.0.
גרסה 1.3.3
- תמיכה במתאם i-mobile ל-Android בגרסה 2.3.1.1.
- תמיכה במתאם i-mobile ל-iOS בגרסה 2.3.3.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.0.0.
גרסה 1.3.2
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/IMobile/
. - תמיכה במתאם i-mobile ל-Android בגרסה 2.3.1.1.
- תמיכה במתאם i-mobile ל-iOS בגרסה 2.3.2.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.1.0.
גרסה 1.3.1
- תמיכה במתאם Android של i-mobile מגרסה 2.3.0.0.
- תמיכה במתאם i-mobile ל-iOS בגרסה 2.3.0.1.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.4.1.
גרסה 1.3.0
- תמיכה במתאם Android של i-mobile מגרסה 2.3.0.0.
- תמיכה במתאם i-mobile ל-iOS בגרסה 2.3.0.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.3.1.
גרסה 1.2.2
- תמיכה במתאם Android של i-mobile בגרסה 2.0.23.1.
- תמיכה במתאם i-mobile ל-iOS בגרסה 2.2.0.1.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.0.2.
גרסה 1.2.1
- תמיכה במתאם Android של i-mobile בגרסה 2.0.23.0.
- תמיכה במתאם i-mobile ל-iOS בגרסה 2.2.0.1.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.0.0.
גרסה 1.2.0
גרסה 1.1.0
גרסה 1.0.2
גרסה 1.0.1
גרסה 1.0.0
- הגרסה הראשונה!
- תמיכה במתאם i-mobile ל-Android בגרסה 2.0.20.1.
- תמיכה במתאם i-mobile ל-iOS בגרסה 2.0.29.0.