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

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

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

AdMob מתאם הגישור ל-Pangle כולל היכולות הבאות:

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

דרישות

  • ה-SDK העדכני של Google Mobile Ads
  • Flutter 3.7.0 ואילך
  • לפריסה ב-Android
    • Android API ברמה 21 ואילך
  • לפריסה ב-iOS
    • יעד הפריסה של iOS מגרסה 12.0 ואילך
  • פרויקט Flutter פועל שהוגדר עם Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
  • השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה

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

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

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

Android

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

iOS

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

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

שילוב באמצעות pub.dev

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

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifact.bytedance.com/repository/pangle/")
      }
  }

צריך להוסיף את התלות הבאה בגרסאות האחרונות של Pangle ה-SDK והמתאם בחבילה שלך קובץ pubspec.yaml:

dependencies:
  gma_mediation_pangle: ^1.0.0

שילוב ידני

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

dependencies:
  gma_mediation_pangle:
    path: path/to/local/package

שלב 4: מוסיפים את הקוד הנדרש

Android

לא נדרש קוד נוסף כדי לשלב את Pangle.

iOS

שילוב של SKAdNetwork

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

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

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

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

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

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

קודי שגיאה

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

Android

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

iOS

GADMediationAdapterPangle

אלו הקודים וההודעות הנלוות שהמתאם של Pangle זורק בזמן מודעה לא נטענת:

Android

קוד שגיאה דומיין סיבה
101 com.google.ads.mediation.pangle פרמטרים לא חוקיים של השרת (למשל, מזהה אפליקציה חסר או מזהה מיקום מודעה).
102 com.google.ads.mediation.pangle גודל המודעה המבוקש לא תואם לגודל באנר הנתמך ב-Pangle.
103 com.google.ads.mediation.pangle תגובה חסרה או לא חוקית להצעת מחיר.
-1-60000 com.pangle.ads אירעה שגיאה ב-Pangle SDK. פרטים נוספים זמינים במסמכי התיעוד של Pangle.

iOS

קוד שגיאה דומיין סיבה
101 com.google.ads.mediation.pangle פרמטרים לא חוקיים של השרת (למשל, מזהה אפליקציה חסר או מזהה מיקום מודעה).
102 com.google.ads.mediation.pangle גודל המודעה המבוקש לא תואם לגודל באנר הנתמך ב-Pangle.
-1-60000 נשלח על ידי Pangle SDK אירעה שגיאה ב-Pangle SDK. פרטים נוספים זמינים במסמכי התיעוד של Pangle.

יומן שינויים של מתאם ל-Fangle Flutter Mediation

1.1.0

  • תאימות מאומתת למתאם Android של Pangle בגרסה 5.9.0.4.0.
  • תאימות מאומתת למתאם iOS של Pangle בגרסה 5.9.0.7.0.
  • נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.

1.0.0

  • גרסה ראשונית.
  • תאימות מאומתת למתאם Android של Pangle בגרסה 5.8.0.9.0
  • תאימות מאומתת למתאם iOS של Pangle בגרסה 5.8.0.8.0
  • נוצר ונבדק באמצעות גרסה 5.0.0 של פלאגין Google Mobile Ads Flutter.