במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-InMobi באמצעות תהליך בחירת הרשת, תוך התייחסות לשילובים של רשימת הרשתות ולשילוב של הבידינג. במאמר מוסבר איך להוסיף את InMobi להגדרות של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של InMobi באפליקציה Flutter .
השילובים והפורמטים של המודעות הנתמכים
שילוב | |
---|---|
בידינג | 1 |
מפל | |
פורמטים | |
מודעת באנר | |
מעברון | |
ההטבה הופעלה | |
מותאם | 2 |
1 השילוב של הבידינג נמצא בגרסת בטא פתוחה.
2 התכונה נתמכת רק בתהליך בחירת רשת (Mediation) מסוג רשימת רשתות.
דרישות
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- Flutter מגרסה 3.7.0 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS בגרסה 10.0 ואילך
- פרויקט Flutter פועל שהוגדרה בו Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת השימוש.
- מדריך לתחילת העבודה בנושא בחירת הרשת
שלב 1: הגדרת ההגדרות בממשק המשתמש של InMobi
נרשמים לחשבון InMobi. כשיוצרים חשבון, משאירים את התיבה שימוש ב-InMobi SSP עם Google Open Bidding לא מסומנת.
אחרי שהחשבון יאומת, נכנסים אליו.
הוספת אפליקציה
כדי להוסיף את האפליקציה ללוח הבקרה של InMobi, לוחצים על מלאי שטחי פרסום > הגדרות מלאי שטחי הפרסום.
לוחצים על הוספת מלאי שטחי פרסום ובוחרים את הערוץ אפליקציה לנייד בתפריט הנפתח.
מתחילים להקליד את כתובת ה-URL של האפליקציה שפורסמה בחנות בסרגל החיפוש, ובוחרים באפליקציה מתוך התוצאות שמופיעות. לוחצים על המשך.
אם האפליקציה לא פורסמה, לוחצים על קישור ידני ומזינים את הפרטים הנדרשים. לוחצים על המשך.
בודקים את ההגדרות של תאימות לאפליקציות ולאתרים ולוחצים על שמירה ויצירת מיקומי מודעות.
מיקומי מודעות
אחרי שתגדירו את מלאי שטחי הפרסום, המערכת תפנה אתכם לתהליך העבודה ליצירת מיקומי מודעות.
בידינג
בוחרים את סוג יחידת המודעות. מזינים שם מיקום מודעה, בוחרים באפשרות מופעל ובאפשרות Google Open Bidding עבור בידינג לפי קהל ושותף, בהתאמה, וממלאים את שאר הטופס. בסיום, לוחצים על יצירת מיקום מודעה.
מפל
בוחרים את סוג יחידת המודעות. לאחר מכן מזינים שם מיקום, בוחרים באפשרות מושבת עבור בידינג לפי קהל וממלאים את שאר הטופס. בסיום, לוחצים על יצירת מיקום מודעה.
אחרי יצירת מיקום המודעות, הפרטים שלו יוצגו. שימו לב למזהה המיקום, שמשמש להגדרת יחידת המודעות ב-AdMob.
מספר חשבון
מספר החשבון ב-InMobi זמין בקטע Finance > Payment Settings > Payment Information.
איתור מפתח API לדיווח של InMobi
בידינג
השלב הזה לא נדרש בשילובי בידינג.
מפל
עוברים אל החשבון שלי > הגדרות החשבון. עוברים לכרטיסייה API Key ולוחצים על Generate API Key.
בוחרים את כתובת האימייל של המשתמש שעבורו נדרש המפתח ולוחצים על יצירת מפתח API. ייווצר קובץ שמכיל את מפתח ה-API ואת שם המשתמש/שם הכניסה.
רק האדמין של בעל התוכן הדיגיטלי בחשבון יוכל ליצור מפתח API לכל המשתמשים. אם שכחתם את מפתח ה-API שיצרתם בעבר, תוכלו לאפס אותו על ידי החזקת העכבר מעל האימייל בכרטיסייה מפתח API.
הפעלת מצב בדיקה
מפעילים את מצב הבדיקה של מיקום המודעה בכל החשיפות הפעילות או רק במכשירי בדיקה מסוימים.
שלב 2: הגדרת הביקוש מ-InMobi בממשק המשתמש של AdMob
הגדרת הגדרות בחירת הרשת ליחידת המודעות
הוספה של InMobi לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב
פועלים לפי השלבים שמפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את InMobi לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב בממשק המשתמש של AdMob.
שלב 3: מייבאים את ה-SDK ואת המתאם של InMobi
שילוב דרך pub.dev
מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK ושל המתאם שלInMobi בקובץ 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 Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת פרסום בשרשרת בחירת הרשת (Mediation) שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש של כל רשת. בשלב זה, Google לא יכולה להעביר באופן אוטומטי את הבחירה של המשתמש לגבי הסכמה לרשתות כאלה.
הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ב-InMobi לא תומך בהעברת פרטי ההסכמה ל-InMobi SDK.
חוקי פרטיות במדינות בארה"ב
חוקי הפרטיות במדינות ארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה למכירת המידע האישי שלהם (בהתאם להגדרה המעוגנת בחוק). האפשרות לבטל את ההסכמה חייבת להיות מוצגת בקישור בולט עם הכיתוב 'אל תמכרו את המידע האישי שלי' בדף הבית של הצד המוֹכֵר. במדריך התאימות לחוקי הפרטיות במדינות ארה"ב מוסבר איך מפעילים עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא תאימות.
הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ב-InMobi לא תומך בהעברת פרטי ההסכמה ל-InMobi SDK.
שלב 5: מוסיפים את הקוד הנדרש
Android
לא נדרש קוד נוסף לשילוב עם InMobi.
iOS
שילוב עם SKAdNetwork
פועלים לפי המסמכים של InMobi כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 6: בדיקה מעשית של ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-AdMob ולהפעיל את מצב הבדיקה בממשק המשתמש של InMobi.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות לבדיקה מ-InMobi, צריך להפעיל את הבדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות InMobi (בידינג) ו-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. פרטים נוספים זמינים ב-code. |
100 | פרמטרים של שרת InMobi שהוגדרו בממשק המשתמש של AdMob חסרים או לא חוקיים. |
101 | לא הצלחנו לאתחל את InMobi SDK. |
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 . |
יומן השינויים של מתאם תהליך בחירת הרשת (Mediation) של InMobi ל-Flutter
הגרסה הבאה
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.2.0.
1.1.0
- תאימות מאומתת למתאם InMobi ל-Android בגרסה 10.7.5.0.
- תאימות מאומתת עם מתאם InMobi ל-iOS בגרסה 10.7.5.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.
1.0.0
- הגרסה הראשונית.
- תאימות מאומתת למתאם InMobi ל-Android בגרסה 10.6.7.1.
- תאימות מאומתת למתאם InMobi ל-iOS בגרסה 10.7.2.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.