במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Mintegral באמצעות תהליך בחירת הרשת (Mediation), שמכסה גם שילובים של Waterfall וגם של בידינג. נסביר איך להוסיף את Mintegral להגדרה של תהליך בחירת הרשת (Mediation) ביחידת מודעות, ואיך לשלב את ה-SDK והמתאם של Mintegral באפליקציית Unity.
שילובים נתמכים ופורמטים נתמכים של מודעות
המתאם של AdMob תהליך בחירת הרשת ב-Mintegral כולל את היכולות הבאות:
שילוב | ||
---|---|---|
בידינג | 1 | |
מפל | 2 | |
פורמטים | ||
מודעות בפתיחת האפליקציה | 1 2 | |
כרזה | ||
פרסומת מרווח ביניים | ||
ההטבה הופעלה | ||
מודעת מעברון מתגמלת |
2 שילוב הבידינג של הפורמט הזה הוא בגרסת בטא סגורה.
דרישות
- Unity 5.6 ואילך
- ה-SDK העדכני של מודעות Google לנייד
- כדי לפרוס ב-Android
- Android API ברמת 19 ואילך
- כדי לפרוס ב-iOS
- יעד הפריסה של iOS הוא 12.0 ומעלה
- פרויקט Unity פועל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- משלימים את ההוראות של תהליך בחירת הרשת (Mediation) המדריך לתחילת העבודה
שלב 1: הגדרת הגדרות בממשק המשתמש של Mintegral
נרשמים או מתחברים לחשבון Mintegral.
איתור מפתח האפליקציה
עוברים לכרטיסייה הגדרות אפליקציה ורושמים את מפתח האפליקציה.
הוספת אפליקציה חדשה
בכרטיסייה הגדרות אפליקציה, לוחצים על הלחצן הוספת אפליקציה.
בוחרים את הפלטפורמה וממלאים את שאר הטופס. לאחר מכן לוחצים על שמירה.
Android
iOS
חשוב לרשום את מזהה האפליקציה של האפליקציה.
Android
iOS
יצירת מיקום מודעה
אחרי שיוצרים את האפליקציה, נכנסים לכרטיסייה Locations & Units (מיקומי מודעות ויחידות מידה) ולוחצים על Add Placement (הוספת מיקום) כפי שמוצג בהמשך כדי ליצור את מיקום המודעה.
Android
iOS
מזינים שם מיקום ופורמט מודעה.
בידינג
בוחרים באפשרות header Bidding בתור סוג הבידינג. ממלאים את שאר הפרטים בטופס ולוחצים על Save.
מפל
בוחרים באפשרות מסורתית בתור סוג הבידינג. ממלאים את שאר הטופס ולוחצים על Save.
אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה המיקום.
Android
iOS
לוחצים על התפריט הנפתח יחידת מודעות אחת ורושמים את מזהה יחידת המודעות.
Android
iOS
איתור מפתח ה-API של Mintegral Reporting
בידינג
לא צריך לבצע את השלב הזה בשילובי בידינג.
מפל
כדי להגדיר את AdMob מזהה יחידת המודעות, תצטרכו את מפתח Mintegral Reporting API. עוברים אל Account (חשבון) > API Tools (כלים ל-API). רשמו לעצמכם את המפתח והסוד שלכם.
שלב 2: הגדרת ביקוש ל-Mintegral AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה של Mintegral לרשימת שותפי הפרסום של תקנות GDPR ותקנות במדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Mintegral לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-SDK והמתאם של Mintegral
מורידים את הגרסה האחרונה של הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads עבור Mintegral דרך קישור ההורדה ב-Changelog, ומחלצים את GoogleMobileAdsMintegralMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקטים ב-Unity, בוחרים באפשרות Assets > Import Package >Custom
Package (נכסים) ומוצאים את הקובץ GoogleMobileAdsMintegralMediation.unitypackage
שהורדת. מוודאים שכל הקבצים מסומנים ולוחצים על Import.
לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force
resolve. ספריית Unity Play Services Solutionr תבצע פתרון בעיות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 4: מוסיפים את קוד החובה
Android
לא נדרש קוד נוסף כדי לשלב את Mintegral.
iOS
שילוב של SKAdNetwork
פועלים לפי חומרי העזר של Mintegral כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob
רוצה להציג מודעות בדיקה של Mintegral למודעות באנר, מעברונים, מודעות מתגמלות ומודעות מותאמות? ההמלצה של Mintegral היא להשתמש במפתחות האפליקציות, במזהי האפליקציות, במזהי המיקומים ובמזהי יחידות המודעות שצוינו הדף של מזהה בדיקת Mintegral.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-Mintegral, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Mintegral (Bidding) and Mintegral (Waterfall) מקורות המודעות.
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-Mintegral, בעלי אפליקציות יכולים לבדוק מה השגיאה הבסיסית מתגובת המודעה באמצעות ResponseInfo
במחלקות הבאות:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
ריכזנו כאן את הקודים וההודעות הנלוות שהתקבלו ממתאם Mintegral כשטעינת מודעה נכשלת:
Android
קוד שגיאה | דומיין | סיבה |
---|---|---|
101 | com.google.ads.mediation.mintegral | פרמטרים לא חוקיים של השרת (למשל, מזהה אפליקציה או מזהה מיקום חסרים). |
102 | com.google.ads.mediation.mintegral | גודל המודעה המבוקש לא תואם לגודל מודעת באנר שנתמך על ידי Mintegral. |
103 | com.google.ads.mediation.mintegral | תגובה חסרה או לא חוקית להצעת מחיר. |
104 | com.google.ads.mediation.mintegral | ה-SDK של Mintegral החזיר שגיאת 'לא מולאה'. |
iOS
קוד שגיאה | דומיין | סיבה |
---|---|---|
101 | com.google.mediation.mintegral | פרמטרים לא חוקיים של השרת (למשל, מזהה אפליקציה או מזהה מיקום חסרים). |
102 | com.google.mediation.mintegral | ה-SDK של Mintegral החזיר שגיאת 'לא מולאה'. |
103 | com.google.mediation.mintegral | הצגת המודעה של Mintegral SDK נכשלה. |
104 | com.google.mediation.mintegral | גודל המודעה המבוקש לא תואם לגודל מודעת באנר שנתמך על ידי Mintegral. |
יומן שינויים של הפלאגין של Mintegral Unity
גרסה 1.4.0
- יש תמיכה במתאם ל-Android בגרסה 16.6.34.0.
- יש תמיכה במתאם Mintegral ל-iOS בגרסה 7.5.6.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.7.0.
גרסה 1.3.0
- יש תמיכה במתאם ל-Android בגרסה 16.5.91.0.
- יש תמיכה במתאם Mintegral ל-iOS בגרסה 7.5.3.0.
- נוספו למחלקה
Mintegral
את השיטות הבאות:SetConsentStatus(bool)
SetDoNotTrackStatus(bool)
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.6.0.
גרסה 1.2.1
- יש תמיכה במתאם Mintegral ל-Android בגרסה 16.4.61.0.
- יש תמיכה במתאם Mintegral ל-iOS בגרסה 7.3.8.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.3.0.
גרסה 1.2.0
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/Mintegral/
. - יש תמיכה במתאם Mintegral ל-Android בגרסה 16.4.41.0.
- יש תמיכה במתאם Mintegral ל-iOS בגרסה 7.3.6.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.3.0.
גרסה 1.1.0
- יש תמיכה במתאם Mintegral ל-Android בגרסה 16.3.61.0.
- יש תמיכה במתאם Mintegral ל-iOS בגרסה 7.2.9.1.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.4.1.
גרסה 1.0.0
- השקה ראשונית!
- יש תמיכה במתאם ל-Android בגרסה 16.2.61.0.
- יש תמיכה במתאם Mintegral ל-iOS בגרסה 7.2.6.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.3.1.