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

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

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

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

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

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

דרישות

  • Unity 4 ואילך
  • הגרסה העדכנית ביותר של Google Mobile Ads SDK
  • לפריסה ב-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 בתור סוג המודעה ולוחצים על עדכון.

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

הגדרת הגדרות בחירת הרשת ליחידת המודעות

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 לבחירת רשת (Mediation) עבור maiO מהקישור להורדה שמופיע בChangelog ומחלצים את הקובץ GoogleMobileAdsMaioMediation.unitypackage מקובץ ה-zip.

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

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות נכסים > מנהל יחסי התלות החיצוניים > 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.
  • תמיכה במתאם iOS של maio בגרסה 1.4.6.0.

גרסה 1.2.2

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

גרסה 1.2.1

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

גרסה 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.
  • תמיכה במתאם iOS של maio בגרסה 1.3.0.0.

גרסה 1.0.2

  • תמיכה ב-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.