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

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

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

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

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

דרישות

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

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

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

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

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

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

AndroidiOS

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

AndroidiOS

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

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

AndroidiOS
בידינגמפל

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

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

AndroidiOS

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

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

AndroidiOS

איתור מפתח Pangle Reporting API

בידינגמפל

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

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

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

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

כדי להפעיל מודעות בדיקה ב-Pangle, פועלים לפי ההוראות במדריך של Pangle בנושא הוספת מודעת בדיקה.

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

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

AndroidiOS

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

להוראות, אפשר לעיין בשלב 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: ^2.0.0

שילוב ידני

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

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

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

AndroidiOS

אין צורך בקוד נוסף לשילוב עם Pangle.

שילוב עם SKAdNetwork

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

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

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

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

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

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

קודי שגיאה

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

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

GADMediationAdapterPangle

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

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

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

2.0.0

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

1.1.0

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

1.0.0

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