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

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

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

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

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

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

דרישות

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

Android

iOS

ההטבה הופעלה

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

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

Android

להוראות, אפשר לעיין בשלב 2 במדריך ל-Android.

iOS

להוראות, אפשר לעיין בשלב 2 במדריך ל-iOS.

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

OpenUPM-CLI

אם OpenUPM-CLI מותקן, אפשר להתקין את הפלאגין של Google Mobile Ads לממשק בחירת הרשת (Mediation) של MAIO ל-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.