במדריך הזה מוסבר איך משתמשים ב-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 פעיל שהוגדרה בו ה-SDK של Google Mobile Ads. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של Pangle
נרשמים או נכנסים לחשבון Pangle.
הוספת אפליקציה חדשה
עוברים לכרטיסייה Applications ולוחצים על הלחצן Add App.
בוחרים את מערכת ההפעלה שעבורה רוצים ליצור אפליקציה וממלאים את שאר הטופס. לאחר מכן לוחצים על שליחה.
Android
iOS
מומלץ לרשום לפניכם את מזהה האפליקציה של האפליקציה.
Android
iOS
יצירת מיקום מודעה
אחרי שיוצרים את הבקשה, לוחצים על הלחצן Add כדי ליצור את מיקום המודעה.
Android
iOS
בידינג
בוחרים את פורמט המודעה ואת שם מיקום המודעה, ובוחרים באפשרות בידינג בתוך האפליקציה בתור סוג התמחור. ממלאים את שאר הטופס ולוחצים על שליחה.
אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה מיקום המודעה.
Android
iOS
מפל
בוחרים את פורמט המודעה, שם מיקום המודעה וגלובלי. עלות לאלף חשיפות (CPM) בתור סוג התמחור. ממלאים את שאר הטופס ולוחצים על לוחצים על שליחה.
אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה מיקום המודעה.
Android
iOS
איתור מפתח Pangle Reporting API
בידינג
לא צריך לבצע את השלב הזה בשילוב של בידינג.
מפל
חפשו את User ID בפינה הימנית התחתונה של הדף.
לוחצים על Integrations (שילובים) > SDK ו- API > Pangle Reporting API 2.0. חשוב לשים לב ל-Role ID ול-Security Key.
הפעלת מצב בדיקה
כדי להפעיל מודעות בדיקה ב-Pangle, פועלים לפי ההוראות במדריך איך מוסיפים מודעה לבדיקה של Pangle.
שלב 2: הגדרת הביקוש מ-Pangle בממשק המשתמש AdMob
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
שלב 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 | ה-SDK של Pangle החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Pangle. |
יומן שינויים של מתאם ל-Fangle Flutter Mediation
הגרסה הבאה
- נוצר ונבדק באמצעות גרסה 5.2.0 של הפלאגין של Google Mobile Ads Flutter.
2.0.0
- תאימות מאומתת למתאם Android של Pangle בגרסה 6.1.0.9.0.
- תאימות מאומתת למתאם iOS של Pangle בגרסה 6.2.0.5.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.
1.1.0
- תאימות מאומתת למתאם Android של Pangle בגרסה 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
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.0.0.