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

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

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

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

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

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

דרישות

  • הגרסה העדכנית של Google Mobile Ads SDK
  • ‫Flutter 3.7.0 ומעלה
  • כדי לפרוס ב-Android
    • רמת API ‏23 ואילך ב-Android
  • כדי לפרוס ב-iOS
    • יעד הפריסה של iOS הוא 12.0 ומעלה
  • פרויקט Flutter פעיל שהוגדר עם 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: ייבוא של maio SDK ומתאם

שילוב דרך pub.dev

מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK והמתאם של maio בקובץ pubspec.yaml של החבילה:

dependencies:
  gma_mediation_maio: ^

שילוב ידני

מורידים את הגרסה העדכנית של הפלאגין של Google Mobile Ads Mediation ל-maio, מחלצים את הקובץ שהורד ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את התלות הבאה לקובץ pubspec.yaml כדי להפנות אל הפלאגין:

dependencies:
  gma_mediation_maio:
    path: path/to/local/package

שלב 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 כבר נטענה מודעה להגדרת הרשת הזו.

יומן השינויים של מתאם ה-Mediation של maio Flutter

גרסה 1.0.3

גרסה 1.0.2

גרסה 1.0.1

גרסה 1.0.0