במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Mintegral באמצעות תהליך בחירת הרשת (Mediation), שכולל גם שילובים של Waterfall וגם שילובים של בידינג. נסביר איך להוסיף Mintegral בהגדרה של תהליך בחירת הרשת (Mediation) של יחידת מודעות, ואיך לשלב את מתאם ו-SDK של Mintegral באפליקציה Unity .
השילובים והפורמטים של המודעות שנתמכים
AdMob מתאם הגישור של Mintegral כולל היכולות הבאות:
שילוב | ||
---|---|---|
בידינג | 1 | |
מפל | 2 | |
פורמטים | ||
מודעות בפתיחת האפליקציה | 1 2 | |
כרזה | ||
מעברון | ||
ההטבה הופעלה | ||
מודעות מעברון מתגמלות | ||
מותאם | 1 3 |
1 בידינג השילוב של הפורמט הזה נמצא בגרסת בטא סגורה.
2 מפל השילוב של הפורמט הזה נמצא בגרסת בטא סגורה.
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Unity 5.6 ומעלה
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פועל שהוגדר עם Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של Mintegral
נרשמים או מתחברים לחשבון Mintegral.
איתור מפתח האפליקציה
עוברים לכרטיסייה הגדרות אפליקציה ורושמים את מפתח האפליקציה.
הוספת אפליקציה חדשה
בכרטיסייה הגדרות אפליקציה, לוחצים על הלחצן הוספת אפליקציה.
בוחרים את הפלטפורמה וממלאים את שאר הטופס. לאחר מכן לוחצים על שמירה.
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/new_application_Android.png?authuser=7&hl=he)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/new_application_iOS.png?authuser=7&hl=he)
חשוב לרשום את מזהה האפליקציה של האפליקציה.
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/app_id_Android.png?authuser=7&hl=he)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/app_id_iOS.png?authuser=7&hl=he)
יצירת מיקום מודעה
אחרי שיוצרים את האפליקציה, נכנסים לכרטיסייה Locations & Units (מיקומי מודעות ויחידות מידה) ולוחצים על Add Placement (הוספת מיקום) כפי שמוצג בהמשך כדי ליצור את מיקום המודעה.
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/create_placement_Android.png?authuser=7&hl=he)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/create_placement_iOS.png?authuser=7&hl=he)
מזינים שם מיקום ופורמט מודעה.
בידינג
בוחרים באפשרות header Bidding בתור סוג הבידינג. ממלאים את שאר הפרטים בטופס ולוחצים על Save.
מפל
בוחרים באפשרות מסורתית בתור סוג הבידינג. ממלאים את שאר הטופס ולוחצים על Save.
אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה המיקום.
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=7&hl=he)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/ad_placement_id_iOS.png?authuser=7&hl=he)
לוחצים על התפריט הנפתח יחידת מודעות אחת ורושמים את מזהה יחידת המודעות.
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=7&hl=he)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/add_ad_unit_id_iOS.png?authuser=7&hl=he)
איתור מפתח ה-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 > (נכסים >) ייבוא חבילה > מותאם אישית
Package ומוצאים את GoogleMobileAdsMintegralMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על
ייבוא.
בשלב הבא בוחרים באפשרות נכסים > המקודד של Play Services > מקודד Android > אילוץ
לפתרון הבעיה. ספריית Unity Play Services resolver תבצע תלות
ומעתיקים את יחסי התלות המוצהרים
הספרייה 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 | אירעה שגיאה מסוג 'לא מולאה' ב-Mintegral SDK. |
iOS
קוד שגיאה | דומיין | סיבה |
---|---|---|
101 | com.google.mediation.mintegral | פרמטרים לא חוקיים של השרת (למשל, מזהה אפליקציה חסר או מזהה מיקום מודעה). |
102 | com.google.mediation.mintegral | אירעה שגיאה מסוג 'לא מולאה' ב-Mintegral SDK. |
103 | com.google.mediation.mintegral | המודעה לא הוצגה על ידי Mintegral SDK. |
104 | com.google.mediation.mintegral | גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-Mintegral. |
יומן שינויים בפלאגין של Mintegral Unity Mediation
הגרסה הבאה
- השם של
DummyClient
השתנה. השם החדש הואPlaceholderClient
.
גרסה 1.6.4
- יש תמיכה במתאם Mintegral ל-Android בגרסה 16.7.61.0.
- יש תמיכה במתאם ל-iOS של Mintegral בגרסה 7.6.7.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.6.3
- יש תמיכה במתאם Mintegral ל-Android גרסה 16.7.41.0.
- יש תמיכה במתאם ל-iOS של Mintegral בגרסה 7.6.6.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.6.2
- יש תמיכה במתאם Mintegral ל-Android גרסה 16.7.41.0.
- יש תמיכה במתאם ל-iOS של Mintegral בגרסה 7.6.4.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.6.1
- יש תמיכה במתאם Mintegral ל-Android בגרסה 16.7.21.0.
- יש תמיכה במתאם ל-iOS של Mintegral בגרסה 7.6.3.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.6.0
- יש תמיכה במתאם Mintegral ל-Android גרסה 16.7.11.0.
- יש תמיכה במתאם ל-iOS של Mintegral בגרסה 7.6.2.0.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 1.5.0
- יש תמיכה במתאם Mintegral ל-Android גרסה 16.6.71.0.
- יש תמיכה במתאם ל-iOS של Mintegral בגרסה 7.6.0.0.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 1.4.0
- יש תמיכה במתאם Mintegral ל-Android בגרסה 16.6.34.0.
- יש תמיכה במתאם ל-iOS של Mintegral בגרסה 7.5.6.0.
- נוצר ונבדק באמצעות גרסה 8.7.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.3.0
- יש תמיכה במתאם Mintegral ל-Android בגרסה 16.5.91.0.
- יש תמיכה במתאם ל-iOS של Mintegral בגרסה 7.5.3.0.
- נוספו לכיתה
Mintegral
את השיטות הבאות:SetConsentStatus(bool)
SetDoNotTrackStatus(bool)
- נוצר ונבדק באמצעות גרסה 8.6.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.2.1
- יש תמיכה במתאם Mintegral ל-Android בגרסה 16.4.61.0.
- יש תמיכה במתאם ל-iOS של Mintegral בגרסה 7.3.8.0.
- נוצר ונבדק באמצעות גרסה 8.3.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.2.0
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/Mintegral/
. - יש תמיכה במתאם Mintegral ל-Android בגרסה 16.4.41.0.
- יש תמיכה במתאם ל-iOS של Mintegral בגרסה 7.3.6.0.
- נוצר ונבדק באמצעות גרסה 8.3.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.1.0
- יש תמיכה במתאם Mintegral ל-Android בגרסה 16.3.61.0.
- יש תמיכה במתאם iOS של Mintegral בגרסה 7.2.9.1.
- נוצר ונבדק באמצעות גרסה 7.4.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.0.0
- גרסה ראשונית!
- יש תמיכה במתאם Mintegral ל-Android בגרסה 16.2.61.0.
- יש תמיכה במתאם ל-iOS של Mintegral בגרסה 7.2.6.0.
- נוצר ונבדק באמצעות גרסה 7.3.1 של פלאגין Unity של המודעות לנייד של Google.