במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Mintegral באמצעות תהליך בחירת הרשת, תוך התייחסות לשילובים של רשימת הרשתות ולשילוב של בידינג. במאמר מוסבר איך להוסיף את Mintegral להגדרות של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של Mintegral באפליקציה Flutter .
השילובים והפורמטים של המודעות הנתמכים
Ad Manager מתאם בחירת הרשת של Mintegral כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | 1 |
| מפל | 2 |
| פורמטים | |
| מודעות בפתיחת האפליקציה | |
| מודעת באנר | |
| מעברון | |
| ההטבה הופעלה | |
| מודעות מעברון מתגמלות | |
| מותאם | |
2 השילוב עם Waterfall נמצא בגרסת בטא סגורה.
דרישות
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- Flutter מגרסה 3.7.0 ואילך
- [לבידינג]: כדי לשלב את כל הפורמטים הנתמכים של המודעות בבידינג, צריך להשתמש בפלאגין של Google Mobile Ads לבחירת הרשת ב-Mintegral בגרסה 1.4.0 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)
- כדי לפרוס ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Flutter פעיל שהוגדרה בו ה-Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת השימוש.
- מדריך לתחילת העבודה בנושא בחירת הרשת
שלב 1: הגדרת ההגדרות בממשק המשתמש של Mintegral
נרשמים או נכנסים לחשבון Mintegral.
איתור מפתח האפליקציה
עוברים לכרטיסייה APP Setting ומתעדים את APP Key.
הוספת אפליקציה חדשה
בכרטיסייה APP Setting, לוחצים על הלחצן Add APP.
בוחרים את הפלטפורמה וממלאים את שאר הטופס. לאחר מכן לוחצים על שמירה.
Android
iOS
שימו לב למזהה האפליקציה.
Android
iOS
יצירת מיקום מודעה
אחרי שיוצרים את הבקשה, עוברים לכרטיסייה Placements & Units ולוחצים על הלחצן Add Placement (הוספת מיקום מודעה), כפי שמתואר בהמשך, כדי ליצור את מיקום המודעה.
Android
iOS
מזינים שם מיקום מודעה ופורמט מודעה.
בוחרים באפשרות בידינג בכותרות בתור סוג הבידינג. ממלאים את שאר הטופס ולוחצים על שמירה.
אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה המיקום.
Android
iOS
לוחצים על התפריט הנפתח 1 AD Units ומתעדים את מזהה יחידת המודעות.
Android
iOS
איתור מפתח ה-Reporting API של Mintegral
בידינג
השלב הזה לא נדרש בשילובי בידינג.
מפל
כדי להגדיר את מזהה יחידת המודעות ב-Ad Manager, תצטרכו את מפתח ה-Reporting API של Mintegral. עוברים אל Account (חשבון) > API Tools (כלים ל-API). שימו לב ל-Skey ול-Secret.
שלב 2: הגדרת הביקוש מ-Mintegral בממשק המשתמש Ad Manager
הגדרת הגדרות בחירת הרשת ליחידת המודעות
הוספה של Mintegral לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את Mobvista/Mintegral לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב בממשק המשתמש של Ad Manager.
שלב 3: מייבאים את ה-SDK ואת המתאם של Mintegral
שילוב דרך pub.dev
מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK והמתאם של Mintegral בקובץ pubspec.yaml של החבילה:
dependencies:
gma_mediation_mintegral: ^1.0.0
שילוב ידני
מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור Mintegral, מחלצים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את הפלאגין לקובץ pubspec.yaml באמצעות יחסי התלות הבאים:
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
שלב 4: מוסיפים את הקוד הנדרש
Android
לא נדרש קוד נוסף לשילוב עם Mintegral.
iOS
שילוב עם SKAdNetwork
פועלים לפי המסמכים של Mintegral כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.
שלב 5: בדיקה מעשית של ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-Ad Manager.
כדי לקבל מודעות בדיקה של Mintegral בפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות, מומלץ להשתמש במפתחות האפליקציה, במזהי האפליקציות, במזהי המיקומים ובמזהי יחידות המודעות שמופיעים בדף המזהים לבדיקה של Mintegral.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-Mintegral, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות Mintegral (Bidding) ו-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 | ה-SDK של Mintegral נכשל בהצגת מודעה. |
| 104 | com.google.mediation.mintegral | גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-Mintegral. |
יומן השינויים של מתאם בחירת הרשת של Mintegral ל-Flutter
הגרסה הבאה
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.2.0.
1.1.0
- תאימות מאומתת למתאם Mintegral ל-Android בגרסה 16.8.31.0.
- התאימות אומתה עם מתאם Mintegral ל-iOS בגרסה 7.7.1.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.
1.0.0
- הגרסה הראשונית.
- תאימות מאומתת למתאם Mintegral ל-Android בגרסה 16.7.21.0.
- התאימות אומתה עם מתאם Mintegral ל-iOS בגרסה 7.6.3.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.