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

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

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

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

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

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

דרישות

  • יעד פריסה 12.0 ומעלה ב-iOS

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

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

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

מעברון

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

ההטבה הופעלה

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

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

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

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

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

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

נכנסים לחשבון Ad Manager.

עוברים אל Delivery > Yield groups ולוחצים על הכפתור New yield group.

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

לאחר מכן לוחצים על הלחצן הוספת שותף להגדלת נפח תנועה.

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

בוחרים באפשרות maio בתור רשת מודעות, מזינים שם ייחודי ומפעילים בחירת רשת.

מפעילים את האפשרות איסוף נתונים אוטומטי ומזינים את מזהה ה-API ואת מפתח ה-API שקיבלתם בקטע הקודם.

אחרי שבוחרים את השותף להגדלת נפח תנועת הגולשים, בוחרים באפשרות Mobile SDK Mediation בתור סוג השילוב, באפשרות iOS בתור פלטפורמה ובאפשרות פעיל בתור סטטוס. מזינים את מזהה המדיה ואת מזהה האזור שהופיעו בקטע הקודם. לאחר מכן מזינים ערך בשדה עלות ברירת מחדל לאלף חשיפות.

כשמסיימים, לוחצים על שמירה בתחתית הדף.

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

  • מוסיפים את השורה הבאה לקובץ Podfile של הפרויקט:

    pod 'GoogleMobileAdsMediationMaio'

  • מריצים את הפקודה הבאה משורת הפקודה:

    pod install --repo-update

שילוב ידני

  • מורידים את הגרסה האחרונה של maio SDK.
  • מורידים את הגרסה האחרונה של מתאם maio מהקישור להורדה ביומן השינויים ומקשרים את maioAdapter.framework לפרויקט.

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

שילוב של SKAdNetwork

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

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

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

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

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

אימות מודעות בדיקה

כדי לוודא שאתם מקבלים מודעות בדיקה מ-maio, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות maio (Waterfall).

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-maio, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות GADResponseInfo.adNetworkInfoArray במחלקות הבאות:

פורמט שם הכיתה
מעברון GADMMaioInterstitialAdapter
ההטבה הופעלה GADMMaioRewardedAdapter

אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של maio כשהטעינה של מודעה נכשלת:

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

יומן השינויים של מתאם תהליך בחירת הרשת של maio ל-iOS

גרסה 2.2.0.1

  • הסרנו את ההטמעה של הבידינג כי Maio כבר לא תומכת בבידינג.
  • מעדכנים את המתאם לשימוש בפרוטוקול GADMediationAdapter.

נבנה ונבדק באמצעות:

  • גרסה 12.11.0 של Google Mobile Ads SDK.
  • גרסה 2.2.0 של Maio SDK.

גרסה 2.2.0.0

  • תאימות מאומתת לגרסה 2.2.0 של maio SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.11.0 של Google Mobile Ads SDK.
  • גרסה 2.2.0 של Maio SDK.

גרסה 2.1.6.1

  • מעכשיו נדרשת גרסה 12.0.0 ואילך של Google Mobile Ads SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.0.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.1.6.

גרסה 2.1.6.0

  • תאימות מאומתת לגרסה 2.1.6 של maio SDK.

נבנה ונבדק באמצעות:

  • גרסה 11.13.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.1.6.

גרסה 2.1.5.1

  • העדכון של CFBundleShortVersionString כולל שלושה רכיבים במקום ארבעה.

נבנה ונבדק באמצעות:

  • גרסה 11.10.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.1.5.

גרסה 2.1.5.0

  • תאימות מאומתת לגרסה 2.1.5 של maio SDK.

נבנה ונבדק באמצעות:

  • גרסה 11.6.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.1.5.

גרסה 2.1.4.0

  • תאימות מאומתת לגרסה 2.1.4 של maio SDK.

נבנה ונבדק באמצעות:

  • גרסה 11.2.0 של Google Mobile Ads SDK.
  • גרסה 2.1.4 של Maio SDK.

גרסה 2.1.3.0

  • תאימות מאומתת לגרסה 2.1.3 של maio SDK.

נבנה ונבדק באמצעות:

  • גרסה 11.1.0 של Google Mobile Ads SDK.
  • גרסה 2.1.3 של Maio SDK.

גרסה 2.1.2.1

  • מעכשיו נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
  • הכללה של Info.plist במסגרות בתוך MaioAdapter.xcframework.

נבנה ונבדק באמצעות:

  • גרסה 11.0.1 של Google Mobile Ads SDK.
  • גרסה 2.1.2 של Maio SDK.

גרסה 2.1.2.0

  • תאימות מאומתת לגרסה 2.1.2 של maio SDK.

נבנה ונבדק באמצעות:

  • גרסה 10.14.0 של Google Mobile Ads SDK.
  • גרסה 2.1.2 של Maio SDK.

גרסה 2.1.1.0

  • תאימות מאומתת לגרסה 2.1.1 של maio SDK.

נבנה ונבדק באמצעות:

  • גרסה 10.12.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.1.1.

גרסה 2.0.0.0

  • תאימות מאומתת לגרסה 2.0.0 של maio SDK.
  • הוסרה התלות ב-MaioOB SDK.
  • הוסר התמיכה בארכיטקטורה armv7.
  • נדרשת עכשיו גרסת iOS מינימלית של 12.0.
  • מעכשיו נדרשת גרסה 10.4.0 ואילך של Google Mobile Ads SDK.

נבנה ונבדק באמצעות:

  • גרסה 10.10.0 של Google Mobile Ads SDK.
  • גרסה 2.0.0 של Maio SDK.

גרסה 1.6.3.1

  • מעכשיו נדרשת גרסה 10.0.0 ואילך של Google Mobile Ads SDK.

נבנה ונבדק באמצעות:

  • גרסה 10.0.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.6.3.
  • גרסה 2.0.0-אלפא של MaioOB SDK.

גרסה 1.6.3.0

  • המתאם עודכן לשימוש ב-didRewardUser API.
  • מעכשיו נדרשת גרסה 9.8.0 ואילך של Google Mobile Ads SDK.
  • תאימות מאומתת לגרסה 1.6.3 של maio SDK ולגרסה 2.0.0-alpha של maioOB SDK.

נבנה ונבדק באמצעות:

  • גרסה 9.12.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.6.3.
  • גרסה 2.0.0-אלפא של MaioOB SDK.

גרסה 1.6.2.0

  • תאימות מאומתת לגרסה 1.6.2 של maio SDK ולגרסה 2.0.0-alpha של maioOB SDK.

נבנה ונבדק באמצעות:

  • גרסה 9.5.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.6.2.
  • גרסה 2.0.0-אלפא של MaioOB SDK.

גרסה 1.6.1.0

  • תאימות מאומתת לגרסה 1.6.1 של maio SDK ולגרסה 2.0.0-alpha של maioOB SDK.

נבנה ונבדק באמצעות:

  • גרסה 9.2.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.6.1.
  • גרסה 2.0.0-אלפא של MaioOB SDK.

גרסה 1.6.0.1

  • תאימות מאומתת לגרסה 9.0.0 של Google Mobile Ads SDK.
  • מעכשיו נדרשת גרסה 9.0.0 ואילך של Google Mobile Ads SDK.

נבנה ונבדק באמצעות:

  • גרסה 9.0.0 של Google Mobile Ads SDK.
  • גרסה 1.6.0 של Maio SDK.
  • גרסה 2.0.0-אלפא של MaioOB SDK.

גרסה 1.6.0.0

  • תאימות מאומתת לגרסה 1.6.0 של maio SDK ולגרסה 2.0.0-alpha של maioOB SDK.

נבנה ונבדק באמצעות:

  • גרסה 8.13.0 של Google Mobile Ads SDK.
  • נדרשת עכשיו גרסת iOS מינימלית של 10.0.
  • גרסה 1.6.0 של Maio SDK.
  • גרסה 2.0.0-אלפא של MaioOB SDK.

גרסה 1.5.8.0

  • תאימות מאומתת לגרסה 1.5.8 של maio SDK ולגרסה 2.0.0-alpha של maioOB SDK.
  • נוספה לאדפטר אפשרות לבידינג בפורמטים של מודעות מעברון ומודעות מתגמלות.
  • התלות בגרסה 8.0.0 ואילך של Google Mobile Ads SDK פחותה.

נבנה ונבדק באמצעות:

  • גרסה 8.7.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.8.
  • גרסה 2.0.0-אלפא של MaioOB SDK.

גרסה 1.5.6.1

  • נוספו קודים והודעות שגיאה סטנדרטיים של המתאם.
  • המתאם עודכן לשימוש בפורמט .xcframework.
  • תוקן באג שגרם לכך שלפעמים אירועים של מודעות מתגמלות לא הועברו.
  • מעכשיו נדרשת גרסה 8.3.0 ואילך של Google Mobile Ads SDK.

נבנה ונבדק באמצעות:

  • גרסה 8.3.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.6.

גרסה 1.5.6.0

  • תאימות מאומתת לגרסה 1.5.6 של maio SDK.
  • מעכשיו נדרשת גרסה 7.68.0 ואילך של Google Mobile Ads SDK.

נבנה ונבדק באמצעות:

  • גרסה 7.68.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.6.

גרסה 1.5.5.0

  • תאימות מאומתת לגרסה 1.5.5 של maio SDK.
  • מעכשיו נדרשת גרסה 7.64.0 ואילך של Google Mobile Ads SDK.

נבנה ונבדק באמצעות:

  • גרסה 7.64.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.5.

גרסה 1.5.4.0

  • תאימות מאומתת לגרסה 1.5.4 של maio SDK.
  • מעכשיו נדרשת גרסה 7.60.0 ואילך של Google Mobile Ads SDK.

נבנה ונבדק באמצעות:

  • גרסה 7.60.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.4.

גרסה 1.5.3.1

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

נבנה ונבדק באמצעות:

  • גרסה 7.58.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.3.

גרסה 1.5.3.0

  • תאימות מאומתת לגרסה 1.5.3 של maio SDK.

נבנה ונבדק באמצעות:

  • גרסה 7.55.1 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.3.

גרסה 1.5.2.1

  • תוקנה בעיה שבה המתאם לא הפעיל את הקריאה החוזרת -rewardedAdDidPresent:.

נבנה ונבדק באמצעות:

  • גרסה 7.53.1 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.2.

גרסה 1.5.2.0

  • תאימות מאומתת לגרסה 1.5.2 של maio SDK.

נבנה ונבדק באמצעות:

  • גרסה 7.53.1 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.2.

גרסה 1.5.1.0

  • תאימות מאומתת לגרסה 1.5.1 של maio SDK.

נבנה ונבדק באמצעות:

  • גרסה 7.52.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.1.

גרסה 1.5.0.0

  • תאימות מאומתת לגרסה 1.5.0 של maio SDK.

נבנה ונבדק באמצעות

  • גרסה 7.51.0 של Google Mobile Ads SDK.
  • גרסה 1.5.0 של Maio Ads SDK.

גרסה 1.4.8.0

  • תאימות מאומתת לגרסה 1.4.8 של maio SDK.

גרסה 1.4.6.0

  • תאימות מאומתת לגרסה 1.4.6 של maio SDK.
  • המתאם עודכן לשימוש ב-API החדש של מודעות מתגמלות.
  • מעכשיו נדרשת גרסה 7.42.2 ואילך של Google Mobile Ads SDK.

גרסה 1.4.2.0

  • תאימות מאומתת לגרסה 1.4.2 של maio SDK.

גרסה 1.4.1.0

  • תאימות מאומתת לגרסה 1.4.1 של maio SDK.
  • תוקנה בעיה שבה יכול להיות שמתאם maio ייכשל אם כמה MediaId מסופקים מ-AdMob.

גרסה 1.4.0.0

  • תאימות מאומתת לגרסה 1.4.0 של maio SDK.

גרסה 1.3.2.0

  • תאימות מאומתת לגרסה 1.3.2 של maio SDK.

גרסה 1.3.1.1

  • הוספתי את הפונקציה adapterDidCompletePlayingRewardBasedVideoAd: callback למתאם.

גרסה 1.3.1.0

  • תאימות מאומתת לגרסה 1.3.1 של maio SDK.

גרסה 1.3.0.0

  • תאימות מאומתת לגרסה 1.3.0 של maio SDK.

גרסה 1.2.19.0

  • תאימות מאומתת לגרסה 1.2.19 של maio SDK.

גרסה 1.2.18.0

  • הגרסה הראשונה!
  • הוספנו תמיכה במודעות מעברון ובמודעות וידאו מתגמלות.