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

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

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

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

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

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

דרישות

  • הגרסה האחרונה של הפלאגין למודעות לנייד של Google ל-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: ייבוא ה-SDK והמתאם של maio

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.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.