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

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

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

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

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

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

דרישות

  • יעד הפריסה של iOS מגרסה 12.0 ואילך

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

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

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

מעברון

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

ההטבה הופעלה

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

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

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

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

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

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

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

    pod 'GoogleMobileAdsMediationMaio'

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

    pod install --repo-update

שילוב ידני

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

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

שילוב עם SKAdNetwork

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

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

קודי שגיאה

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

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

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

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

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

גרסה 2.1.5.1

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

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

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

גרסה 2.1.5.0

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

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

  • Google Mobile Ads SDK בגרסה 11.6.0.
  • Maio SDK גרסה 2.1.5.

גרסה 2.1.4.0

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

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

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

גרסה 2.1.3.0

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

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

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

גרסה 2.1.2.1

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

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

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

גרסה 2.1.2.0

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

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

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

גרסה 2.1.1.0

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

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

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

גרסה 2.0.0.0

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

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

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

גרסה 1.6.3.1

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

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

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

גרסה 1.6.3.0

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

פותח ונבדק בעזרת:

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

גרסה 1.6.2.0

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

פותח ונבדק בעזרת:

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

גרסה 1.6.1.0

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

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

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

גרסה 1.6.0.1

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

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

  • Google Mobile Ads SDK בגרסה 9.0.0.
  • Maio SDK גרסה 1.6.0.
  • גרסת SDK של MaioOB‏ 2.0.0-alpha.

גרסה 1.6.0.0

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

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

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

גרסה 1.5.8.0

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

פותח ונבדק בעזרת:

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

גרסה 1.5.6.1

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

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

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

גרסה 1.5.6.0

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

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

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

גרסה 1.5.5.0

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

פותח ונבדק בעזרת:

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

גרסה 1.5.4.0

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

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 7.58.0.
  • Maio SDK גרסה 1.5.3.

גרסה 1.5.3.0

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

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

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

גרסה 1.5.2.1

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

פותח ונבדק בעזרת:

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

גרסה 1.5.2.0

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

פותח ונבדק בעזרת:

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

גרסה 1.5.1.0

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

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

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

גרסה 1.5.0.0

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

פותח ונבדק עם

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

גרסה 1.4.8.0

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

גרסה 1.4.6.0

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

גרסה 1.4.2.0

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

גרסה 1.4.1.0

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

גרסה 1.4.0.0

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

גרסה 1.3.2.0

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

גרסה 1.3.1.1

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

גרסה 1.3.1.0

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

גרסה 1.3.0.0

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

גרסה 1.2.19.0

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

גרסה 1.2.18.0

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