במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Pangle באמצעות תהליך בחירת הרשת (Mediation), שכולל בידינג גם של בידינג וגם של Waterfall. נסביר איך להוסיף את Pangle להגדרה של תהליך בחירת הרשת ביחידת מודעות, ואיך לשלב את ה-SDK והמתאם של Pangle באפליקציה Unity .
השילובים והפורמטים של המודעות הנתמכים
Ad Manager מתאם בחירת הרשת ל-Pangle כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | 1 |
פורמטים | |
מודעת באנר | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות |
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Unity 5.6 ואילך
- כדי לפרוס ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדרה בו ה-SDK של Google Mobile Ads. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של Pangle
נרשמים או נכנסים לחשבון Pangle.
הוספת אפליקציה חדשה
עוברים לכרטיסייה Applications ולוחצים על הלחצן Add App.
בוחרים את מערכת ההפעלה שעבורה רוצים ליצור אפליקציה וממלאים את שאר הטופס. לאחר מכן לוחצים על שליחה.
Android
iOS
שימו לב למזהה האפליקציה.
Android
iOS
יצירת מיקום מודעה
אחרי שיוצרים את הבקשה, לוחצים על הלחצן Add כדי ליצור את מיקום המודעה.
Android
iOS
בידינג
בוחרים את פורמט המודעה ואת שם מיקום המודעה, ובוחרים באפשרות בידינג בתוך האפליקציה בתור סוג התמחור. ממלאים את שאר הטופס ולוחצים על שליחה.
אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה מיקום המודעה.
Android
iOS
מפל
בוחרים את פורמט המודעה ואת שם מיקום המודעה, ובוחרים באפשרות עלות לאלף חשיפות גלובלית בתור סוג התמחור. ממלאים את שאר הפרטים בטופס ולוחצים על שליחה.
אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה מיקום המודעה.
Android
iOS
איתור מפתח Pangle Reporting API
בידינג
השלב הזה לא נדרש בשילובי בידינג.
מפל
שימו לב למזהה המשתמש בפינה הימנית התחתונה של הדף.
לוחצים על Integrations (שילובים) > SDK & API (SDK ו-API) > Pangle Reporting API 2.0. חשוב לשים לב ל-Role ID ול-Security Key.
הפעלת מצב בדיקה
במדריך איך מוסיפים מודעת בדיקה של Pangle מוסבר איך להפעיל מודעות בדיקה של Pangle.
שלב 2: הגדרת ביקוש ב-Pangle Ad Manager בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
שלב 3: מייבאים את ה-SDK ואת המתאם של Pangle
OpenUPM-CLI
אם התקנתם את OpenUPM-CLI, תוכלו להתקין את הפלאגין של Google Mobile Ads Pangle לתהליך בחירת הרשת (Mediation) ב-Unity בפרויקט שלכם על ידי הפעלת הפקודה הבאה מהספרייה ברמה הבסיסית (root) של הפרויקט:
openupm add com.google.ads.mobile.mediation.pangle
OpenUPM
בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את הגדרות מנהל החבילות של Unity.
בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר ברמת ההיקף עם הפרטים הבאים:
- שם:
OpenUPM
- כתובת אתר:
https://package.openupm.com
- היקפים:
com.google
לאחר מכן, עוברים אל Window > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries בתפריט הנפתח.
בוחרים את החבילה Google Mobile Ads Pangle Mediation ולוחצים על Install.
חבילת Unity
מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת הרשת (Mediation) עבור Pangle מהקישור להורדה שמופיע בChangelog ומחלצים את הקובץ GoogleMobileAdsPangleMediation.unitypackage
מקובץ ה-zip.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets (נכסים) > Import Package (ייבוא חבילה) >
Custom Package (חבילה מותאמת אישית) ומוצאים את הקובץ GoogleMobileAdsPangleMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.
לאחר מכן בוחרים באפשרות Assets > External Dependency Manager > Android Resolver > Force Resolve. הספרייה של External Dependency Manager תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות המוצגים לתיקייה Assets/Plugins/Android
באפליקציה שלכם ב-Unity.
שלב 4: מוסיפים את הקוד הנדרש
Android
אין צורך בקוד נוסף לשילוב עם Pangle.
iOS
שילוב עם SKAdNetwork
פועלים לפי מסמכי התיעוד של Pangle כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בדיקה מעשית של ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-AdMob ולהפעיל את מצב הבדיקה בממשק המשתמש של Pangle.
אימות מודעות לבדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-Pangle, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות Pangle (Bidding) ו-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 | ה-SDK של Pangle החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Pangle. |
iOS
קוד שגיאה | דומיין | סיבה |
---|---|---|
101 | com.google.ads.mediation.pangle | פרמטרים לא חוקיים של שרת (למשל, חסר מזהה אפליקציה או מזהה מיקום מודעה). |
102 | com.google.ads.mediation.pangle | גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-Pangle. |
-1-60000 | נשלחה על ידי Pangle SDK | אירעה שגיאה ב-Pangle SDK. פרטים נוספים זמינים במסמכי התיעוד של Pangle. |
יומן השינויים של הפלאגין של Pangle לבחירת רשת ב-Unity
גרסה 4.3.3
- תמיכה במתאם Pangle ל-Android מגרסה 6.2.0.7.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 6.2.0.9.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.1.
גרסה 4.3.2
- יש תמיכה במתאם ל-Android של Pangle בגרסה 6.2.0.6.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 6.2.0.8.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.0.
גרסה 4.3.1
- תמיכה במתאם Pangle ל-Android בגרסה 6.2.0.5.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 6.2.0.7.0.
- נוצר ונבדק באמצעות גרסה 9.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.3.0
- תמיכה במתאם Pangle ל-Android בגרסה 6.2.0.4.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 6.2.0.5.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.0.
גרסה 4.2.1
- תמיכה במתאם ל-Android של Pangle בגרסה 6.1.0.7.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 6.1.0.6.0.
- נוצר ונבדק באמצעות גרסה 9.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.2.0
- השם של
DummyClient
השתנה ל-PlaceholderClient
. - תמיכה במתאם Pangle ל-Android בגרסה 6.1.0.6.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 6.1.0.5.0.
- נוצר ונבדק באמצעות גרסה 9.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.1.0
- יש תמיכה במתאם ל-Android של Pangle בגרסה 6.0.0.8.0.
- תומכת בגרסה 6.1.0.5.0 של מתאם iOS של Pangle.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.1.
גרסה 4.0.1
- תמיכה במתאם Pangle ל-Android בגרסה 6.0.0.5.0.
- תומכת בגרסה 6.0.0.6.0 של מתאם iOS של Pangle.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.
גרסה 4.0.0
- תמיכה במתאם Pangle ל-Android בגרסה 6.0.0.5.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 6.0.0.5.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.
גרסה 3.0.0
- תמיכה במתאם Pangle ל-Android בגרסה 6.0.0.3.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 5.9.0.9.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.
גרסה 2.8.1
- תמיכה במתאם Pangle ל-Android בגרסה 5.9.0.6.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 5.9.0.8.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.
גרסה 2.8.0
- תמיכה במתאם Pangle ל-Android בגרסה 5.9.0.4.0.
- תמיכה בגרסה 5.9.0.7.0 של מתאם iOS של Pangle.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.
גרסה 2.7.0
- תמיכה במתאם Pangle ל-Android בגרסה 5.9.0.2.0.
- תמיכה בגרסה 5.8.0.8.0 של מתאם ל-iOS של Pangle.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.6.0
- תמיכה במתאם Pangle ל-Android בגרסה 5.8.0.9.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 5.8.0.8.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.0.0.
גרסה 2.5.0
- תמיכה במתאם ל-Android של Pangle בגרסה 5.7.0.1.0.
- תמיכה בגרסה 5.7.0.7.0 של מתאם iOS של Pangle.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.6.0.
גרסה 2.4.0
- תמיכה במתאם Pangle ל-Android בגרסה 5.5.0.9.0.
- תמיכה בגרסה 5.5.0.9.0 של מתאם ל-iOS של Pangle.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.6.0.
גרסה 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.
- תמיכה במתאם Pangle ל-iOS בגרסה 5.2.0.9.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.3.0.
גרסה 2.1.0
- תמיכה במתאם Pangle ל-Android בגרסה 5.1.0.9.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 5.1.1.0.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.1.0.
גרסה 2.0.0
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/Pangle/
. - שינוי מרחב השמות של המתאם כך שישתמש ב-
GoogleMobileAds.Mediation.Pangle
. - תמיכה במתאם Pangle ל-Android בגרסה 5.0.0.7.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 5.0.0.6.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.4.1.
גרסה 1.5.1
- תמיכה במתאם ל-Android של Pangle בגרסה 4.9.0.7.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 4.9.0.8.0.
- נוצר ונבדק באמצעות גרסה 7.4.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.5.0
- תמיכה במתאם Pangle ל-Android בגרסה 4.9.0.6.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 4.9.0.7.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.3.1.
גרסה 1.4.0
- תמיכה במתאם Pangle ל-Android מגרסה 4.8.1.0.0.
- התמיכה כוללת את מתאם Pangle ל-iOS בגרסה 4.8.1.0.0.
- נוצר ונבדק באמצעות גרסה 7.3.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.3.1
- יש תמיכה במתאם ל-Android של Pangle בגרסה 4.7.0.6.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 4.7.0.6.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.2.0.
גרסה 1.3.0
- השמות של השיטות הבאות בכיתה
Pangle
שונו:SetGDPR()
->SetGDPRConsent()
SetCCPA()
->SetDoNotSell()
- תמיכה במתאם Pangle ל-Android בגרסה 4.7.0.5.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 4.7.0.5.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.2.0.
גרסה 1.2.0
- תמיכה במתאם Pangle ל-Android מגרסה 4.5.0.6.1.
- תמיכה במתאם Pangle ל-iOS בגרסה 4.5.2.8.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.1.0.
גרסה 1.1.0
- תמיכה במתאם ל-Android של Pangle בגרסה 4.5.0.3.0.
- תמיכה במתאם Pangle ל-iOS בגרסה 4.5.1.3.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.0.2.
גרסה 1.0.0
- זו הגרסה הראשונה
- תמיכה במתאם Pangle ל-Android מגרסה 4.3.0.8.0.
- תומכת בגרסה 4.3.0.5.0 של מתאם iOS של Pangle.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.0.0.