במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Pangle באמצעות תהליך בחירת הרשת (Mediation), שמכסים גם את ה-Waterfall וגם את הבידינג שילובים של . הוא כולל הסבר על להוסיף את Pangle להגדרה של תהליך בחירת הרשת ביחידת מודעות, ואיך לשלב את מתאם ו-SDK של Pangle באפליקציה Unity .
השילובים והפורמטים של המודעות שנתמכים
AdMob מתאם הגישור ל-Pangle כולל היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות |
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Unity 5.6 ומעלה
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פועל שהוגדר עם 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
הורדת הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ל-Pangle
מהקישור להורדה ביומן השינויים
ומחלצים את הערך GoogleMobileAdsPangleMediation.unitypackage
מה-ZIP
חדש.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > (נכסים >) ייבוא חבילה > Custom (בהתאמה אישית)
Package ומוצאים את GoogleMobileAdsPangleMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על
ייבוא.
בשלב הבא בוחרים באפשרות נכסים > המקודד של Play Services > מקודד Android >
סגירה ידנית. ספריית Unity Play Services מקודדת תפעל
של יחסי התלות מההתחלה ומעתיקים את יחסי התלות המוצהרים
הספרייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 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. |
יומן שינויים בפלאגין של Pangle Unity Mediation
הגרסה הבאה
- השם של
DummyClient
השתנה. השם החדש הואPlaceholderClient
.
גרסה 4.1.0
- יש תמיכה במתאם ל-Android של Pangle בגרסה 6.0.0.8.0.
- תומכת בגרסה 6.1.0.5.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 9.1.1 של פלאגין Google Mobile Ads Unity.
גרסה 4.0.1
- תמיכה במתאם ל-Android של Pangle בגרסה 6.0.0.5.0.
- תומכת בגרסה 6.0.0.6.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.0.0
- תמיכה במתאם ל-Android של Pangle בגרסה 6.0.0.5.0.
- תומכת בגרסה 6.0.0.5.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.0.0
- יש תמיכה במתאם ל-Android של Pangle בגרסה 6.0.0.3.0.
- תמיכה בגרסה 5.9.0.9.0 של מתאם ל-iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.8.1
- תמיכה במתאם ל-Android של Pangle בגרסה 5.9.0.6.0.
- תמיכה בגרסה 5.9.0.8.0 של מתאם ל-iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.8.0
- תמיכה במתאם ל-Android של Pangle בגרסה 5.9.0.4.0.
- תמיכה בגרסה 5.9.0.7.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.7.0
- תמיכה במתאם ל-Android של Pangle בגרסה 5.9.0.2.0.
- תמיכה בגרסה 5.8.0.8.0 של מתאם ל-iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.6.0
- תמיכה במתאם ל-Android של Pangle בגרסה 5.8.0.9.0.
- תמיכה בגרסה 5.8.0.8.0 של מתאם ל-iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 2.5.0
- תמיכה במתאם ל-Android של Pangle בגרסה 5.7.0.1.0.
- תמיכה בגרסה 5.7.0.7.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 8.6.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.4.0
- תמיכה במתאם ל-Android של Pangle בגרסה 5.5.0.9.0.
- תמיכה בגרסה 5.5.0.9.0 של מתאם ל-iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 8.6.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.3.0
- תמיכה במתאם ל-Android של Pangle בגרסה 5.3.0.6.0.
- תמיכה בגרסה 5.3.1.2.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 8.4.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.2.0
- תמיכה במתאם ל-Android של Pangle בגרסה 5.2.0.6.0.
- תמיכה בגרסה 5.2.0.9.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 8.3.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.1.0
- תמיכה במתאם ל-Android של Pangle בגרסה 5.1.0.9.0.
- תמיכה בגרסה 5.1.1.0.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 8.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.0.0
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/Pangle/
. - מרחב השמות של המתאם עבר ארגון מחדש לשימוש ב-
GoogleMobileAds.Mediation.Pangle
. - תמיכה במתאם ל-Android של Pangle בגרסה 5.0.0.7.0.
- תומכת בגרסה 5.0.0.6.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 7.4.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.5.1
- תמיכה במתאם ל-Android של Pangle בגרסה 4.9.0.7.0.
- תומכת בגרסה 4.9.0.8.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 7.4.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.5.0
- יש תמיכה במתאם ל-Android של Pangle בגרסה 4.9.0.6.0.
- תמיכה בגרסה 4.9.0.7.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 7.3.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.4.0
- יש תמיכה במתאם ל-Android של Pangle בגרסה 4.8.1.0.0.
- תומכת בגרסה 4.8.1.0.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 7.3.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.3.1
- יש תמיכה במתאם ל-Android של Pangle בגרסה 4.7.0.6.0.
- תומכת בגרסה 4.7.0.6.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 7.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.3.0
- שיניתם את השם של השיטות הבאות במחלקה
Pangle
:SetGDPR()
->SetGDPRConsent()
SetCCPA()
->SetDoNotSell()
- תמיכה במתאם ל-Android של Pangle בגרסה 4.7.0.5.0.
- תומכת בגרסה 4.7.0.5.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 7.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.2.0
- תמיכה במתאם ל-Android של Pangle בגרסה 4.5.0.6.1.
- תומכת בגרסה 4.5.2.8.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 7.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.1.0
- תמיכה במתאם ל-Android של Pangle בגרסה 4.5.0.3.0.
- תמיכה בגרסה 4.5.1.3.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 7.0.2 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.0.0
- זו הגרסה הראשונה
- תמיכה במתאם ל-Android של Pangle בגרסה 4.3.0.8.0.
- תומכת בגרסה 4.3.0.5.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.