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

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

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

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

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

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

דרישות

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

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

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

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

מעברון

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

Android

iOS

ההטבה הופעלה

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

Android

iOS

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

Android

iOS

בדף Zone Management (ניהול אזורים), רושמים את מזהה האזור. תצטרכו אותו גם כדי להגדיר את יחידת המודעות שלכם ב-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, אתם יכולים להתקין את התוסף maio Mediation Plugin for Unity של Google Mobile Ads בפרויקט שלכם על ידי הפעלת הפקודה הבאה מספריית הבסיס של הפרויקט:

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 mediation ל-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: בדיקה מעשית של ההטמעה

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

חשוב לרשום את מכשיר הבדיקה ב-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 ההקשר ששימש לטעינת המודעה לא היה מופע של Activity.

iOS

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

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

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

גרסה 1.2.2

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

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