‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

שילוב 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 (אפליקציה חדשה).

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

מעברון

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

Android

iOS

ההטבה הופעלה

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