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

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

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

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

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

שילוב
בידינג
מפל
פורמטים
כרזה
מעברון
ההטבה הופעלה

דרישות

  • Unity 5.6 ומעלה
  • ה-SDK העדכני של Google Mobile Ads
  • לפריסה ב-Android
    • Android API ברמה 21 ואילך
  • לפריסה ב-iOS
    • יעד הפריסה של iOS מגרסה 12.0 ואילך
  • פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
  • השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה

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

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

חשוב לרשום את パリッッャーID (Publisher ID), badgeデアID (Media ID) וスポッקירID (Spot ID). תצטרכו את הפרמטרים האלה מאוחר יותר כשתגדירו את i-mobile לגישור ב Ad Manager ממשק המשתמש.

Android

iOS

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

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

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

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

OpenUPM-CLI

אם יש לכם את OpenUPM-CLI תוכל להתקין את Google Mobile Ads i-mobile הפלאגין של תהליך בחירת הרשת (Mediation) ל-Unity לפרויקט שלך, על ידי הרצת הפקודה הבאה מספריית השורש של הפרויקט:

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > הגדרות פרויקט > Package Manager כדי לפתוח את הגדרות של מנהל החבילות של Unity.

בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמרשם היקף עם את הפרטים הבאים:

  • שם: OpenUPM
  • כתובת אתר: https://package.openupm.com
  • היקפים: com.google

פרטי OpenUPM

לאחר מכן עוברים אל חלון > Package Manager כדי לפתוח את Unity Package Manager וגם בוחרים באפשרות My Registries (הרישומים שלי) בתפריט הנפתח.

רשימות של Unity

בוחרים בחבילה תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads ב-i-mobile ואז לוחצים על התקנה.

התקנה מ-OpenUPM

חבילת Unity

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

בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets (נכסים) > ייבוא חבילה > Custom Package (חבילה מותאמת אישית) ומוצאים את GoogleMobileAdsIMobileMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

ייבוא מ-Unity

בשלב הבא בוחרים באפשרות נכסים > פותר הבעיות של Play Services > Android resolve > סגירה ידנית. המקודד של Unity Play Services תבצע רזולוציית תלות מאפס ותעתיק את יחסי תלות מוצהרים בספרייה Assets/Plugins/Android של אפליקציית Unity.

אילוץ החלטה

שלב 4: נדרש קוד נוסף

Android

לא נדרש קוד נוסף בשילוב של i-mobile.

iOS

שילוב של SKAdNetwork

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

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

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

חשוב לרשום את מכשיר הבדיקה ל- Ad Manager ב-i-mobile יש את מזהה ה-Spot, Media ID ו-Publisher ID שמיועדים לבדיקות. אפשר למצוא אותם כאן.

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

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

קודי שגיאה

אם המתאם לא מקבל מודעה מ-i-mobile, בעלי התוכן הדיגיטלי יכולים לבדוק שגיאה בסיסית מהתגובה של המודעה באמצעות ResponseInfo בסיווגים הבאים:

Android

פורמט שם הכיתה
כרזה com.google.ads.mediation.imobile.IMobileAdapter
מעברון com.google.ads.mediation.imobile.IMobileAdapter
מותאם com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

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

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

Android

קוד שגיאה סיבה
0-99 אירעה שגיאה ב-i-mobile SDK. להצגת הקוד אפשר לקבל פרטים נוספים.
101 ל-i-mobile נדרש הקשר Activity כדי לטעון מודעות.
102 הפרמטרים של שרת i-mobile שהוגדרו ב Ad Manager ממשק המשתמש חסרים/לא חוקיים.
103 גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך ב-i-mobile.
104 הקריאה החוזרת (callback) של טעינת המודעות המותאמות ב-i-mobile החזירה רשימה ריקה של מודעות מותאמות.

iOS

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

יומן שינויים בפלאגין של i-mobile Unity Mediation

גרסה 1.3.5

גרסה 1.3.4

גרסה 1.3.3

גרסה 1.3.2

גרסה 1.3.1

גרסה 1.3.0

גרסה 1.2.2

גרסה 1.2.1

גרסה 1.2.0

גרסה 1.1.0

גרסה 1.0.2

גרסה 1.0.1

גרסה 1.0.0