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

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

בחירת פלטפורמה: Android iOS Unity Flutter Android (Legacy)

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

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

מעברון

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

Android

iOS

ההטבה הופעלה

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

iOS

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