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

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

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

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

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

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

דרישות

  • הפלאגין האחרון של Google Mobile Ads Unity
  • Unity מגרסה 4 ואילך
  • כדי לפרוס ב-Android
    • רמת API ‏23 ומעלה ב-Android
  • כדי לפרוס ב-iOS
    • יעד פריסה 12.0 ומעלה ב-iOS
  • פרויקט Unity פעיל שמוגדר עם Google Mobile Ads Unity Plugin. פרטים נוספים מופיעים במאמר בנושא תחילת העבודה.
  • ביצוע של תהליך בחירת הרשת מדריך לתחילת העבודה

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

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

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

מעברון

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

Android

iOS

ההטבה הופעלה

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

Android

iOS

בדף Application Management (ניהול אפליקציות), רושמים את מזהה המדיה. הוא נדרש כדי להגדיר את יחידת המודעות ב-Ad Manager בקטע הבא.

Android

iOS

בדף Zone Management (ניהול אזורים), רושמים את מזהה האזור. תצטרכו אותו גם כדי להגדיר את יחידת המודעות ב-Ad Manager בקטע הבא.

Android

iOS

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

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

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

Android

הוראות מפורטות זמינות בשלב 2 במדריך ל-Android.

iOS

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

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, אתם יכולים להתקין את התוסף Google Mobile Ads maio Mediation Plugin for 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 (מנהל החבילות של Unity) ובוחרים באפשרות My Registries (המאגרים שלי) בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads Maio Mediation ולוחצים על Install (התקנה).

התקנה מ-OpenUPM

חבילת Unity

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

לא נדרש קוד נוסף לשילוב של maio.

iOS

שילוב של SKAdNetwork

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

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

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

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

בעלי אפליקציות שמשתמשים בגרסה 7.26.0 או בגרסה מתקדמת יותר של הפלאגין למודעות לנייד של Google ל-Unity יקבלו באופן אוטומטי מודעות לבדיקה מ-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 ההקשר ששימש לטעינת המודעה לא היה מופע של Activity.

iOS

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

יומן השינויים של הפלאגין של maio Unity Mediation

גרסה 3.1.2

גרסה 3.1.1

גרסה 3.1.0

גרסה 3.0.2

גרסה 3.0.1

גרסה 3.0.0

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

גרסה 1.2.2

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

גרסה 1.2.1

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

גרסה 1.2.0

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

גרסה 1.1.3

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

גרסה 1.1.2

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

גרסה 1.1.1

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

גרסה 1.1.0

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

גרסה 1.0.2

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

גרסה 1.0.1

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

גרסה 1.0.0

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