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

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

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

שילוב
בידינג  1
מפל
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה
מותאם  2

1 השילוב של הבידינג נמצא בגרסת בטא פתוחה.

2 התכונה נתמכת רק בתהליך בחירת רשת (Mediation) מסוג רשימת רשתות.

דרישות

  • ה-SDK העדכני של Google Mobile Ads
  • 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, לוחצים על מלאי שטחי פרסום > הגדרות מלאי שטחי הפרסום.

לוחצים על Add Inventory (הוספת מלאי) ובוחרים בערוץ App Mobile בתפריט הנפתח.

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

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

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

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

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

בידינג

בוחרים את סוג יחידת המודעות. מזינים שם מיקום מודעה, בוחרים באפשרות מופעל ובאפשרות Google Open Bidding עבור בידינג לפי קהל ושותף, בהתאמה, וממלאים את שאר הטופס. בסיום, לוחצים על יצירת מיקום מודעה.

מפל

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

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

מספר חשבון

מספר חשבון InMobi שלך זמין בקטע פיננסים > הגדרות תשלום > פרטי תשלום.

איתור מפתח API לדיווח של InMobi

בידינג

לא צריך לבצע את השלב הזה בשילוב של בידינג.

מפל

עוברים אל החשבון שלי > הגדרות חשבון. עוברים לכרטיסייה API Key ולוחצים על Generate API Key.

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

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

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

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

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

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

הוספה של 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

בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, אתם צריכים לוודא שהמשתמשים באזור הכלכלי האירופי (EEA) מקבלים גילויים נאותים מסוימים לגבי השימוש במזהי מכשירים ובמידע אישי, ומאשרים את השימוש הזה. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שיכולה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב הזה, Google לא יכולה להעביר לרשתות כאלה באופן אוטומטי את הבחירות של המשתמשים בנושא פרטיות.

הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ב-InMobi לא תומך בהעברת פרטי ההסכמה ל-InMobi SDK.

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

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

הפלאגין של 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. אפשר לקרוא פרטים נוספים בקוד.
100 פרמטרים של שרת InMobi שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
101 לא הצלחנו לאתחל את InMobi SDK.
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.

יומן השינויים של מתאם תהליך בחירת הרשת (Mediation) של InMobi ל-Flutter

הגרסה הבאה

  • ה-plugin נוצר ונבדק באמצעות Google Mobile Ads Flutter Plugin בגרסה 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.
  • נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.