במדריך הזה מוסבר איך להשתמש ב-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. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלמת התהליך של תהליך בחירת הרשת המדריך לתחילת העבודה
שלב 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
מורידים את הגרסה העדכנית של הפלאגין לבחירת רשת (Mediation) של Google Mobile Ads ל-Pangle מהקישור להורדה ב-Changelog ומחלצים את GoogleMobileAdsPangleMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > Import Package > Custom
Package (חבילה בהתאמה אישית) ומוצאים את הקובץ GoogleMobileAdsPangleMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על Import.
לאחר מכן, בוחרים באפשרות Assets > Play Services Resolutionr > Android resolver >
אילוץ סגירה. ספריית Unity Play Services resolver תבצע רזולוציית תלות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה 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
גרסה 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 של פלאגין Google Mobile Ads Unity.
גרסה 1.0.0
- זו הגרסה הראשונה
- תמיכה במתאם ל-Android של Pangle בגרסה 4.3.0.8.0.
- תומכת בגרסה 4.3.0.5.0 של מתאם iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.