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

בחירת פלטפורמה: Android iOS Unity Flutter Android (גרסה קודמת)

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

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

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

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

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

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

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

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

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

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

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

מעברון

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

ההטבה הופעלה

מזינים את שם האפליקציה (Name), בוחרים את הפלטפורמה ומציינים את כתובת ה-URL של האפליקציה (App 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: מייבאים את ה-SDK והמתאם של maio

שימוש ב-Swift Package Manager

לפני שממשיכים, צריך לוודא שיש לכם את גרסת המתאם המינימלית הנתמכת 2.2.0.0.

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

  1. ב-Xcode, עוברים אל File > Add Package Dependencies...‎ (קובץ > הוספת יחסי תלות בין חבילות).

  2. בפרומפט שמופיע, מחפשים את כתובת ה-URL של החבילה הבאה:

    https://github.com/googleads/googleads-mobile-ios-mediation-maio.git

  3. בקטע Dependency Rule, בוחרים באפשרות Branch.

  4. בשדה הטקסט, מזינים main.

שימוש ב-CocoaPods

  • מוסיפים את השורה הבאה לקובץ 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 כבר נטענה מודעה להגדרת הרשת הזו.
105 מסננים בקשות עם הגבלת גיל ל-maio SDK כי הוא לא יכול לקבל אותות עם הגבלת גיל.

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

גרסה 2.2.3.0

  • תאימות מאומתת עם גרסה 2.2.3 של maio SDK.

פותח ונבדק עם:

  • גרסה 13.9.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.2.3.

גרסה 2.2.2.0

  • תאימות מאומתת עם גרסה 2.2.2 של maio SDK.
  • נדרשת עכשיו גרסת iOS מינימלית 15.0.
  • עדכנו את גרסת iOS המינימלית כדי להקל על התלות ב-Google Mobile Ads SDK ולאפשר גרסאות משניות.

פותח ונבדק עם:

  • גרסה 13.7.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.2.2.

גרסה 2.2.1.2

  • סינון בקשות שמוגבלות לפי גיל ב-maio SDK כש-ageRestrictedTreatment החדש מוגדר כ-GADAgeRestrictedTreatmentChild.

פותח ונבדק עם:

  • גרסה 13.3.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.2.1.

גרסה 2.2.1.1

  • צריך לסנן בקשות עם הגבלת גיל ב-maio SDK כי הוא לא יכול לקבל אותות עם הגבלת גיל.

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

  • גרסה 13.2.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.2.1.

גרסה 2.2.1.0

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

פותח ונבדק עם:

  • גרסה 13.1.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.2.1.

גרסה 2.2.0.3

  • נוספה תמיכה במודעות באנר ב-Waterfall.
  • עודכנה התלות ב-Google Mobile Ads SDK לגרסה 13.0.0.

פותח ונבדק עם:

  • גרסה 13.0.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.2.0.

גרסה 2.2.0.2

  • הגרסה המינימלית של iOS ב-CocoaPods עודכנה ל-13.0.

פותח ונבדק עם:

  • גרסה 13.0.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.2.0.

גרסה 2.2.0.1

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

פותח ונבדק עם:

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

גרסה 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.
  • גרסת Maio SDK‏ 2.1.2.

גרסה 2.1.2.0

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

פותח ונבדק עם:

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

גרסה 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-alpha של 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.
  • גרסה 1.5.4 של Maio SDK.

גרסה 1.5.3.1

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

פותח ונבדק עם:

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

גרסה 1.5.3.0

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

פותח ונבדק עם:

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

גרסה 1.5.2.1

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

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

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

גרסה 1.5.2.0

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

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

  • גרסה 7.53.1 של Google Mobile Ads SDK.
  • גרסת SDK‏ Maio‏ 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

  • הוספנו קריאה חוזרת (callback) של adapterDidCompletePlayingRewardBasedVideoAd: למתאם.

‫גרסה 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

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