שילוב i-mobile עם תהליך בחירת הרשת (Mediation)

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

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

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

למתאם של תהליך בחירת הרשת (Mediation) ב-AdMob עבור i-mobile יש את היכולות הבאות:

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

דרישות

  • הגרסה העדכנית של Google Mobile Ads SDK
  • ‫Flutter 3.7.0 ומעלה
  • כדי לפרוס ב-Android
    • רמת API ‏23 ואילך ב-Android
  • כדי לפרוס ב-iOS
    • יעד הפריסה של iOS הוא 12.0 ומעלה
  • פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה עם Service Management API.
  • השלמת תהליך הגישור מדריך לתחילת העבודה

שלב 1: הגדרת תצורות בממשק המשתמש של i-mobile

נרשמים או מתחברים לחשבון i-mobile.

כדי להוסיף את האפליקציה ללוח הבקרה של i-mobile, לוחצים על הכרטיסייה サイト／アプリ管理 (Site/Application Management) (ניהול אתרים/אפליקציות) ועל הלחצן של הפלטפורמה של האפליקציה.

Android

iOS

ממלאים את הטופס ולוחצים על הלחצן 新規登録 (הרשמה).

Android

iOS

כדי ליצור מיקום חדש להצגת מודעות, בוחרים את האפליקציה בכרטיסייה サイト／アプリ管理 (ניהול אתרים/אפליקציות).

Android

iOS

עוברים לכרטיסייה 広告スポット管理 (Ad Spot Management) ולוחצים על הלחצן 新規広告スポット (New Ad Spot).

create_ad_spot

לאחר מכן ממלאים את הטופס ומזינים את 広告スポット名 (שם מיקום המודעה),‏ 広告スポットサイズ (גודל מיקום המודעה) ופרטים נוספים. לאחר מכן, לוחצים על הלחצן 新規登録 (Sign up) (הרשמה).

new_ad_spot_form

הכנו לך סרטון פרסומת חדש. כדי לראות את פרטי השילוב, לוחצים על הלחצן アプリ設定取得 (קבלת הגדרות האפליקציה).

ad_spot_list

חשוב לרשום את パブリッシャーID (מזהה בעל התוכן הדיגיטלי), メディアID (מזהה המדיה) וスポットID (מזהה המיקום). תצטרכו את הפרמטרים האלה בהמשך, כשאתם מגדירים את i-mobile לגישור בממשק המשתמש של AdMob.

Android

iOS

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

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

כדי להטמיע את app-ads.txt ב-i-mobile, אפשר לעיין בשאלות הנפוצות שלהם.

שלב 2: מגדירים את הביקוש של i-mobile בממשק המשתמש של AdMob

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

Android

הוראות מפורטות מופיעות בשלב 2 במדריך ל-Android.

iOS

הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

שלב 3: ייבוא של i-mobile SDK ומתאם

שילוב דרך pub.dev

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

dependencies:
  gma_mediation_imobile: ^

שילוב ידני

מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads Mediation ל-i-mobile, מחלצים את הקובץ שהורד ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את התלות הבאה לקובץ pubspec.yaml כדי להפנות אל הפלאגין:

dependencies:
  gma_mediation_imobile:
    path: path/to/local/package

שלב 4: נדרש קוד נוסף

Android

לא נדרש קוד נוסף לשילוב של i-mobile.

iOS

שילוב של SKAdNetwork

פועלים לפי המסמכים של i-mobile כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.

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

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

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

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

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

קודי שגיאה

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

Android

פורמט שם הכיתה
מודעת באנר com.google.ads.mediation.imobile.IMobileAdapter
מעברון com.google.ads.mediation.imobile.IMobileAdapter
מותאם com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

פורמט שם הכיתה
מודעת באנר IMobileAdapter
מעברון IMobileAdapter
מותאם GADMediationAdapterIMobile

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

Android

קוד שגיאה סיבה
0-99 i-mobile SDK החזיר שגיאה. פרטים נוספים מופיעים במאמר בנושא קוד.
101 כדי לטעון מודעות, i-mobile דורש הקשר Activity.
102 פרמטרים של שרת i-mobile שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
103 גודל המודעה המבוקש לא תואם לגודל באנר שנתמך על ידי i-mobile.
104 הקריאה החוזרת (callback) של i-mobile לטעינת מודעות מותאמות החזירה רשימה ריקה של מודעות מותאמות.

iOS

קוד שגיאה סיבה
0-10 i-mobile SDK החזיר שגיאה. פרטים נוספים מופיעים במאמר בנושא קוד.
101 פרמטרים של שרת i-mobile שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
102 גודל המודעה המבוקש לא תואם לגודל באנר שנתמך על ידי i-mobile.
103 הצגת מודעה ב-i-mobile נכשלה.
104 ‫i-mobile החזיר מערך ריק של מודעות מותאמות.
105 ההורדה של נכסי מודעות מותאמות ב-i-mobile נכשלה.
106 פלטפורמת i-mobile לא תומכת בשליחת בקשות לכמה מודעות מעברון באמצעות אותו מזהה מיקום.

יומן השינויים של i-mobile Flutter Mediation Adapter

גרסה 1.0.1

גרסה 1.0.0