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

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

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

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

המתאם של תהליך בחירת הרשת ב-Ad Manager ל-i-mobile כולל את היכולות הבאות:

דרישות מוקדמות

לפני שממשיכים, צריך לוודא את הפרטים הבאים:

• הגרסה העדכנית של Google Mobile Ads Flutter Plugin.
• ‫Flutter framework בגרסה 3.7.0 ואילך.
• כדי לפרוס ב-Android
  • רמת API ב-Android‏ 24 ומעלה.
• כדי לפרוס ב-iOS
  • יעד פריסה 13.0 ומעלה ב-iOS.
• פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads Flutter Plugin. פרטים נוספים מופיעים במאמר הגדרת Google Mobile Ads Flutter Plugin.

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

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

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

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

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

עוברים לכרטיסייה 広告スポット管理 (ניהול מיקומי מודעות) ולוחצים על הלחצן 新規広告スポット (מיקום מודעה חדש).

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

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

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

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

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

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

שלב 2: הגדרת ביקוש של i-mobile בממשק המשתמש של Ad Manager

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

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

שילוב דרך pub.dev

(ל-Android בלבד) מוסיפים את המאגרים הבאים לקובץ build.gradle בתוך הספרייה android של הפרויקט:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://imobile.github.io/adnw-sdk-android")
      }
  }

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

dependencies:
  gma_mediation_imobile: ^1.0.6

שילוב ידני

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

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

שלב 4: הוספת קוד נדרש

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

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

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

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

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

קודי שגיאה

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

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

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

גרסה 1.0.6

• תמיכה בגרסה 2.3.2.5 של מתאם i-mobile ל-Android.
• תמיכה בגרסה 2.3.4.8 של מתאם i-mobile ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 9.1.0.

גרסה 1.0.5

• העדכון כולל תמיכה בגרסה 9.1.0 של Google Mobile Ads Flutter Plugin.
• הוספת תמיכה ב-Swift Package Manager.
• תמיכה בגרסה 2.3.2.4 של מתאם i-mobile ל-Android.
• תמיכה בגרסה 2.3.4.8 של מתאם i-mobile ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 9.1.0.

גרסה 1.0.4

• תמיכה בגרסה 2.3.2.3 של מתאם i-mobile ל-Android.
• תמיכה בגרסה 2.3.4.7 של מתאם i-mobile ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 8.0.0.

‫גרסה 1.0.3

• הגרסה המינימלית של Flutter עודכנה ל-3.38.1
• העדכון תומך בגרסה 8.0.0 של Google Mobile Ads Flutter Plugin
• תמיכה בגרסה 2.3.2.3 של מתאם i-mobile ל-Android.
• תמיכה בגרסה 2.3.4.6 של מתאם i-mobile ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 8.0.0.

גרסה 1.0.2

• תמיכה בגרסה 2.3.2.1 של מתאם i-mobile ל-Android.
• תמיכה בגרסה 2.3.4.3 של מתאם i-mobile ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 1.0.1

• תמיכה בגרסה 2.3.2.1 של מתאם i-mobile ל-Android.
• תמיכה בגרסה 2.3.4.2 של מתאם i-mobile ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 1.0.0

• הגרסה הראשונה.
• תמיכה בגרסה 2.3.2.0 של מתאם i-mobile ל-Android.
• תמיכה בגרסה 2.3.4.1 של מתאם i-mobile ל-iOS.
• נבנה ונבדק עם גרסה 5.3.1 של הפלאגין למודעות לנייד של Google ל-Flutter.