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

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

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

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

מתאם תהליך הבחירה של רשת מודעות של 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 (ניהול אזורים), מאתרים את Zone ID (מזהה האזור). הוא גם נדרש כדי להגדיר את יחידת המודעות ב-Ad Manager בקטע הבא.

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

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

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

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

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

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

אחר כך לוחצים על הלחצן הוספת שותף תפוקה.

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

בוחרים באפשרות maio בתור רשת המודעות, מזינים שם ייחודי ומפעילים את האפשרות תהליך בחירת הרשת (Mediation).

מפעילים את האפשרות איסוף נתונים אוטומטי ומזינים את מזהה ה-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.

שילוב ידני

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

שימוש ב-CocoaPods

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

    pod 'GoogleMobileAdsMediationMaio'

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

    pod install --repo-update

שלב 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.
  • עודכן ה-dependency של 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.
  • גרסת Maio SDK‏ 2.2.0.

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

גרסה 1.6.3.0

  • המתאם עודכן כך שישתמש ב-API של didRewardUser.
  • עכשיו נדרשת גרסה 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-alpha של 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-alpha של 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-alpha של 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-alpha של MaioOB SDK.

גרסה 1.5.8.0

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

נבנה ונבדק עם:

  • גרסה 8.7.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.8.
  • גרסה 2.0.0-alpha של 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.
  • גרסה 1.5.3 של Maio SDK.

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

גרסה 1.5.2.0

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

נבנה ונבדק עם:

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

גרסה 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 עלול להיכשל אם 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

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

גרסה 1.2.18.0

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