במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Moloco באמצעות גישור, כולל שילובים של בידינג. המאמר כולל הסבר על הוספת Moloco להגדרת הגישור של יחידת מודעות, ועל שילוב של Moloco SDK ומתאם באפליקציית Flutter.
שילובים נתמכים ופורמטים נתמכים של מודעות
מתאם בחירת הרשת (Mediation) של AdMob ל-Moloco כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| מפל | |
| פורמטים | |
| מודעה בפתיחת אפליקציה | |
| מודעת באנר | |
| מעברון | |
| ההטבה הופעלה | |
| מודעות מעברון מתגמלות | |
| מותאם | |
דרישות
- הגרסה העדכנית של Google Mobile Ads SDK
- Flutter 3.7.0 ומעלה
- כדי לפרוס ב-Android
- רמת API 23 ואילך ב-Android
- כדי לפרוס ב-iOS
- יעד הפריסה של iOS הוא 12.0 ומעלה
- פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה עם Service Management API.
- השלמת תהליך הגישור מדריך לתחילת העבודה
שלב 1: הגדרת תצורות בממשק המשתמש של Moloco
מתחברים ל-Moloco Publisher Portal.
עוברים לכרטיסייה אפליקציות בדף סקירה כללית ולוחצים על הלחצן הוספת אפליקציה כדי ליצור אפליקציה חדשה.
בוחרים את מערכת ההפעלה והגדרות הפרטיות של האפליקציה, ממלאים את שאר הפרטים בטופס ולוחצים על יצירה.
Android
iOS
אחרי שיוצרים את האפליקציה, בוחרים אותה בכרטיסייה Apps כדי לראות את הפרטים שלה ורושמים את App Key.
Android
iOS
עוברים לכרטיסייה סקירה כללית > יחידות מודעות, בוחרים את האפליקציה מהתפריט הנפתח ולוחצים על יחידת מודעות חדשה.
בוחרים באפשרות בידינג באפליקציה בתור שיטת המכרז וממלאים את שאר הפרטים בטופס. לאחר מכן, לוחצים על יצירה.
עוברים ליחידת המודעות החדשה בכרטיסייה יחידות של מודעות כדי לראות את הפרטים שלה. חשוב לשים לב למזהה יחידת המודעות.
שלב 2: הגדרת הביקוש של Moloco בממשק המשתמש של AdMob
הגדרת הגדרות הגישור ליחידת המודעות
Android
הוראות מפורטות מופיעות בשלב 2 במדריך ל-Android.
iOS
הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.
הוספה של Moloco Ads לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב
כדי להוסיף את Moloco Ads לרשימת שותפי הפרסום שמספקים שירותים שקשורים לתקנות האירופאיות ולתקנות במדינות בארה"ב בממשק המשתמש של AdMob, צריך לפעול לפי השלבים שמפורטים במאמרים בנושא הגדרות שקשורות לתקנות האירופאיות והגדרות שקשורות לתקנות במדינות בארה"ב.
שלב 3: מייבאים את ה-SDK והמתאם של Moloco
שילוב דרך pub.dev
מוסיפים את התלות הבאה עם הגרסאות האחרונות של Moloco Ads SDK ומתאם בpubspec.yaml של החבילה:
dependencies:
gma_mediation_moloco: ^
שילוב ידני
מורידים את הגרסה העדכנית של פלאגין הגישור של Google Mobile Ads עבור Moloco Ads SDK, מחלצים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את התלות הבאה לקובץ pubspec.yaml כדי להפנות אל הפלאגין:
dependencies:
gma_mediation_moloco:
path: path/to/local/package
שלב 4: מוסיפים את הקוד הנדרש
לא נדרש קוד נוסף לשילוב עם Moloco.
שלב 5: בדיקת ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-AdMob.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-Moloco Ads SDK, אתם צריכים להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Moloco (Bidding).
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-Moloco, בעלי התוכן הדיגיטלי יכולים לבדוק את השגיאה הבסיסית בתגובה למודעה באמצעות ResponseInfo במחלקות הבאות:
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
אלה הקודים וההודעות הנלוות שמוחזרים על ידי מתאם Moloco כשטעינת מודעה נכשלת:
Android
| קוד שגיאה | דומיין | סיבה |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | מפתח האפליקציה של Moloco חסר או לא תקין. |
| 102 | com.google.ads.mediation.moloco | מזהה יחידת המודעות של Moloco חסר או לא תקין. |
| 103 | com.google.ads.mediation.moloco | אובייקט המודעה של Moloco שהוחזר היה null. |
| -1 עד 5000 | com.moloco.sdk | ה-SDK של Moloco החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Moloco. |
iOS
| קוד שגיאה | דומיין | סיבה |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Moloco SDK לא תומך בהצגת מודעות ב-iOS 12 ובגרסאות קודמות. |
| 102 | com.google.ads.mediation.moloco | מפתח האפליקציה של Moloco חסר או לא תקין. |
| 103 | com.google.ads.mediation.moloco | מזהה יחידת המודעות של Moloco חסר או לא תקין. |
| 104 | com.google.ads.mediation.moloco | המודעה לא מוכנה להצגה. |
| 105 | com.google.ads.mediation.moloco | המודעה לא הוצגה. |
| 106 | com.google.ads.mediation.moloco | נתוני הרינדור לא זמינים כדי לרנדר את המודעה. |
| -1 עד 5000 | נשלחה על ידי Moloco SDK | ה-SDK של Moloco החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Moloco. |
אימות בצד השרת של מודעות מתגמלות
אם מאמתים קריאות חוזרות (callback) של אימות בצד השרת (SSV), מזהה מקור המודעה של Moloco הוא 8267622065755668722.
יומן השינויים של Moloco Flutter Mediation Adapter
גרסה 1.6.1 (במהלך פיתוח)
גרסה 1.6.0 (בתהליך)
גרסה 1.5.0
- תמיכה בגרסה 3.11.0.0 של מתאם Moloco Android.
- תמיכה ב-Moloco iOS adapter version 3.11.0.0.
- התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.
גרסה 1.4.0
- תמיכה ב-Moloco Android adapter version 3.10.0.0.
- תמיכה ב-Moloco iOS adapter version 3.10.0.0.
- התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.
גרסה 1.3.1
- תמיכה בגרסה 3.9.0.0 של המתאם Moloco Android.
- תמיכה בגרסה 3.9.1.0 של Moloco iOS adapter.
- התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.
גרסה 1.3.0
- תמיכה בגרסה 3.9.0.0 של המתאם Moloco Android.
- תמיכה ב-Moloco iOS adapter version 3.9.0.0.
- התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.
גרסה 1.2.0
- תמיכה בגרסה 3.8.0.1 של מתאם Moloco ל-Android.
- תמיכה בגרסה 3.8.0.0 של מתאם Moloco iOS.
- התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.
גרסה 1.1.0
- תמיכה ב-Moloco Android adapter version 3.7.0.0.
- תמיכה בגרסה 3.6.0.0 של מתאם Moloco ל-iOS.
- התוסף נוצר ונבדק באמצעות גרסה 5.3.1 של Google Mobile Ads Flutter Plugin.
גרסה 1.0.0
- זו הגרסה הראשונה.
- תמיכה ב-Moloco Android adapter version 3.6.1.0.
- תמיכה בגרסה 3.6.0.0 של מתאם Moloco ל-iOS.
- התוסף נוצר ונבדק באמצעות גרסה 5.3.1 של Google Mobile Ads Flutter Plugin.