במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-InMobi באמצעות תהליך בחירת הרשת (Mediation), תוך שימוש בשילובים של Waterfall ושל בידינג. נסביר איך להוסיף את InMobi לתצורת הגישור של יחידת מודעות, ואיך לשלב את InMobi SDK ואת המתאם באפליקציה Flutter .
שילובים נתמכים ופורמטים נתמכים של מודעות
שילוב | |
---|---|
בידינג | 1 |
מפל | |
פורמטים | |
כרזה | |
פרסומת מרווח ביניים | |
ההטבה הופעלה | |
מותאם | 2 |
1 השילוב של תכונת הבידינג נמצא בגרסת בטא סגורה. צריך לפנות למנהל החשבון ולבקש גישה.
2 נתמכת רק בתהליך בחירת הרשת (Mediation) ב-Waterfall.
דרישות
- ה-SDK העדכני של מודעות Google לנייד
- Flutter 3.7.0 ואילך
- כדי לפרוס ב-Android
- Android API ברמת 21 ואילך
- כדי לפרוס ב-iOS
- יעד פריסת iOS של 10.0 ומעלה
- פרויקט Flutter עבודה שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה
שלב 1: הגדרת הגדרות בממשק המשתמש של InMobi
נרשמים לחשבון InMobi.
בידינג
בוחרים באפשרות Use InMobi SSP with Google Open Bidding (שימוש ב-InMobi SSP with Google Open Bidding) ומזינים את מזהה בעל התוכן הדיגיטלי ב-Google.
מפל
לא נדרש שלב נוסף כדי לשלב Waterfall.
לאחר האימות, מתחברים לחשבון InMobi.
הוספת אפליקציה
כדי להוסיף את האפליקציה למרכז הבקרה של InMobi, לוחצים על מלאי > הגדרות מלאי.
לחץ על הוספת מלאי ובחר בערוץ האפליקציה לנייד מהתפריט הנפתח.
מתחילים להקליד את כתובת ה-URL של חנות האפליקציות שפרסמתם בסרגל החיפוש, ובוחרים את האפליקציה מתוך התוצאות שמופיעות. לוחצים על Continue (המשך).
אם האפליקציה לא פורסמה, לוחצים על Link manually (קישור ידני) ומזינים את הפרטים הנדרשים. לוחצים על Continue (המשך).
בודקים את ההגדרות של App &Website Compliance ולוחצים על שמירה ויצירה של מיקומי מודעות.
מיקומי מודעות
אחרי שמגדירים את המלאי, המערכת מפנה אתכם לתהליך העבודה של יצירת מיקומי מודעות.
בידינג
בוחרים את הסוג של יחידת המודעות. מזינים שם מיקום, בוחרים את האפשרויות On ו-Google Open Bidding עבור Audience Bidding ו-Partner בהתאמה, וממלאים את שאר הטופס. בסיום, לוחצים על Create Placement.
מפל
בוחרים את הסוג של יחידת המודעות. מזינים שם מיקום, בוחרים באפשרות השבתה עבור בידינג על הקהל וממלאים את שאר הטופס. בסיום, לוחצים על Create Placement.
לאחר יצירת מיקום המודעה, הפרטים שלו מוצגים. חשוב לזכור את מזהה מיקום המודעה, שישמש להגדרת יחידת המודעותAdMob .
מספר חשבון
מזהה חשבון InMobi שלך זמין בקטע פיננסים > הגדרות תשלום > פרטי תשלום.
איתור מפתח של InMobi Reporting API
בידינג
לא צריך לבצע את השלב הזה בשילובי בידינג.
מפל
עוברים אל החשבון שלי > הגדרות חשבון. מנווטים לכרטיסייה API Key ולוחצים על Generate API Key.
בוחרים את כתובת האימייל של המשתמש שעבורו המפתח נדרש, ולוחצים על Generate API Key. ייווצר קובץ שמכיל את מפתח ה-API ואת שם המשתמש או שם ההתחברות.
רק האדמין של בעל האפליקציה בחשבון יוכל ליצור מפתח API לכל המשתמשים. אם שכחתם את מפתח ה-API שנוצר בעבר, תוכלו לאפס את מפתח ה-API על ידי העברת העכבר מעל כתובת האימייל שלכם בכרטיסייה API Key.
הפעלת מצב בדיקה
הפעילו את מצב הבדיקה עבור המיקום בכל החשיפות בזמן אמת או רק במכשירי בדיקה מסוימים.
שלב 2: הגדרת ביקוש ב-InMobi AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה של InMobi לרשימת שותפי הפרסום של תקנות GDPR ותקנות במדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את InMobi לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-SDK ואת המתאם של InMobi
שילוב דרך pub.dev
מוסיפים את יחסי התלות הבאים עם הגרסאות העדכניות שלInMobi ה-SDK והמתאם בקובץ pubspec.yaml
של החבילה:
dependencies:
gma_mediation_inmobi: ^1.0.0
שילוב ידני
הורד את הגרסה האחרונה של פלאגין הגישור של Google Mobile Ads עבור InMobi, מחלצים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter שלכם. לאחר מכן, מוסיפים את התלות הבאה לפלאגין בקובץ pubspec.yaml
:
dependencies:
gma_mediation_inmobi:
path: path/to/local/package
שלב 4: מטמיעים את הגדרות הפרטיות ב-InMobi SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לוודא שהודעות גילוי נאות מסוימות נמסרות למשתמשים באזור הכלכלי האירופי (EEA) בנוגע לשימוש במזהי מכשירים ובמידע אישי, ושהם מקובלים עליכם. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת לבחירת הרשת שעשויה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה Google לא יכולה להעביר את בחירת המשתמש לגבי הסכמה לרשתות כאלה באופן אוטומטי.
הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads ל-InMobi לא תומך בהעברת פרטי הסכמה ל-InMobi SDK.
חוקי הפרטיות במדינות בארה"ב
חוקי פרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת הרשת. לכן, צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשוית להשתתף במכירה של מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שהן עומדות בדרישות.
הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads ל-InMobi לא תומך בהעברת פרטי הסכמה ל-InMobi SDK.
שלב 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 | שגיאות InMobi SDK. לפרטים נוספים, ראו קוד. |
100 | הפרמטרים של שרת InMobi שהוגדרו AdMob בממשק המשתמש חסרים/לא חוקיים. |
101 | אתחול ה-SDK של InMobi נכשל. |
102 | גודל המודעה המבוקש אינו תואם גודל מודעת באנר הנתמך על ידי InMobi. |
103 | בקשה להצגת מודעה אינה בקשה מאוחדת להצגת מודעה מותאמת. |
104 | ניסית לבקש מודעת InMobi בלי להפעיל את InMobi SDK. בתיאוריה, זה לא אמור לקרות, כי המתאם מפעיל את 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
1.0.0
- גרסה ראשונית.
- תאימות מאומתת עם מתאם InMobi Android גרסה 10.6.7.1.
- תאימות מאומתת עם מתאם InMobi iOS בגרסה 10.7.2.0.
- התוסף נוצר ונבדק עם Google Mobile Ads Flutter גרסה 5.1.0.