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

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

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

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

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

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

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

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

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

  • הגרסה העדכנית של Google Mobile Ads Unity Plugin.
  • ‫Unity Editor בגרסה 4 ואילך.
  • כדי לפרוס ב-Android
    • רמת API ב-Android‏ 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 (ניהול אזורים), רושמים את מזהה האזור. הוא גם נדרש כדי להגדיר את יחידת המודעות ב-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.

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

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

    פרטי OpenUPM

    אחר כך עוברים אל Window (חלון) > 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

    אחר כך, בוחרים באפשרות נכסים > מנהל תלות חיצוני > 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 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 Mediation

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

    Version 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

    • עדכנו את הפלאגין כדי לתמוך ב-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

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