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

במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-MAIO באמצעות תהליך בחירת הרשת, כולל שילובים של רשתות ב-Waterfall. נסביר איך להוסיף את maio להגדרה של תהליך בחירת הרשת (Mediation) של יחידת מודעות, ואיך לשלב את ה-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. פרטים נוספים זמינים במאמר תחילת העבודה.
  • השלמת התהליך של תהליך בחירת הרשת המדריך לתחילת העבודה

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

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

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

מעברון

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

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 ואת API KEY כדי להגדיר את המזהה של יחידת המודעות לתהליך בחירת הרשת. בדף Reporting API, רושמים בצד את API ID ואת API KEY.

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

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

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

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות נכסים > מנהל יחסי תלות חיצוני > Android היעדים > אילוץ פתרון. הספרייה של 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 Mediation

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

גרסה 1.0.2

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

גרסה 1.0.1

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