שילוב InMobi עם תהליך בחירת הרשת (Mediation)

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-InMobi באמצעות גישור. המדריך כולל הסברים על שילובים של שיטת המפל ושל בידינג. במאמר מוסבר איך להוסיף את InMobi להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך להטמיע את ה-SDK והמתאם של InMobi באפליקציית Flutter.

שילובים נתמכים ופורמטים נתמכים של מודעות

^‫1 נתמך רק ברשימת רשתות בתהליך בחירת הרשת.

דרישות

• הגרסה העדכנית של Google Mobile Ads SDK
• ‫Flutter 3.7.0 ומעלה
• ‫[For bidding]: כדי לשלב את כל פורמטי המודעות הנתמכים בבידינג, צריך להשתמש בתוסף Google Mobile Ads mediation ל-InMobi 4.5.0 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)
• כדי לפרוס ב-Android
  • רמת API ‏23 ואילך ב-Android
• כדי לפרוס ב-iOS
  • יעד הפריסה של iOS הוא 10.0 ומעלה
• פרויקט Flutter פעיל שהוגדר עם Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
• השלמת תהליך הגישור מדריך לתחילת העבודה

שלב 1: הגדרת תצורות בממשק המשתמש של InMobi

נרשמים לחשבון InMobi. כשיוצרים חשבון, לא מסמנים את האפשרות Use InMobi SSP with Google Open Bidding (שימוש ב-InMobi SSP עם מכירה פומבית פתוחה של Google).

אחרי שהחשבון יאומת, מתחברים אליו.

הוספת אפליקציה

כדי להוסיף את האפליקציה ללוח הבקרה של InMobi, לוחצים על מלאי שטחי פרסום > הגדרות מלאי שטחי פרסום.

לוחצים על הוספת מלאי שטחי פרסום ובתפריט הנפתח בוחרים בערוץ אפליקציה לנייד.

מתחילים להקליד את כתובת ה-URL של האפליקציה שפורסמה בחנות האפליקציות בסרגל החיפוש, ובוחרים את האפליקציה מתוך התוצאות שמופיעות. לוחצים על Continue.

אם האפליקציה לא פורסמה, לוחצים על קישור ידני ומזינים את הפרטים הנדרשים. לוחצים על Continue.

בודקים את ההגדרות של התאמה לתקנות של אפליקציות ואתרים ולוחצים על שמירה ויצירת מיקומי מודעות.

מיקומי מודעות

אחרי שמגדירים את מלאי שטחי הפרסום, המערכת מפנה אתכם לתהליך העבודה של יצירת מיקומי מודעות.

אחרי שיוצרים את מיקום המודעה, מוצגים הפרטים שלו. חשוב לשים לב למזהה מיקום המודעה, שבו תשתמשו כדי להגדיר את יחידת המודעות שלכם ב-AdMob.

מספר חשבון

מזהה החשבון ב-InMobi מופיע בקטע Finance > Payment Settings > Payment Information.

איפה נמצא מפתח ה-API של InMobi Reporting

עדכון של קובץ app-ads.txt

Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.

כדי להטמיע את app-ads.txt ב-InMobi, מוסיפים את קטע הקוד המותאם אישית.

הפעלת מצב בדיקה

מפעילים את מצב הבדיקה למיקום המודעה בכל החשיפות הפעילות או רק במכשירי בדיקה מסוימים.

שלב 2: הגדרת הביקוש של InMobi בממשק המשתמש של AdMob

הגדרת הגדרות גישור ליחידת המודעות

הוספה של InMobi לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב

כדי להוסיף את InMobi לרשימת שותפי הפרסום שעומדים בדרישות התקנות האירופאיות והתקנות במדינות בארה"ב בממשק המשתמש של AdMob, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.

שלב 3: ייבוא ה-SDK והמתאם של InMobi

שילוב דרך pub.dev

מוסיפים את התלות הבאה עם הגרסאות האחרונות של InMobi SDK והמתאם בקובץ pubspec.yaml של החבילה:

dependencies:
  gma_mediation_inmobi: ^

שילוב ידני

מורידים את הגרסה העדכנית של הפלאגין 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) של האיחוד האירופי. כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשור הגישור שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש שנעשה בכל רשת. בשלב הזה, Google לא יכולה להעביר באופן אוטומטי לרשתות כאלה את בחירת ההסכמה של המשתמש.

התוסף של Google Mobile Ads לגישור ב-InMobi לא תומך בהעברת מידע על הסכמה אל InMobi SDK.

חוקי פרטיות במדינות בארה"ב

חוקי הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (בהתאם להגדרה המעוגנת בחוק זה). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אל תמכרו את המידע האישי שלי". במדריך בנושא עמידה בדרישות של חוקי הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת (Mediation). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.

התוסף של Google Mobile Ads לגישור ב-InMobi לא תומך בהעברת מידע על הסכמה אל InMobi SDK.

שלב 5: מוסיפים קוד נוסף שנדרש

שלב 6: בדיקת ההטמעה

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ב-AdMob ולהפעיל את מצב הבדיקה בממשק המשתמש של InMobi.

אימות מודעות בדיקה

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-InMobi, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות InMobi (בידינג) ו-InMobi (Waterfall).

שלבים אופציונליים

<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" />

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-InMobi, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה למודעה באמצעות ResponseInfo במחלקות הבאות:

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

GADMAdapterInMobi
GADMediationAdapterInMobi

אלה הקודים וההודעות הנלוות שמוחזרים על ידי מתאם InMobi כשמודעה לא נטענת:

יומן השינויים של מתאם InMobi Flutter Mediation

גרסה 1.1.1

• תמיכה ב-inMobi Android adapter version 10.8.2.0.
• תמיכה בגרסה 10.8.2.0 של מתאם inMobi ל-iOS.
• התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.

גרסה 1.1.0

• פלאגין iOS הוא עכשיו מסגרת סטטית.
• תמיכה ב-inMobi Android adapter בגרסה 10.8.0.0.
• תמיכה בגרסה 10.8.0.0 של מתאם inMobi ל-iOS.
• התוסף נוצר ונבדק באמצעות גרסה 5.3.1 של Google Mobile Ads Flutter Plugin.

גרסה 1.0.0

• זו הגרסה הראשונה.
• תמיכה בגרסה 10.6.7.1 של מתאם inMobi Android.
• תמיכה בגרסה 10.7.2.0 של מתאם inMobi ל-iOS.
• התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 5.1.0.