במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-maio באמצעות תהליך בחירת הרשת ב-AdMob, שכוללות שילובים של Waterfall. המאמר מסביר איך להוסיף את maio ליחידת מודעות הגדרת תהליך בחירת הרשת, ואיך לשלב את ה-SDK והמתאם של maio אפליקציה אחת (iOS )
בממשק מרכז הבקרה של maio נעשה שימוש בטקסט ביפנית בתור התוויות, הלחצנים ותיאורים, וצילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות של מדריך זה, תוויות ולחצנים ומזכירים את המונחים המקבילים להם באנגלית. "URL insertーム", לדוגמה, היא 'סכמת כתובת ה-URL'.
השילובים והפורמטים של המודעות שנתמכים
למתאם תהליך בחירת הרשת ב-maio יש את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| מפל | |
| פורמטים | |
| כרזה | |
| מעברון | |
| ההטבה הופעלה | |
| מותאם | |
דרישות
- יעד הפריסה של iOS מגרסה 12.0 ואילך
ה-SDK העדכני של Google Mobile Ads
השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של maio
שלב 2: הגדרת ביקוש ב-maio AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
עליך להוסיף maio לתצורה של תהליך בחירת הרשת של יחידת המודעות.
קודם נכנסים לחשבון AdMob. לאחר מכן נכנסים לכרטיסייה תהליך בחירת הרשת (Mediation). אם יש קבוצה קיימת לבחירת רשת שאתם רוצים לשנות, צריך ללחוץ על השם של הקבוצה לבחירת רשת כדי לערוך אותה, ולדלג לקטע הוספה maio כמקור מודעות.
כדי ליצור קבוצה חדשה לבחירת רשת, בוחרים באפשרות יצירת קבוצה לבחירת רשת (Mediation).
מזינים את פורמט המודעה ואת הפלטפורמה, ולוחצים על המשך.
נותנים שם לקבוצה לבחירת רשת (Mediation) ובוחרים מיקומים גיאוגרפיים לטירגוט. בשלב הבא, מגדירים את הסטטוס של הקבוצה לבחירת רשת למופעלת ולוחצים על הוספת יחידות של מודעות.
משייכים את הקבוצה הזו לבחירת רשת לאחת או יותר מיחידות המודעותAdMob הקיימות. לאחר מכן לוחצים על סיום.
עכשיו אתם אמורים לראות שהכרטיס של יחידות המודעות מאוכלס ביחידות של המודעות שבחרתם:
הוספה של maio כמקור מודעות
בכרטיס Waterfall בקטע מקורות מודעות, בוחרים באפשרות הוספת מקור מודעות. לאחר מכן בוחרים maio.
בוחרים באפשרות maio ומפעילים את המתג Optimize. עליכם להזין את API ID and API KEYשקיבלתם בסעיף הקודם כדי להגדיר אופטימיזציה של מקורות מודעות עבורmaio. לאחר מכן מזינים ערך של עלות בפועל לאלף חשיפות עבורmaio ולוחצים על המשך.
אם כבר יש לכם מיפוי של maio, תוכלו לבחור אותו. אם לא, לוחצים על הוספת מיפוי.
לאחר מכן, מזינים את Media ID and 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 | כבר נטענה מודעה לתצורת הרשת הזו. |
יומן שינויים של מתאם תהליך בחירת הרשת (Mediation) ב-maio iOS
גרסה 2.1.5.0
- תאימות מאומתת ל-maio SDK גרסה 2.1.5.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 11.6.0.
- Maio SDK גרסה 2.1.5.
גרסה 2.1.4.0
- תאימות מאומתת ל-maio SDK גרסה 2.1.4.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 11.2.0.
- Maio SDK גרסה 2.1.4.
גרסה 2.1.3.0
- תאימות מאומתת ל-maio SDK גרסה 2.1.3.
פותח ונבדק בעזרת:
- גרסה 11.1.0 של Google Mobile Ads SDK.
- Maio SDK גרסה 2.1.3.
גרסה 2.1.2.1
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
Info.plistכלול ב-frameworks בתוךMaioAdapter.xcframework.
פותח ונבדק בעזרת:
- גרסה 11.0.1 של Google Mobile Ads SDK.
- Maio SDK גרסה 2.1.2.
גרסה 2.1.2.0
- תאימות מאומתת ל-maio SDK גרסה 2.1.2.
פותח ונבדק בעזרת:
- גרסה 10.14.0 של Google Mobile Ads SDK
- Maio SDK גרסה 2.1.2.
גרסה 2.1.1.0
- תאימות מאומתת ל-maio SDK גרסה 2.1.1.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 10.12.0.
- Maio SDK גרסה 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.
פותח ונבדק בעזרת:
- גרסה 10.10.0 של Google Mobile Ads SDK.
- Maio SDK גרסה 2.0.0.
גרסה 1.6.3.1
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 10.0.0 ואילך של Google Mobile Ads SDK.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 10.0.0.
- Maio SDK גרסה 1.6.3.
- MaioOB SDK גרסה 2.0.0-alpha.
גרסה 1.6.3.0
- המתאם עודכן לשימוש ב-API של
didRewardUser. - כדי להשתמש עכשיו באפליקציה נדרשת גרסה 9.8.0 ואילך של Google Mobile Ads SDK.
- תאימות מאומתת ל-maio SDK בגרסה 1.6.3 ול-maioOB SDK בגרסה 2.0.0-alpha.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 9.12.0.
- Maio SDK גרסה 1.6.3.
- MaioOB SDK גרסה 2.0.0-alpha.
גרסה 1.6.2.0
- תאימות מאומתת ל-maio SDK בגרסה 1.6.2 ול-maioOB SDK בגרסה 2.0.0-alpha.
פותח ונבדק בעזרת:
- גרסה 9.5.0 של Google Mobile Ads SDK.
- Maio SDK גרסה 1.6.2.
- MaioOB SDK גרסה 2.0.0-alpha.
גרסה 1.6.1.0
- תאימות מאומתת ל-maio SDK בגרסה 1.6.1 ול-maioOB SDK בגרסה 2.0.0-alpha.
פותח ונבדק בעזרת:
- גרסה 9.2.0 של Google Mobile Ads SDK.
- Maio SDK גרסה 1.6.1.
- MaioOB SDK גרסה 2.0.0-alpha.
גרסה 1.6.0.1
- תאימות מאומתת ל-Google Mobile Ads SDK גרסה 9.0.0.
- כדי להשתמש בתכונה הזו, צריך Google Mobile Ads SDK בגרסה 9.0.0 ואילך.
פותח ונבדק בעזרת:
- גרסה 9.0.0 של Google Mobile Ads SDK.
- Maio SDK גרסה 1.6.0.
- MaioOB SDK גרסה 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.
- MaioOB SDK גרסה 2.0.0-alpha.
גרסה 1.5.8.0
- תאימות מאומתת ל-maio SDK בגרסה 1.5.8 ול-maioOB SDK בגרסה 2.0.0-alpha.
- נוספה יכולת בידינג למתאם בפורמטים של מודעות מעברון ושל מודעות מתגמלות.
- תלות רגועה ב-Google Mobile Ads SDK בגרסה 8.0.0 ואילך.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 8.7.0.
- Maio SDK גרסה 1.5.8.
- MaioOB SDK גרסה 2.0.0-alpha.
גרסה 1.5.6.1
- נוספו הודעות וקודי שגיאה של מתאם סטנדרטי.
- המתאם עודכן לפורמט
.xcframework. - תוקן באג שגרם לכך שאירועים של מודעות מתגמלות לא הועברו לפעמים.
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 8.3.0 ואילך של Google Mobile Ads SDK.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 8.3.0.
- Maio SDK גרסה 1.5.6.
גרסה 1.5.6.0
- תאימות מאומתת ל-maio SDK גרסה 1.5.6.
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.68.0 ואילך של Google Mobile Ads SDK.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 7.68.0.
- Maio SDK גרסה 1.5.6.
גרסה 1.5.5.0
- תאימות מאומתת ל-maio SDK גרסה 1.5.5.
- כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.64.0 ואילך של Google Mobile Ads SDK.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 7.64.0.
- Maio SDK גרסה 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.
- Maio SDK גרסה 1.5.2.
גרסה 1.5.1.0
- תאימות מאומתת ל-maio SDK גרסה 1.5.1.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 7.52.0.
- Maio SDK גרסה 1.5.1.
גרסה 1.5.0.0
- תאימות מאומתת ל-maio SDK גרסה 1.5.0.
פותח ונבדק עם
- גרסה 7.51.0 של Google Mobile Ads SDK.
- Maio Ads SDK גרסה 1.5.0.
גרסה 1.4.8.0
- תאימות מאומתת ל-maio SDK בגרסה 1.4.8.
גרסה 1.4.6.0
- תאימות מאומתת ל-maio SDK בגרסה 1.4.6.
- המתאם עודכן לשימוש בממשק ה-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 עלול להיכשל אם יסופקו כמה מזהי MediaId מ-AdMob.
גרסה 1.4.0.0
- תאימות מאומתת ל-maio SDK גרסה 1.4.0.
גרסה 1.3.2.0
- תאימות מאומתת ל-maio SDK גרסה 1.3.2.
גרסה 1.3.1.1
- הקריאה החוזרת של
adapterDidCompletePlayingRewardBasedVideoAd:נוספה למתאם.
גרסה 1.3.1.0
- תאימות מאומתת ל-maio SDK גרסה 1.3.1.
גרסה 1.3.0.0
- תאימות מאומתת ל-maio SDK גרסה 1.3.0.
גרסה 1.2.19.0
- תאימות מאומתת ל-maio SDK בגרסה 1.2.19.
גרסה 1.2.18.0
- גרסה ראשונה!
- הוספנו תמיכה במודעות מעברון ובמודעות וידאו מתגמלות.