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

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

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

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

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

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

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

דרישות

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

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

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

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

מעברון

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

ההטבה הופעלה

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

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

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

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

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

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

צריך להוסיף את maio להגדרת תהליך בחירת הרשת של יחידת המודעות.

קודם כול, נכנסים לחשבון AdMob. לאחר מכן, עוברים לכרטיסייה Mediation (גישור). אם יש לכם קבוצה קיימת לבחירת רשת שאתם רוצים לשנות, לוחצים על השם של הקבוצה כדי לערוך אותה ומדלגים אל הוספת maio כמקור מודעות.

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

מזינים את פורמט המודעה והפלטפורמה ולוחצים על המשך.

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

משייכים את הקבוצה הזו לבחירת רשת (Mediation) לאחת או יותר מיחידות המודעות הקיימות ב-AdMob. לאחר מכן לוחצים על סיום.

עכשיו אמור להופיע כרטיס של יחידות מודעות עם יחידות המודעות שבחרתם:

הוספה של maio כמקור מודעות


בכרטיס Waterfall שבקטע מקורות מודעות, בוחרים באפשרות הוספה של מקור מודעות.

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



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

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


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

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

    pod 'GoogleMobileAdsMediationMaio'

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

    pod install --repo-update

שילוב ידני

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

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

שילוב של SKAdNetwork

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

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

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

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

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

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