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

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

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

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

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

שילוב
בידינג
מפל
פורמטים
כרזה
דפי ביניים
ההטבה הופעלה

דרישות

  • Unity 4 ומעלה
  • ה-SDK העדכני של Google Mobile Ads
  • לפריסה ב-Android
    • Android API ברמה 21 ואילך
  • לפריסה ב-iOS
    • יעד הפריסה של iOS מגרסה 12.0 ואילך
  • פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
  • השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה

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

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

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

פרסומת מרווח ביניים

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

Android

iOS

ההטבה הופעלה

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

Android

iOS

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

Android

iOS

בדף Zone Management מציינים את Zone ID. בקטע הבא תצטרכו גם להגדיר את Ad Manager יחידת המודעות.

Android

iOS

(Waterfall בלבד) בנוסף למזהה מדיה ולמזהה אזור, צריך מזהה API ומפתח API כדי להגדיר מזהה יחידת מודעות לתהליך בחירת הרשת. שימו לב למזהה API ול-API KEY בדף Reporting API.

שלב 2: הגדרת ביקוש ב-maio Ad Manager בממשק המשתמש

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

שלב 3: מייבאים את ה-SDK והמתאם של maio

OpenUPM-CLI

אם יש לכם את OpenUPM-CLI תוכל להתקין את Google Mobile Ads הפלאגין של תהליך בחירת הרשת (Mediation) ל-Unity לפרויקט שלך, על ידי הרצת הפקודה הבאה מספריית השורש של הפרויקט:

openupm add com.google.ads.mobile.mediation.maio

OpenUPM

בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > הגדרות פרויקט > Package Manager כדי לפתוח את הגדרות של מנהל החבילות של Unity.

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

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

פרטי OpenUPM

לאחר מכן עוברים אל חלון > Package Manager כדי לפתוח את Unity Package Manager וגם בוחרים באפשרות My Registries (הרישומים שלי) בתפריט הנפתח.

רשימות של Unity

בוחרים את החבילה Google Mobile Ads maio Mediation ואז לוחצים על התקנה.

התקנה מ-OpenUPM

חבילת Unity

כדאי להוריד את הגרסה האחרונה של הפלאגין לבחירת רשת (Mediation) של Google Ads לנייד עבור maio מקישור ההורדה ב- ה יומן שינויים ומחלצים את הקטע GoogleMobileAdsMaioMediation.unitypackage מהמיקוד חדש.

בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets (נכסים) > ייבוא חבילה > Custom Package (חבילה מותאמת אישית) ומוצאים את GoogleMobileAdsMaioMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

ייבוא מ-Unity

בשלב הבא בוחרים באפשרות נכסים > פותר הבעיות של Play Services > Android resolve > סגירה ידנית. המקודד של Unity Play Services תבצע רזולוציית תלות מאפס ותעתיק את יחסי תלות מוצהרים בספרייה Assets/Plugins/Android של אפליקציית Unity.

אילוץ החלטה

שלב 4: מוסיפים את הקוד הנדרש

Android

לא נדרש קוד נוסף לשילוב עם maio.

iOS

שילוב של SKAdNetwork

פועלים לפי מסמכי התיעוד של Maio. כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.

שלב 5: בודקים את ההטמעה

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

חשוב לרשום את מכשיר הבדיקה ל- Ad Manager

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

iOS

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

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

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

גרסה 1.2.2

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

גרסה 1.2.1

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

גרסה 1.2.0

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

גרסה 1.1.3

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

גרסה 1.1.2

  • תומך במתאם ל-Android של maio בגרסה 1.1.3.0.
  • יש תמיכה בגרסה 1.3.2.0 של מתאם iOS ל-maio.

גרסה 1.1.1

  • תומך במתאם ל-Android של maio בגרסה 1.1.1.0.
  • יש תמיכה בגרסה 1.3.1.1 של מתאם iOS ל-maio.

גרסה 1.1.0

  • תומך במתאם ל-Android של maio בגרסה 1.1.0.0.
  • יש תמיכה בגרסה 1.3.0.0 של מתאם iOS ל-maio.

גרסה 1.0.2

  • תמיכה ב-maio Android SDK בגרסה 1.0.8.
  • תמיכה ב-maio iOS SDK בגרסה 1.2.19.

גרסה 1.0.1

  • תמיכה ב-maio Android SDK בגרסה 1.0.7.
  • תמיכה ב-maio iOS SDK בגרסה 1.2.19.

גרסה 1.0.0

  • גרסה ראשונה!
  • תמיכה ב-maio Android SDK בגרסה 1.0.6.
  • תמיכה ב-maio iOS SDK בגרסה 1.2.18.