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

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

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

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

המתאם של Ad Manager תהליך בחירת הרשת ב-maio כולל את היכולות הבאות:

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

דרישות

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

• ה-SDK העדכני של מודעות Google לנייד

• השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה

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

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

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

פרסומת מרווח ביניים

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

Android

iOS

הערה: כברירת מחדל, ניתן לדלג על מודעות מעברון של maio.

ההטבה הופעלה

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

Android

iOS

הערה: כברירת מחדל, לא ניתן לדלג על מודעות וידאו מתגמלות של maio.

בדף Application Management שים לב למזהה המדיה. תצטרכו להגדיר את יחידת המודעות Ad Manager בקטע הבא.

Android

iOS

בדף Zone Management מציינים את Zone ID. בקטע הבא תצטרכו גם להגדיר את Ad Manager יחידת המודעות.

Android

iOS

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

הערה: (Waterfall בלבד) אם זו הפעם הראשונה שאתם מגדירים חשבון maio, יכול להיות שתצטרכו לפנות לצוות התמיכה של maio כדי שיונפקו לכם מזהה API ומפתח API.

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

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

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

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

הערה: אם לא משלבים את הגרסה התואמת של maio ואת הגרסה של Google Mobile Ads SDK, עלולות להיווצר בעיות ב-build.

שימוש ב-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 בטלפונים ובטאבלטים שרשומים כמכשירי בדיקה בזמן שליחת בקשות.

חשוב: צריך להשבית את מצב הבדיקה עבור Ad Manager וגם maio לפני פרסום האפליקציה.

אימות מודעות בדיקה

כדי לוודא שמוצגות לך מודעות לבדיקה מ-maio, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות maio (Waterfall) מקורות המודעות.

קודי שגיאה

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

מבנה הקורס	שם הכיתה
פרסומת מרווח ביניים	GADMMaioInterstitialAdapter
ההטבה הופעלה	GADMMaioRewardedAdapter

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

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

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

גרסה 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 נכלל במסגרות בתוך 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.

נוצר ונבדק בעזרת:

• גרסה 10.12.0 של Google Mobile Ads SDK.
• 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.

נוצר ונבדק בעזרת:

• גרסה 10.0.0 של Google Mobile Ads SDK.
• Maio SDK גרסה 1.6.3.
• MaioOB SDK בגרסה 2.0.0-אלפא.

גרסה 1.6.3.0

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

נוצר ונבדק בעזרת:

• גרסה 9.12.0 של Google Mobile Ads SDK.
• Maio SDK גרסה 1.6.3.
• MaioOB SDK בגרסה 2.0.0-אלפא.

גרסה 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-אלפא.

גרסה 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-אלפא.

גרסה 1.6.0.1

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

נוצר ונבדק בעזרת:

• גרסה 9.0.0 של Google Mobile Ads SDK.
• Maio SDK גרסה 1.6.0.
• MaioOB SDK בגרסה 2.0.0-אלפא.

גרסה 1.6.0.0

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

נוצר ונבדק בעזרת:

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

גרסה 1.5.8.0

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

נוצר ונבדק בעזרת:

• גרסה 8.7.0 של Google Mobile Ads SDK.
• Maio SDK גרסה 1.5.8.
• MaioOB SDK בגרסה 2.0.0-אלפא.

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

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

נוצר ונבדק בעזרת:

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

גרסה 1.5.5.0

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

נוצר ונבדק בעזרת:

• גרסה 7.64.0 של Google Mobile Ads SDK.
• 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 הוסרה.

נוצר ונבדק בעזרת:

• גרסה 7.58.0 של Google Mobile Ads SDK.
• 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:.

נוצר ונבדק בעזרת:

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

גרסה 1.5.2.0

• תאימות מאומתת עם maio SDK גרסה 1.5.2.

נוצר ונבדק בעזרת:

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

גרסה 1.5.1.0

• תאימות מאומתת עם maio SDK גרסה 1.5.1.

נוצר ונבדק בעזרת:

• גרסה 7.52.0 של Google Mobile Ads SDK.
• 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

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