שילוב 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
  • ‫Android API ברמה 24 ואילך.
• כדי לפרוס ב-iOS
  • יעד פריסה 13.0 ומעלה ב-iOS.
• פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads Flutter Plugin. פרטים נוספים מופיעים במאמר הגדרת Google Mobile Ads Flutter Plugin.

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

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

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

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

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

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

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

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

שימו לב לערכים של パブリッシャー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: מייבאים את ה-SDK והמתאם של i-mobile

שילוב דרך 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
• תמיכה בגרסה 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.