במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Mintegral באמצעות תהליך בחירת הרשת (Mediation), שכולל גם שילובים של Waterfall וגם שילובים של בידינג. נסביר איך להוסיף Mintegral בהגדרה של תהליך בחירת הרשת (Mediation) של יחידת מודעות, ואיך לשלב את מתאם ו-SDK של Mintegral באפליקציה Flutter .
השילובים והפורמטים של המודעות שנתמכים
ל AdMob מתאם הגישור של Mintegral יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
מודעות בפתיחת האפליקציה | 1 |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות | |
מותאם | 2 |
1 בידינג ו-Waterfall השילובים של מודעות בפתיחת אפליקציה הם בגרסת בטא סגורה.
2 בידינג ו-Waterfall שילובים לפורמטים של מודעות מותאמות הם בגרסת בטא פתוחה.
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Flutter 3.7.0 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Flutter פועל שהוגדר עם Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: קביעת ההגדרות בממשק המשתמש של Mintegral
נרשמים או מתחברים לחשבון Mintegral.
איתור מפתח האפליקציה
עוברים לכרטיסייה הגדרות אפליקציה ורושמים את מפתח האפליקציה.
הוספת אפליקציה חדשה
בכרטיסייה הגדרות אפליקציה, לוחצים על הלחצן הוספת אפליקציה.
בוחרים את הפלטפורמה וממלאים את שאר הטופס. לאחר מכן לוחצים על שמירה.
Android
![](https://google-developers.gonglchuangl.net/static/admob/images/mediation/mintegral/new_application_Android.png?authuser=0&hl=he)
iOS
![](https://google-developers.gonglchuangl.net/static/admob/images/mediation/mintegral/new_application_iOS.png?authuser=0&hl=he)
חשוב לרשום את מזהה האפליקציה של האפליקציה.
Android
![](https://google-developers.gonglchuangl.net/static/admob/images/mediation/mintegral/app_id_Android.png?authuser=0&hl=he)
iOS
![](https://google-developers.gonglchuangl.net/static/admob/images/mediation/mintegral/app_id_iOS.png?authuser=0&hl=he)
יצירת מיקום מודעה
אחרי שיוצרים את האפליקציה, נכנסים לכרטיסייה Locations & Units (מיקומי מודעות ויחידות מידה) ולוחצים על Add Placement (הוספת מיקום) כפי שמוצג בהמשך כדי ליצור את מיקום המודעה.
Android
![](https://google-developers.gonglchuangl.net/static/admob/images/mediation/mintegral/create_placement_Android.png?authuser=0&hl=he)
iOS
![](https://google-developers.gonglchuangl.net/static/admob/images/mediation/mintegral/create_placement_iOS.png?authuser=0&hl=he)
מזינים שם מיקום ופורמט מודעה.
בידינג
בוחרים באפשרות header Bidding בתור סוג הבידינג. ממלאים את שאר הפרטים בטופס ולוחצים על Save.
מפל
בוחרים באפשרות מסורתית בתור סוג הבידינג. ממלאים את שאר הטופס ולוחצים על Save.
אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה המיקום.
Android
![](https://google-developers.gonglchuangl.net/static/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=0&hl=he)
iOS
![](https://google-developers.gonglchuangl.net/static/admob/images/mediation/mintegral/ad_placement_id_iOS.png?authuser=0&hl=he)
לוחצים על התפריט הנפתח יחידת מודעות אחת ורושמים את מזהה יחידת המודעות.
Android
![](https://google-developers.gonglchuangl.net/static/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=0&hl=he)
iOS
![](https://google-developers.gonglchuangl.net/static/admob/images/mediation/mintegral/add_ad_unit_id_iOS.png?authuser=0&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
שילוב באמצעות pub.dev
צריך להוסיף את התלות הבאה בגרסאות האחרונות של
Mintegral ה-SDK והמתאם בחבילה שלך
קובץ pubspec.yaml
:
dependencies:
gma_mediation_mintegral: ^1.0.0
שילוב ידני
כדאי להוריד את הגרסה האחרונה של הפלאגין לבחירת רשת (Mediation) של Google Ads לנייד עבור
Mintegral
מחלצים את הקובץ שהורד ומוסיפים את תיקיית יישומי הפלאגין שחולצו
(והתוכן שלו) לפרויקט Flutter. לאחר מכן, פונים לפלאגין
pubspec.yaml
על ידי הוספת התלות הבאה:
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
שלב 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. |
יומן שינויים של מתאם ל-Fintegral Flutter Mediation
1.0.0
- גרסה ראשונית.
- תאימות מאומתת למתאם Mintegral של Android בגרסה 16.7.21.0.
- תאימות מאומתת למתאם Mintegral ל-iOS בגרסה 7.6.3.0.
- נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.