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

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

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

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

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

שילוב
בידינג
Waterfall
פורמטים
מודעות בפתיחת האפליקציה
מודעת באנר
מעברון
מודעה מתגמלת
מודעות מעברון מתגמלות
מותאם

דרישות מוקדמות

לפני שממשיכים, צריך לוודא את הפרטים הבאים:

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

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

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

מעברון

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

Android

iOS

ההטבה הופעלה

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

שלב 2: מגדירים את הביקוש של maio בממשק המשתמש של AdMob

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

Android

הוראות מפורטות זמינות בשלב 2 במדריך ל-Android.

iOS

הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

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

בתיקיית השורש של הפרויקט, מתקינים את המתאם של Google Mobile Ads SDK for React Native לתהליך בחירת הרשת (Mediation) ב-maio. צריך לבצע את השלבים הבאים:

  1. מעתיקים את קובץ ה-tar של המתאם Google Mobile Ads SDK for React Native מהספרייה gma-sdk-react-native/adapters/maio/ לספרייה local_packages/ של הפרויקט. אם התיקייה adapters לא קיימת, עיינו בקטע דרישות מוקדמות.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/maio/gma-mediation-maio-0.1.0.tgz local_packages/

    מחליפים את EXTRACT_DIR בנתיב לספרייה שבה חילצתם את קובץ הארכיון.

  2. מתקינים את חבילת המתאם באמצעות הכלי המועדף לניהול חבילות:

    npm

    npm install ./local_packages/gma-mediation-maio-0.1.0.tgz

    חוטי סריגה

    yarn add ./local_packages/gma-mediation-maio-0.1.0.tgz

  3. אם אתם מפתחים ל-Android, הוסיפו את המאגר הבא לקובץ build.gradle בספרייה android של הפרויקט:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://imobile-maio.github.io/maven")
    }
}

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

Android

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

iOS

שילוב של SKAdNetwork

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

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

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

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

בעלי אפליקציות שמשתמשים בגרסה 7.26.0 ואילך של Google Mobile Ads SDK for React Native יקבלו באופן אוטומטי מודעות לבדיקה מ-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 כבר נטענה מודעה להגדרת הרשת הזו.

גרסה 0.1.0

  • הגרסה הראשונה.