במדריך הזה נסביר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-MAIO באמצעות Mediation של AdMob, כולל שילובים של רשימת הרשתות. במאמר מוסבר איך להוסיף את maio להגדרות בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של maio באפליקציה ל-iOS.
בממשק של מרכז הבקרה של maio נעשה שימוש בטקסט ביפנית בתווית, בלחצנים ובתיאורים, והצילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות במדריך הזה, נעשה שימוש בשמות התוויות והלחצנים באנגלית. לדוגמה, 'URL スキーム' הוא 'URL Scheme'.
השילובים והפורמטים של המודעות הנתמכים
למתאם בחירת הרשת של maio יש את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| מפל | |
| פורמטים | |
| מודעת באנר | |
| מעברון | |
| ההטבה הופעלה | |
| מותאם | |
דרישות
- יעד הפריסה של iOS מגרסה 12.0 ואילך
הגרסה העדכנית ביותר של Google Mobile Ads SDK
מדריך לתחילת העבודה בנושא בחירת הרשת
שלב 1: הגדרת ההגדרות בממשק המשתמש של MAIO
קודם כול, נרשמים או נכנסים לחשבון maio. לוחצים על הלחצן Application management (ניהול אפליקציות) בסרגל הצד הימני ואז על New app (אפליקציה חדשה).
בוחרים את הכרטיסייה שתואמת לסוג המודעה המועדף.
מעברון
מזינים את השם של האפליקציה, בוחרים את הפלטפורמה ומספקים את כתובת ה-URL של האפליקציה. בוחרים באפשרות מודעת מעברון וידאו בתור סוג המודעה ולוחצים על עדכון.
ההטבה הופעלה
מזינים את השם של האפליקציה, בוחרים את הפלטפורמה ומספקים את כתובת ה-URL של האפליקציה. בוחרים באפשרות Video Rewards בתור סוג המודעה ולוחצים על עדכון.
בדף Application Management, מציינים את Media ID. הוא נדרש להגדרת יחידת המודעות ב-AdMob בקטע הבא.
בדף Zone Management, מציינים את Zone ID. תצטרכו גם להגדיר את יחידת המודעות ב-AdMob בקטע הבא.
שלב 2: הגדרת ביקוש של Maio בממשק המשתמש של AdMob
הגדרת הגדרות בחירת הרשת ליחידת המודעות
צריך להוסיף את MAI להגדרת תהליך בחירת הרשת של יחידת המודעות.
קודם כול, נכנסים לחשבון AdMob. לאחר מכן, עוברים לכרטיסייה תהליך בחירת הרשת (Mediation). אם יש לכם קבוצה קיימת לבחירת רשת שרוצים לשנות, לוחצים על השם שלה כדי לערוך אותה ודלגים לקטע הוספת MAI כמקור מודעות.
כדי ליצור קבוצה חדשה לבחירת רשת, בוחרים באפשרות יצירת קבוצה לבחירת רשת.
מזינים את פורמט המודעה ואת הפלטפורמה ולוחצים על המשך.
נותנים שם לקבוצה לבחירת רשת ובוחרים את המיקומים לטירגוט. לאחר מכן, מגדירים את הסטטוס של קבוצת בחירת הרשת ל-מופעל ולוחצים על הוספת יחידות מודעות.
משייכים את הקבוצה לבחירת רשת (Mediation) הזו לאחת או יותר מיחידות המודעות הקיימות ב-AdMob. לאחר מכן לוחצים על סיום.
כרטיס יחידות המודעות אמור להיות מאוכלס עכשיו ביחידות המודעות שבחרתם:
הוספת MAI כמקור מודעות
בקטע מקורות מודעות, בכרטיס Waterfall, בוחרים באפשרות הוספת מקור מודעות. לאחר מכן בוחרים באפשרות maio.
בוחרים באפשרות maio ומפעילים את המתג Optimize. מזינים את מזהה ה-API ואת מפתח ה-API שהתקבלו בקטע הקודם כדי להגדיר אופטימיזציה של מקורות המודעות ב-maio. לאחר מכן, מזינים ערך של עלות בפועל לאלף חשיפות עבור maio ולוחצים על המשך.
אם כבר יש לכם מיפוי של maioi, תוכלו לבחור בו. אחרת, לוחצים על הוספת מיפוי.
בשלב הבא, מזינים את Media ID ואת Zone ID שהתקבלו בקטע הקודם. לאחר מכן לוחצים על סיום.
שלב 3: מייבאים את ה-SDK ואת המתאם של maio
שימוש ב-CocoaPods (מומלץ)
מוסיפים את השורה הבאה ל-Podfile של הפרויקט:
pod 'GoogleMobileAdsMediationMaio'מריצים את הפקודה הבאה בשורת הפקודה:
pod install --repo-update
שילוב ידני
- מורידים את הגרסה האחרונה של maio SDK.
- מורידים את הגרסה האחרונה של מתאם maio מהקישור להורדה בChangelog, ומקשרים את
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.1.5.1
- עדכנו את
CFBundleShortVersionStringכך שיכלול שלושה רכיבים במקום ארבעה.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 11.10.0.
- גרסת SDK של Maio 2.1.5.
גרסה 2.1.5.0
- תאימות מאומתת עם גרסת SDK של maio 2.1.5.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 11.6.0.
- גרסת SDK של Maio 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.
- גרסת SDK של Maio 2.1.2.
גרסה 2.1.2.0
- תאימות מאומתת עם גרסת SDK של maio 2.1.2.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 10.14.0.
- גרסת SDK של Maio 2.1.2.
גרסה 2.1.1.0
- תאימות מאומתת עם גרסת SDK של maio 2.1.1.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 10.12.0.
- גרסת SDK של Maio 2.1.1.
גרסה 2.0.0.0
- תאימות מאומתת עם גרסת SDK של maio 2.0.0.
- הסרתם את התלות ב-
MaioOB SDK. - הסרת התמיכה בארכיטקטורה
armv7. - עכשיו נדרשת גרסת iOS מגרסה 12.0 ואילך.
- מעכשיו נדרשת גרסה 10.4.0 ואילך של Google Mobile Ads SDK.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 10.10.0.
- גרסת SDK של Maio 2.0.0.
גרסה 1.6.3.1
- מעכשיו נדרשת גרסה 10.0.0 ואילך של Google Mobile Ads SDK.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 10.0.0.
- גרסת SDK של Maio 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
- תאימות מאומתת עם SDK של maio בגרסה 1.6.2 ו-SDK של maioOB בגרסה 2.0.0-alpha.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 9.5.0.
- גרסת SDK של Maio 1.6.2.
- גרסת SDK של MaioOB 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.
- גרסת SDK של Maio 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.
- גרסת SDK של Maio 1.6.0.
- גרסת SDK של MaioOB 2.0.0-alpha.
גרסה 1.6.0.0
- תאימות מאומתת עם SDK של maio בגרסה 1.6.0 ו-SDK של maioOB בגרסה 2.0.0-alpha.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 8.13.0.
- עכשיו נדרשת גרסת iOS מגרסה 10.0 לפחות.
- גרסת SDK של Maio 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.
- גרסת SDK של Maio 1.5.8.
- גרסת SDK של MaioOB 2.0.0-alpha.
גרסה 1.5.6.1
- נוספו קודים והודעות סטנדרטיים של שגיאות במתאם.
- עדכנו את המתאם כך שישתמש בפורמט
.xcframework. - תוקן באג שבו לפעמים לא הועברו אירועים של מודעות מתגמלות.
- מעכשיו נדרשת גרסה 8.3.0 ואילך של Google Mobile Ads SDK.
הקוד נוצר ונבדק באמצעות:
- 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
- תאימות מאומתת עם גרסת SDK של maio 1.5.4.
- מעכשיו נדרשת גרסה 7.60.0 ואילך של Google Mobile Ads SDK.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 7.60.0.
- גרסת SDK של Maio 1.5.4.
גרסה 1.5.3.1
- כדי להגביל את זמן הקצאת הזמן הקצוב לתפוגה, בקשות להצגת מודעות יידחו עכשיו באופן מיידי אם ל-MAIO אין מודעה מוכנה להצגה.
- הוסר התמיכה בארכיטקטורה i386.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 7.58.0.
- גרסת SDK של Maio 1.5.3.
גרסה 1.5.3.0
- תאימות מאומתת עם גרסת SDK של maio 1.5.3.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 7.55.1.
- גרסת SDK של Maio 1.5.3.
גרסה 1.5.2.1
- תוקנה בעיה שבה המתאם לא הפעיל את פונקציית ה-callback
-rewardedAdDidPresent:.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 7.53.1.
- גרסת SDK של Maio 1.5.2.
גרסה 1.5.2.0
- תאימות מאומתת עם גרסת SDK של maio 1.5.2.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 7.53.1.
- גרסת SDK של Maio 1.5.2.
גרסה 1.5.1.0
- תאימות מאומתת עם גרסת SDK של maio 1.5.1.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 7.52.0.
- גרסת SDK של Maio 1.5.1.
גרסה 1.5.0.0
- תאימות מאומתת עם גרסת SDK של maio 1.5.0.
נוצרו ונבדקו באמצעות
- Google Mobile Ads SDK בגרסה 7.51.0.
- גרסת SDK של Maio Ads 1.5.0.
גרסה 1.4.8.0
- תאימות מאומתת עם גרסת SDK של maio 1.4.8.
גרסה 1.4.6.0
- תאימות מאומתת עם גרסת SDK של maio 1.4.6.
- עדכנו את המתאם כך שישתמש ב-Rewarded API החדש.
- מעכשיו נדרשת גרסה 7.42.2 ואילך של Google Mobile Ads SDK.
גרסה 1.4.2.0
- תאימות מאומתת עם גרסת SDK של maio 1.4.2.
גרסה 1.4.1.0
- תאימות מאומתת עם גרסת SDK של maio 1.4.1.
- תוקנה בעיה שגרמה לכך שהמתאם של Maio עלול להיכשל אם מוצגים מספר MediaIds מ-AdMob.
גרסה 1.4.0.0
- תאימות מאומתת עם גרסת SDK של maio 1.4.0.
גרסה 1.3.2.0
- תאימות מאומתת עם גרסת SDK של maio 1.3.2.
גרסה 1.3.1.1
- הוספנו קריאה חוזרת (callback) מסוג
adapterDidCompletePlayingRewardBasedVideoAd:למתאם.
גרסה 1.3.1.0
- תאימות מאומתת עם גרסת SDK של maio 1.3.1.
גרסה 1.3.0.0
- תאימות מאומתת עם גרסת SDK של maio 1.3.0.
גרסה 1.2.19.0
- תאימות מאומתת עם גרסת SDK של maio 1.2.19.
גרסה 1.2.18.0
- הגרסה הראשונה!
- הוספנו תמיכה במודעות מעברון ובמודעות וידאו מתגמלות.