במדריך הזה מוסבר איך משתמשים ב-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
נרשמים או מתחברים לחשבון Pangle.
הוספת אפליקציה חדשה
מנווטים לכרטיסייה Applications (אפליקציות) ולוחצים על הלחצן Add App (הוספת אפליקציה).
בוחרים את מערכת ההפעלה שעבורה רוצים ליצור אפליקציה וממלאים את שאר הטופס. לאחר מכן לוחצים על שליחה.
Android
iOS
חשוב לזכור מהו מזהה האפליקציה של האפליקציה שלכם.
Android
iOS
יצירת מיקום מודעה
אחרי שיוצרים את האפליקציה, לוחצים על Add כדי ליצור את מיקום המודעה.
Android
iOS
בידינג
בחר את פורמט המודעה ואת שם מיקום המודעה, ובחר באפשרות בידינג בתוך האפליקציה בשדה סוג התמחור. ממלאים את שאר הטופס ולוחצים על Submit.
אחרי שיוצרים את מיקום המודעה, חשוב לזכור את מזהה מיקום המודעה.
Android
iOS
מפל
בחר את פורמט המודעה ושם מיקום המודעה, ועלות גלובלית לאלף חשיפות בתור סוג התמחור. ממלאים את שאר הטופס ולוחצים על Submit.
אחרי שיוצרים את מיקום המודעה, חשוב לזכור את מזהה מיקום המודעה.
Android
iOS
איתור מפתח ה-API של Pangle Reporting
בידינג
לא צריך לבצע את השלב הזה בשילובי בידינג.
מפל
חשוב לשים לב למאפיין User ID בפינה הימנית התחתונה של הדף.
לוחצים על Integrations (שילובים) > SDK & API > Pangle Reporting API 2.0. שימו לב למזהה התפקיד ולמפתח האבטחה.
הפעלת מצב בדיקה
פועלים לפי ההוראות המפורטות במדריך איך מוסיפים מודעות בדיקה ב-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
שילוב ידני
כדאי להוריד את הגרסה האחרונה של הפלאגין לבחירת רשת (Mediation) של Google Ads לנייד עבור
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.