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

בחירת פלטפורמה: Android iOS Unity Flutter Android (גרסה קודמת)

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

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

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

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

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

דרישות מוקדמות

לפני שממשיכים, צריך לוודא את הפרטים הבאים:

  • הגרסה העדכנית של Google Mobile Ads Unity Plugin.
  • ‫Unity Editor בגרסה 4 ואילך.
  • כדי לפרוס ב-Android
    • ‫Android API ברמה 24 ואילך.
  • כדי לפרוס ב-iOS
    • יעד פריסה 15.0 ומעלה ב-iOS.
  • פרויקט Unity פעיל שמוגדר עם Google Mobile Ads Unity Plugin. פרטים נוספים זמינים במאמר הגדרת Google Mobile Ads Unity Plugin.
  • הגדרת תהליך בחירת הרשת.

    • שלב 1: קובעים את ההגדרות בממשק המשתמש של maio

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

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

    מעברון

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

    Android

    iOS

    ההטבה הופעלה

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

    Android

    iOS

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

    Android

    iOS

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

    Android

    iOS

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

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

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

    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 Package Manager Settings.

    בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמרשם מוגדר עם הפרטים הבאים:

    • שם: OpenUPM
    • כתובת אתר: https://package.openupm.com
    • היקף ההרשאות: com.google

    פרטי OpenUPM

    אחר כך עוברים אל Window (חלון) > Package Manager (מנהל החבילות) כדי לפתוח את Unity Package Manager (מנהל החבילות של Unity) ובוחרים באפשרות My Registries (המרשמים שלי) בתפריט הנפתח.

    מאגרי Unity

    בוחרים את החבילה Google Mobile Ads Maio Mediation ולוחצים על Install.

    התקנה מ-OpenUPM

    חבילת Unity

    מורידים את הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור maio מהקישור להורדה ביומן השינויים, ומחלצים את הקובץ GoogleMobileAdsMaioMediation.unitypackage מקובץ ה-ZIP.

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

    ייבוא מ-Unity

    אחר כך בוחרים באפשרות Assets (נכסים) > External Dependency Manager (מנהל יחסי תלות חיצוניים) > Android Resolver (מזהה Android) > 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 Mobile Ads Unity Plugin יקבלו באופן אוטומטי מודעות לבדיקה מ-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

    גרסה 3.1.11

    גרסה 3.1.10

    גרסה 3.1.9

    גרסה 3.1.8

    גרסה 3.1.7

    גרסה 3.1.6

    גרסה 3.1.5

    גרסה 3.1.4

    גרסה 3.1.3

    גרסה 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

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

    גרסה 1.0.1

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

    גרסה 1.0.0

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