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

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

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

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

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

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

דרישות

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

• הגרסה העדכנית של Google Mobile Ads SDK.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בכרטיס Waterfall שבקטע Ad Sources, בוחרים באפשרות Add Ad Source.

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



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

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

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

שימוש ב-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	כבר נטענה מודעה להגדרת הרשת הזו.

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

גרסה 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.
• נוספה לאדפטר יכולת בידינג לפורמטים של מודעות מעברון ומודעות מתגמלות.
• התלות ב-Google Mobile Ads SDK גרסה 8.0.0 ואילך פחות מחמירה.

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

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

• תאימות מאומתת לגרסת SDK‏ 1.5.6 של maio.
• מעכשיו נדרשת גרסה 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

• הוספתי את פונקציית ה-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

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