במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Moloco באמצעות תהליך בחירת הרשת (Mediation). המדריך כולל הסברים על שילובים של בידינג. המדריך כולל הסבר על הוספת Moloco להגדרת תהליך בחירת הרשת של יחידת מודעות, ועל שילוב של Moloco SDK ומתאם באפליקציית Flutter.
שילובים ופורמטים נתמכים של מודעות
מתאם תהליך הבחירה של רשת מודעות של Moloco ב-Ad Manager כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| Waterfall | |
| פורמטים | |
| מודעה בפתיחת אפליקציה | |
| מודעת באנר | |
| מעברון | |
| מודעה מתגמלת | |
| מודעות מעברון מתגמלות | |
| מותאם | |
דרישות
- הגרסה העדכנית של Google Mobile Ads SDK
- Flutter 3.7.0 ומעלה
- כדי לפרוס ב-Android
- רמת API 23 ומעלה ב-Android
- כדי לפרוס ב-iOS
- יעד פריסה 12.0 ומעלה ב-iOS
- פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads SDK. פרטים נוספים מופיעים במאמר בנושא תחילת העבודה.
- השלמת תהליך הבחירה של רשת מודעות מדריך לתחילת הדרך
שלב 1: הגדרת תצורות בממשק המשתמש של Moloco
מתחברים ל-Moloco Publisher Portal.
עוברים אל סקירה כללית > הכרטיסייה אפליקציות, ואז לוחצים על הכפתור הוספת אפליקציה כדי ליצור אפליקציה חדשה.
בוחרים את מערכת ההפעלה והגדרות הפרטיות של האפליקציה, ממלאים את שאר הפרטים בטופס ולוחצים על יצירה.
Android
iOS
אחרי שיוצרים את האפליקציה, בוחרים אותה בכרטיסייה Apps כדי לראות את הפרטים שלה ורושמים את App Key.
Android
iOS
עוברים לכרטיסייה סקירה כללית > יחידות מודעות, בוחרים את האפליקציה מהתפריט הנפתח ולוחצים על יחידת מודעות חדשה.
בוחרים באפשרות בידינג באפליקציה בתור שיטת המכרז וממלאים את שאר הפרטים בטופס. לאחר מכן, לוחצים על יצירה.
עוברים ליחידת המודעות החדשה שיצרתם בכרטיסייה יחידות של מודעות כדי לראות את הפרטים שלה. חשוב לשים לב למזהה יחידת המודעות.
שלב 2: הגדרת הביקוש של Moloco בממשק המשתמש של Ad Manager
קביעת ההגדרות של תהליך בחירת הרשת ליחידת המודעות
Android
הוראות מפורטות זמינות בשלב 2 במדריך ל-Android.
iOS
הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.
הוספת Moloco Ads לרשימת שותפי הפרסום שפועלים בהתאם ל-GDPR ולתקנות במדינות בארה"ב
כדי להוסיף בממשק המשתמש של Ad Manager את Moloco Ads לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.
שלב 3: מייבאים את ה-SDK והמתאם של Moloco
שילוב דרך pub.dev
מוסיפים את התלות הבאה עם הגרסאות העדכניות של ה-SDK והמתאם של Moloco Ads בקובץ pubspec.yaml של החבילה:
dependencies:
gma_mediation_moloco: ^2.0.0
שילוב ידני
מורידים את הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור Moloco Ads SDK, מחלצים את הקובץ שירד ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט ה-Flutter. לאחר מכן, מוסיפים את התלות הבאה לקובץ pubspec.yaml כדי להפנות אל הפלאגין:
dependencies:
gma_mediation_moloco:
path: path/to/local/package
שלב 4: מוסיפים את הקוד הנדרש
לא נדרש קוד נוסף לשילוב עם Moloco.
שלב 5: בדיקת ההטמעה
הפעלת מודעות בדיקה
חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות לבדיקה מ-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. |
אימות בצד השרת של מודעות מתגמלות
אם מאמתים קריאות חוזרות של אימות בצד השרת (SSV), מזהה מקור המודעה של Moloco הוא 8267622065755668722.
יומן השינויים של המתאם של Moloco מנגנון בחירת הרשת ל-Flutter
גרסה 2.0.0 (בפיתוח)
גרסה 1.6.0
- תמיכה בגרסה 3.12.0.0 של מתאם Moloco ל-Android.
- תמיכה בגרסה 3.12.0.0 של מתאם Moloco ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.5.0
- תמיכה בגרסה 3.11.0.0 של מתאם Moloco ל-Android.
- תמיכה בגרסה 3.11.0.0 של מתאם Moloco ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.4.0
- תמיכה בגרסה 3.10.0.0 של מתאם Moloco ל-Android.
- תמיכה בגרסה 3.10.0.0 של מתאם Moloco ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.3.1
- תמיכה בגרסה 3.9.0.0 של מתאם Moloco ל-Android.
- תמיכה בגרסה 3.9.1.0 של מתאם Moloco ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.3.0
- תמיכה בגרסה 3.9.0.0 של מתאם Moloco ל-Android.
- תמיכה בגרסה 3.9.0.0 של מתאם Moloco ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.2.0
- תמיכה בגרסה 3.8.0.1 של מתאם Moloco ל-Android.
- תמיכה בגרסה 3.8.0.0 של מתאם Moloco ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.1.0
- תמיכה בגרסה 3.7.0.0 של מתאם Moloco ל-Android.
- תמיכה בגרסה 3.6.0.0 של מתאם Moloco ל-iOS.
- נבנה ונבדק עם גרסה 5.3.1 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.0.0
- זו הגרסה הראשונה.
- תמיכה בגרסה 3.6.1.0 של מתאם Moloco ל-Android.
- תמיכה בגרסה 3.6.0.0 של מתאם Moloco ל-iOS.
- נבנה ונבדק עם גרסה 5.3.1 של הפלאגין למודעות לנייד של Google ל-Flutter.