שילוב maio עם תהליך בחירת הרשת (Mediation)

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

בממשק של מרכז הבקרה של maio נעשה שימוש בטקסט ביפנית בתווית, בלחצנים ובתיאורים, והצילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות שכאן, התוויות והלחצנים מוזכרים באנגלית מקבילה לתוויות וללחצנים. לדוגמה, 'URL 六價ーム' הוא 'סכימה של כתובות URL', וכן הלאה.

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

למתאם בחירת הרשת של maio יש את היכולות הבאות:

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

דרישות

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

שלב 1: הגדרת ההגדרות בממשק המשתמש של MAIO

קודם כול, נרשמים או מתחברים לחשבון maio. לוחצים על הלחצן Application management (ניהול אפליקציות) בסרגל הצד הימני ואז על New app (אפליקציה חדשה).

בוחרים את הכרטיסייה שתואמת לסוג המודעה המועדף.

מעברון

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

Android

iOS

ההטבה הופעלה

מזינים את השם של האפליקציה, בוחרים את הפלטפורמה ומספקים את כתובת ה-URL של האפליקציה. בוחרים באפשרות Video Rewards בתור סוג המודעה ולוחצים על Update.

Android

iOS

בדף Application Management, מציינים את Media ID. הוא נדרש להגדרת יחידת המודעות ב-AdMob בקטע הבא.

Android

iOS

בדף Zone Management, מציינים את Zone ID. הוא יידרש גם כדי להגדיר את יחידת המודעות של AdMob בקטע הבא.

Android

iOS

(Waterfall בלבד) בנוסף ל-Media ID ול-Zone ID, תצטרכו API ID ו-API KEY כדי להגדיר את מזהה יחידת המודעות לתהליך בחירת הרשת. בדף Reporting API, רושמים בצד את API ID ואת API KEY.

שלב 2: הגדרת ביקוש של Maio בממשק המשתמש של AdMob

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

Android

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

iOS

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

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

OpenUPM-CLI

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

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

OpenUPM

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

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

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

פרטי OpenUPM

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

Unity Registries

בוחרים את החבילה Google Mobile Ads maio Mediation ולוחצים על Install.

התקנה מ-OpenUPM

חבילת Unity

מורידים את הגרסה העדכנית של הפלאגין לבחירת רשת של Google Mobile Ads עבור maio מהקישור להורדה ב-Changelog ומחלצים את GoogleMobileAdsMaioMediation.unitypackage מקובץ ה-zip.

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

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות Assets‏ > External Dependency Manager‏ > Android Resolver‏ > Force Resolve. הספרייה של External Dependency Manager תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות המוצגים לתיקייה Assets/Plugins/Android באפליקציה שלכם ב-Unity.

אילוץ החלטה

שלב 4: מוסיפים את הקוד הנדרש

Android

לא נדרש קוד נוסף לשילוב עם MAI.

iOS

שילוב עם SKAdNetwork

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

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

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

חשוב לרשום את מכשיר הבדיקה ב-AdMob.

בעלי אפליקציות שמשתמשים בגרסה 7.26.0 ואילך של Google Mobile Ads SDK יקבלו באופן אוטומטי מודעות לבדיקה מ-maiO בטלפונים ובטאבלטים שרשומים בתור מכשירים לבדיקה כשהם שולחים בקשות.

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

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

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-MAIO, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות ResponseInfo בקטגוריות הבאות:

Android

פורמט שם הכיתה
מעברון jp.maio.sdk.android.mediation.admob.adapter.Interstitial
ההטבה הופעלה jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

פורמט שם הכיתה
מעברון GADMMaioInterstitialAdapter
ההטבה הופעלה GADMMaioRewardedAdapter

אלו הקודים וההודעות הנלוות שמתאם maio זורק כשטעינה של מודעה נכשלת:

Android

קוד שגיאה סיבה
0-10 ה-maiO החזיר שגיאה ספציפית ל-SDK. אפשר לקרוא פרטים נוספים בקוד ובמסמכי התיעוד של maio.
101 אין ל-Maio מודעה זמינה.
102 פרמטרים לא חוקיים של שרת (למשל, חסר מזהה מיקום מודעה).
103 ההקשר ששימש לטעינת מודעה לא היה מופע של 'פעילות'.

iOS

קוד שגיאה סיבה
0-10 maio החזירה שגיאה ספציפית ל-SDK. לפרטים נוספים, אפשר לעיין בקוד של maio.
101 עדיין אין מודעה זמינה ב-maiO.
102 פרמטרים לא חוקיים של שרת (למשל, חסר מזהה מיקום מודעה).
103 מתאם MAIO לא תומך בפורמט המודעה המבוקש.
104 כבר נטענה מודעה בהגדרת הרשת הזו.

יומן השינויים של הפלאגין של maio לבחירת רשת ב-Unity

גרסה 2.0.4

גרסה 2.0.3

גרסה 2.0.2

גרסה 2.0.1

גרסה 2.0.0

גרסה 1.4.3

גרסה 1.4.2

גרסה 1.4.1

גרסה 1.4.0

גרסה 1.3.6

גרסה 1.3.5

גרסה 1.3.4

גרסה 1.3.3

גרסה 1.3.2

גרסה 1.3.1

גרסה 1.3.0

גרסה 1.2.3

  • עדכנו את הפלאגין כך שיתמוך ב-Rewarded API החדש.
  • תמיכה במתאם Android של maio בגרסה 1.1.7.0.
  • יש תמיכה בגרסה 1.4.6.0 של מתאם iOS ל-maio.

גרסה 1.2.2

  • תמיכה במתאם Android של maio בגרסה 1.1.6.0.
  • תמיכה במתאם iOS של maio בגרסה 1.4.2.0.

גרסה 1.2.1

  • תומך במתאם ל-Android של maio בגרסה 1.1.6.0.
  • יש תמיכה בגרסה 1.4.1.0 של מתאם iOS ל-maio.

גרסה 1.2.0

  • תמיכה במתאם Android של maio בגרסה 1.1.4.1.
  • תמיכה במתאם iOS של maio בגרסה 1.4.0.0.

גרסה 1.1.3

  • התמיכה מתבצעת במתאם Android של maio בגרסה 1.1.3.1.
  • תמיכה במתאם iOS של maio בגרסה 1.3.2.0.

גרסה 1.1.2

  • תמיכה במתאם Android של maio בגרסה 1.1.3.0.
  • תמיכה במתאם iOS של maio בגרסה 1.3.2.0.

גרסה 1.1.1

  • תמיכה במתאם Android של maio מגרסה 1.1.1.0.
  • תמיכה במתאם iOS של maio בגרסה 1.3.1.1.

גרסה 1.1.0

  • תומך במתאם ל-Android של maio בגרסה 1.1.0.0.
  • יש תמיכה בגרסה 1.3.0.0 של מתאם iOS ל-maio.

גרסה 1.0.2

  • תמיכה ב-maio Android SDK בגרסה 1.0.8.
  • יש תמיכה ב-maiO iOS SDK מגרסה 1.2.19.

גרסה 1.0.1

  • תמיכה ב-Android SDK מגרסה 1.0.7.
  • יש תמיכה ב-maiO iOS SDK מגרסה 1.2.19.

גרסה 1.0.0

  • גרסה ראשונה!
  • תמיכה ב-Android SDK מגרסה 1.0.6 ואילך.
  • יש תמיכה ב-maiO iOS SDK מגרסה 1.2.18.