במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Mintegral באמצעות תהליך בחירת הרשת, תוך התייחסות לשילובים של רשימת הרשתות ולשילוב של בידינג. במדריך מוסבר איך להוסיף את Mintegral להגדרות של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של Mintegral באפליקציה של Unity.
השילובים והפורמטים של המודעות הנתמכים
למתאם בחירת הרשת של AdMob ל-Mintegral יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
מודעות בפתיחת האפליקציה | 1 |
מודעת באנר | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות |
1 שילובי בידינג ו-Waterfall לפורמט מודעות בפתיחת אפליקציה נמצאים בגרסת בטא סגורה.
דרישות
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- Unity מגרסה 5.6 ואילך
- [לבידינג]: כדי לשלב את כל הפורמטים הנתמכים של המודעות בבידינג, צריך להשתמש בפלאגין של Google Mobile Ads לבחירת הרשת ב-Mintegral בגרסה 1.4.0 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)
- כדי לפרוס ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט פעיל ב-Unity שמוגדר בו Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת השימוש.
- מדריך לתחילת העבודה בנושא בחירת הרשת
שלב 1: הגדרת ההגדרות בממשק המשתמש של Mintegral
נרשמים או נכנסים לחשבון Mintegral.
איתור מפתח האפליקציה
עוברים לכרטיסייה APP Setting ומתעדים את APP Key.
הוספת אפליקציה חדשה
בכרטיסייה APP Setting, לוחצים על הלחצן Add APP.
בוחרים את הפלטפורמה וממלאים את שאר הטופס. לאחר מכן לוחצים על שמירה.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/new_application_Android.png?authuser=0000&hl=he)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/new_application_iOS.png?authuser=0000&hl=he)
שימו לב למזהה האפליקציה.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/app_id_Android.png?authuser=0000&hl=he)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/app_id_iOS.png?authuser=0000&hl=he)
יצירת מיקום מודעה
אחרי שיוצרים את הבקשה, עוברים לכרטיסייה Placements & Units ולוחצים על הלחצן Add Placement (הוספת מיקום מודעה), כפי שמוצג בהמשך, כדי ליצור את מיקום המודעה.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/create_placement_Android.png?authuser=0000&hl=he)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/create_placement_iOS.png?authuser=0000&hl=he)
מזינים שם מיקום מודעה ופורמט מודעה.
בוחרים באפשרות בידינג בכותרות בתור סוג הבידינג. ממלאים את שאר הטופס ולוחצים על שמירה.
בוחרים באפשרות Traditional בתור Bidding Type. ממלאים את שאר הפרטים בטופס ולוחצים על שמירה.
אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה המיקום.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=0000&hl=he)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/ad_placement_id_iOS.png?authuser=0000&hl=he)
לוחצים על התפריט הנפתח 1 AD Units ומתעדים את מזהה יחידת המודעות.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=0000&hl=he)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/add_ad_unit_id_iOS.png?authuser=0000&hl=he)
איתור מפתח ה-Reporting API של Mintegral
השלב הזה לא נדרש לשילובי בידינג.
כדי להגדיר את מזהה יחידת המודעות ב-AdMob, תצטרכו את מפתח ה-API לדיווח של Mintegral. עוברים אל Account (חשבון) > API Tools (כלים ל-API). שימו לב ל-Skey ול-Secret.
שלב 2: הגדרת הביקוש מ-Mintegral בממשק המשתמש של AdMob
הגדרת הגדרות בחירת הרשת ליחידת המודעות
להוראות, אפשר לעיין בשלב 2 במדריך ל-Android.
להוראות, אפשר לעיין בשלב 2 במדריך ל-iOS.
הוספת Mobvista/Mintegral לרשימה של שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות ארה"ב
פועלים לפי השלבים שמפורטים בקטע הגדרות בנושא תקנות אירופאיות ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את Mobvista/Mintegral לרשימת שותפי הפרסום שמוגדרים בהתאם לתקנות באיחוד האירופי ובמדינות בארה"ב בממשק המשתמש של AdMob.
שלב 3: מייבאים את ה-SDK ואת המתאם של Mintegral
אם התקנתם את OpenUPM-CLI, תוכלו להתקין את הפלאגין של Mintegral לתהליך בחירת הרשת (Mediation) של Google Mobile Ads ל-Unity בפרויקט שלכם. לשם כך, מריצים את הפקודה הבאה מהספרייה ברמה הבסיסית (root) של הפרויקט:
openupm add com.google.ads.mobile.mediation.mintegral
בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את הגדרות מנהל החבילות של Unity.
בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר שמוגדר לפי היקף עם הפרטים הבאים:
- שם:
OpenUPM
- כתובת אתר:
https://package.openupm.com
- היקפים:
com.google
לאחר מכן, עוברים אל Window > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries בתפריט הנפתח.
בוחרים בחבילה Google Mobile Ads Mintegral Mediation ולוחצים על Install.
מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת הרשת (Mediation) עבור Mintegral מהקישור להורדה שמופיע בChangelog ומחלצים את הקובץ GoogleMobileAdsMintegralMediation.unitypackage
מקובץ ה-zip.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > Import Package > Custom Package ומאתרים את הקובץ GoogleMobileAdsMintegralMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.
לאחר מכן בוחרים באפשרות נכסים > מנהל יחסי תלות חיצוניים > Android Resolver > Force Resolve. ספריית External Dependency Manager תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות שהוצהרו לתיקייה Assets/Plugins/Android
באפליקציה שלכם ב-Unity.
שלב 4: מוסיפים את הקוד הנדרש
לא נדרש קוד נוסף לשילוב עם Mintegral.
שילוב עם SKAdNetwork
פועלים לפי המסמכים של Mintegral כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בדיקה מעשית של ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-AdMob.
כדי לקבל מודעות בדיקה של Mintegral בפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות, מומלץ להשתמש במפתחות האפליקציה, במזהי האפליקציות, במזהי המיקומים ובמזהי יחידות המודעות שמופיעים בדף המזהים לבדיקה של Mintegral.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-Mintegral, מפעילים בדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות Mintegral (Bidding) ו-Mintegral (Waterfall).
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-Mintegral, בעלי התוכן הדיגיטלי יכולים לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות ResponseInfo
בקטגוריות הבאות:
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
GADMediationAdapterMintegral
אלה הקודים וההודעות הנלוות שמתקבלים מהמתאם של Mintegral כשלא ניתן לטעון מודעה:
קוד שגיאה | דומיין | סיבה |
---|---|---|
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 החזיר שגיאת 'לא מולאה'. |
קוד שגיאה | דומיין | סיבה |
---|---|---|
101 | com.google.mediation.mintegral | פרמטרים לא חוקיים של שרת (למשל, חסר מזהה אפליקציה או מזהה מיקום מודעה). |
102 | com.google.mediation.mintegral | ה-SDK של Mintegral החזיר שגיאת 'לא מולאה'. |
103 | com.google.mediation.mintegral | ה-SDK של Mintegral נכשל בהצגת מודעה. |
104 | com.google.mediation.mintegral | גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-Mintegral. |
יומן השינויים של פלאגין תהליך בחירת הרשת (Mediation) של Mintegral ל-Unity
גרסה 1.8.3
- תמיכה במתאם Mintegral ל-Android בגרסה 16.8.61.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.7.3.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.3.0.
גרסה 1.8.2
- תמיכה במתאם Mintegral ל-Android בגרסה 16.8.61.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.7.2.1.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.1.
גרסה 1.8.1
- תמיכה במתאם Mintegral ל-Android מגרסה 16.8.51.0.
- תמיכה במתאם Mintegral ל-iOS מגרסה 7.7.2.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.0.
גרסה 1.8.0
- התמיכה כוללת את מתאם Android של Mintegral בגרסה 16.8.31.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.7.0.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.0.
גרסה 1.7.0
- השם של
DummyClient
השתנה ל-PlaceholderClient
. - תמיכה במתאם Android של Mintegral בגרסה 16.8.11.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.6.9.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.0.
גרסה 1.6.5
- התמיכה כוללת את מתאם Android של Mintegral בגרסה 16.7.81.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.6.8.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.0.
גרסה 1.6.4
- התמיכה כוללת את מתאם Android של Mintegral בגרסה 16.7.61.0.
- התמיכה כוללת את מתאם Mintegral ל-iOS בגרסה 7.6.7.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.
גרסה 1.6.3
- התמיכה כוללת את מתאם Android של Mintegral בגרסה 16.7.41.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.6.6.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.
גרסה 1.6.2
- התמיכה כוללת את מתאם Android של Mintegral בגרסה 16.7.41.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.6.4.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.
גרסה 1.6.1
- תמיכה במתאם Android של Mintegral בגרסה 16.7.21.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.6.3.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.
גרסה 1.6.0
- תמיכה במתאם Android של Mintegral בגרסה 16.7.11.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.6.2.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.0.0.
גרסה 1.5.0
- תמיכה במתאם Mintegral ל-Android מגרסה 16.6.71.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.6.0.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.0.0.
גרסה 1.4.0
- התמיכה כוללת את מתאם Android של Mintegral בגרסה 16.6.34.0.
- תמיכה במתאם Mintegral ל-iOS מגרסה 7.5.6.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.7.0.
גרסה 1.3.0
- תמיכה במתאם Mintegral ל-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
- התמיכה כוללת את מתאם Android של Mintegral בגרסה 16.3.61.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.2.9.1.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.4.1.
גרסה 1.0.0
- הגרסה הראשונית!
- התכונה תומכת במתאם Mintegral ל-Android בגרסה 16.2.61.0.
- תמיכה במתאם Mintegral ל-iOS בגרסה 7.2.6.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.3.1.