במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-InMobi באמצעות תהליך בחירת הרשת (Mediation), שכולל גם שילובים של Waterfall וגם שילובים של בידינג. הוא מסביר איך להוסיף את InMobi ל- הגדרת הגישור של יחידת מודעות, וכיצד לשלב את InMobi SDK את המתאם לאפליקציה Flutter .
השילובים והפורמטים של המודעות שנתמכים
שילוב | |
---|---|
בידינג | 1 |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מותאם | 2 |
1 השילוב של הבידינג נמצא בשלבי סגירה בטא, צריך לפנות למנהל החשבון כדי לבקש גישה.
2 נתמך רק בחשבונות ברשימת הרשתות בתהליך בחירת הרשת.
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Flutter 3.7.0 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 10.0 ואילך
- פרויקט Flutter פעיל שהוגדר ב-Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של InMobi
שלב 2: הגדרת ביקוש ב-InMobi ב- AdMob ממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה InMobi לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
שלב 3: מייבאים את ה-SDK והמתאם של InMobi
שילוב באמצעות pub.dev
צריך להוסיף את התלות הבאה בגרסאות האחרונות של
InMobi ה-SDK והמתאם בחבילה שלך
קובץ pubspec.yaml
:
dependencies:
gma_mediation_inmobi: ^1.0.0
שילוב ידני
מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור InMobi, מנתקים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את הפלאגין לקובץ pubspec.yaml
באמצעות יחסי התלות הבאים:
dependencies:
gma_mediation_inmobi:
path: path/to/local/package
שלב 4: הטמעה של הגדרות הפרטיות ב-InMobi SDK
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection (הגנה על מידע כללי) של האיחוד האירופי התקנה (GDPR). כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שעשויים לאסוף, לקבל או להשתמש במידע אישי מספקים מידע על השימוש בכל רשת. ל-Google אין כרגע אפשרות להעביר את הבחירות של המשתמש בנושא פרטיות לרשתות כאלה באופן אוטומטי.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור InMobi לא תומך בהעברה פרטי הסכמה ל-SDK של InMobi.
חוקי פרטיות במדינות בארה"ב
ארה"ב חוקי הפרטיות במדינות צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור InMobi לא תומך בהעברה פרטי הסכמה ל-SDK של InMobi.
שלב 5: מוסיפים את הקוד הנדרש נוסף
Android
לא נדרש קוד נוסף בשילוב InMobi.
iOS
שילוב של SKAdNetwork
עוקבים אחר הסרטונים של InMobi
תיעוד
כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב InMobi ממשק המשתמש.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-InMobi, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות InMobi (Bidding) and InMobi (Waterfall) מקורות המודעות.
שלבים אופציונליים
Android
הרשאות
לקבלת ביצועים אופטימליים, InMobi ממליץ להוסיף את האפשרויות הבאות
הרשאות לקובץ AndroidManifest.xml
של האפליקציה.
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
יש לכם גם אפשרות להוסיף את ההרשאות האלה
קובץ Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml
.
iOS
אין צורך לבצע פעולות נוספות לשילוב עם iOS.
קודי שגיאה
אם המתאם לא מקבל מודעה מ-InMobi, בעלי האתרים יכולים לבדוק את
לשגיאה בסיסית מהתגובה באמצעות מודעה באמצעות
ResponseInfo
מתחת לקטע
המחלקות הבאות:
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
הנה הקודים וההודעות הנלוות שמתאם InMobi זורק כאשר מודעה לא נטענת:
Android
קוד שגיאה | סיבה |
---|---|
0-99 | שגיאות SDK מסוג InMobi. להצגת הקוד אפשר לקבל פרטים נוספים. |
100 | פרמטרים של שרת InMobi שהוגדרו ב AdMob ממשק המשתמש חסרים/לא חוקיים. |
101 | אתחול ה-SDK של InMobi נכשל. |
102 | גודל המודעה המבוקש אינו תואם לגודל באנר שנתמך ב-InMobi. |
103 | בקשה להצגת מודעה היא לא בקשה מאוחדת למודעות מותאמות. |
104 | בוצע ניסיון לבקש מודעת InMobi בלי לאתחל את ה-SDK של InMobi. הזה אם המתאם לא מאתחל את InMobi SDK, הוא לא אמור לקרות אף פעם לפני הבקשה להצגת מודעות InMobi. |
105 | המודעה של InMobi עדיין אינה מוכנה להצגה. |
106 | InMobi לא הצליח להציג מודעה. |
107 | InMobi החזירה מודעה מותאמת שחסר בה נכס נדרש. |
108 | נכסי התמונות של המודעות המותאמות ב-InMobi מכילים כתובת URL בפורמט שגוי. |
109 | המתאם לא הצליח להוריד את נכסי התמונות של המודעה המותאמת של InMobi. |
iOS
קוד שגיאה | סיבה |
---|---|
101 | פרמטרים של שרת InMobi שהוגדרו ב AdMob ממשק המשתמש חסרים/לא חוקיים. |
102 | מתאם InMobi אינו תומך בפורמט המודעה המבוקש. |
103 | מודעת InMobi כבר נטענה עבור תצורת הרשת הזו. |
אחר | InMobi SDK החזיר שגיאה. אתה יכול לראות עוד פרטים בכתובת IMRequestStatus.h . |
יומן שינויים של מתאם InMobi Flutter Mediation
1.0.0
- גרסה ראשונית.
- תאימות מאומתת למתאם InMobi ל-Android בגרסה 10.6.7.1.
- תאימות מאומתת למתאם InMobi ל-iOS בגרסה 10.7.2.0.
- נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.