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

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

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

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

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

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

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

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

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

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

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

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

מעברון

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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




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



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


שלב 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: בודקים את ההטמעה

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

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

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

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

גרסה 1.2.18.0

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