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

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

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

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

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

דרישות

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

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

נרשמים או נכנסים לחשבון Pangle.

הוספת אפליקציה חדשה

עוברים לכרטיסייה Applications ולוחצים על הלחצן Add App.

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

Android

iOS

שימו לב למזהה האפליקציה.

Android

iOS

יצירת מיקום מודעה

אחרי שיוצרים את הבקשה, לוחצים על הלחצן Add כדי ליצור את מיקום המודעה.

Android

iOS

בידינג

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

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

Android

iOS

מפל

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

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

Android

iOS

איתור מפתח ה-API של Pangle Reporting

בידינג

השלב הזה לא נדרש בשילובי בידינג.

מפל

שימו לב למזהה המשתמש בפינה הימנית התחתונה של הדף.

לוחצים על Integrations (שילובים) > SDK & API (SDK ו-API) > Pangle Reporting API 2.0. שימו לב ל-Role ID ולמפתח האבטחה.

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

כדי להפעיל מודעות בדיקה ב-Pangle, פועלים לפי ההוראות במדריך איך מוסיפים מודעה לבדיקה של 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/")
      }
  }

מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK ושל המתאם שלPangle בקובץ 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) ו-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 ה-SDK של Pangle החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Pangle.

iOS

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

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

הגרסה הבאה

  • נוצר ונבדק באמצעות גרסה 5.2.0 של הפלאגין של Google Mobile Ads Flutter.

2.0.0

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

1.1.0

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

1.0.0

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