במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-maio באמצעות תהליך בחירת הרשת (Mediation), שכוללות שילובים של Waterfall. המאמר מסביר איך להוסיף את maio ליחידת מודעות הגדרת תהליך בחירת הרשת, ואיך לשלב את ה-SDK והמתאם של maio אפליקציה אחת ( )
בממשק מרכז הבקרה של maio נעשה שימוש בטקסט ביפנית בתור התוויות, הלחצנים ותיאורים, וצילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות של מדריך זה, תוויות ולחצנים ומזכירים את המונחים המקבילים להם באנגלית. "URL insertーム", לדוגמה, היא 'סכמת כתובת ה-URL'.
השילובים והפורמטים של המודעות שנתמכים
למתאם תהליך בחירת הרשת ב-maio יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מותאם |
דרישות
- יעד הפריסה של iOS מגרסה 12.0 ואילך
ה-SDK העדכני של Google Mobile Ads
השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של maio
קודם כל, נרשמים או מתחברים לחשבון maio. בסרגל הצד שמשמאל, לוחצים על Application management ואז על New app.
בוחרים את הכרטיסייה שתואמת לסוג המודעה המועדף.
פרסומת מרווח ביניים
נותנים שם לאפליקציה, בוחרים את הפלטפורמה ומזינים את כתובת ה-URL של האפליקציה. בחר באפשרות מודעת מעברון בווידאו בתור סוג המודעה, ולחץ על עדכון.
Android
iOS
ההטבה הופעלה
נותנים שם לאפליקציה, בוחרים את הפלטפורמה ומזינים את כתובת ה-URL של האפליקציה. בוחרים באפשרות Video Rewards בתור סוג המודעה ולוחצים על עדכון.
Android
iOS
בדף Application Management שים לב למזהה המדיה. תצטרכו להגדיר את יחידת המודעות Ad Manager בקטע הבא.
Android
iOS
בדף Zone Management מציינים את Zone ID. בקטע הבא תצטרכו גם להגדיר את Ad Manager יחידת המודעות.
Android
iOS
שלב 2: הגדרת ביקוש ב-maio Ad Manager בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
שלב 3: מייבאים את ה-SDK והמתאם של maio
שימוש ב-CocoaPods (מומלץ)
מוסיפים את השורה הבאה ל-Podfile של הפרויקט:
pod 'GoogleMobileAdsMediationMaio'
מריצים את שורת הפקודה:
pod install --repo-update
שילוב ידני
- להוריד את הגרסה האחרונה של maio SDK.
- אפשר להוריד את הגרסה האחרונה של מתאם maio דרך הקישור להורדה
Changelog (יומן שינויים),
ולקשר את
maioAdapter.framework
בפרויקט שלך.
שלב 4: מוסיפים את הקוד הנדרש
שילוב של SKAdNetwork
פועלים לפי מסמכי התיעוד של Maio.
כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- Ad Manager
בעלי אפליקציות שמשתמשים בגרסה 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
. - תוקן באג שגרם לכך שאירועים של מודעות מתגמלות לא הועברו לפעמים.
- כדי להשתמש בתכונה הזו נדרשת עכשיו Google Mobile Ads SDK גרסה 8.3.0 ואילך.
פותח ונבדק בעזרת:
- 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
- גרסה ראשונה!
- הוספנו תמיכה במודעות מעברון ובמודעות וידאו מתגמלות.