שילוב של Pangle עם תהליך בחירת הרשת (Mediation)

במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Pangle באמצעות תהליך בחירת הרשת, תוך התמקדות בשילובים של בידינג . במאמר מוסבר איך להוסיף את Pangle להגדרות תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של Pangle באפליקציה Unity .

השילובים והפורמטים של המודעות הנתמכים

Ad Manager מתאם בחירת הרשת ל-Pangle כולל את היכולות הבאות:

שילוב
בידינג
מפל	^1
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה
מודעות מעברון מתגמלות

¹ השילוב עם Waterfall נמצא בגרסת בטא סגורה.

דרישות

• הגרסה העדכנית ביותר של Google Mobile Ads SDK
• 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. חשוב לשים לב למזהה התפקיד ולמפתח האבטחה.

הפעלת מצב בדיקה

כדי להפעיל מודעות בדיקה ב-Pangle, פועלים לפי ההוראות במדריך איך מוסיפים מודעה לבדיקה של Pangle.

שלב 2: הגדרת הביקוש מ-Pangle בממשק המשתמש Ad Manager

הגדרת הגדרות בחירת הרשת ליחידת המודעות

Android

להוראות, אפשר לעיין בשלב 2 במדריך ל- Android.

iOS

להוראות, אפשר לעיין בשלב 2 במדריך ל- iOS.

שלב 3: מייבאים את ה-SDK ואת המתאם של Pangle

הערה: אי-שילוב של הגרסאות התואמות של Pangle ו-Google Mobile Ads SDK עלול להוביל לבעיות ב-build.

OpenUPM-CLI

חשוב: אם עוברים משימוש ב-.unitypackage לשימוש ב-OpenUPM-CLI, צריך להסיר את הנכסים באופן ידני מהמיקום הישן על ידי מחיקה של כל הקבצים מהתיקייה Assets/GoogleMobileAds/Mediation/Pangle.

אם התקנתם את OpenUPM-CLI, תוכלו להתקין את הפלאגין של Google Mobile Ads Pangle לתהליך בחירת הרשת (Mediation) ב-Unity בפרויקט שלכם על ידי הפעלת הפקודה הבאה מהספרייה ברמה הבסיסית (root) של הפרויקט:

openupm add com.google.ads.mobile.mediation.pangle

OpenUPM

חשוב: אם עוברים משימוש ב-.unitypackage לשימוש ב-OpenUPM, צריך להסיר את הנכסים באופן ידני מהמיקום הישן על ידי מחיקה של כל הקבצים מהתיקייה Assets/GoogleMobileAds/Mediation/Pangle.

בעורך הפרויקט ב-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 שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על ייבוא.

לאחר מכן בוחרים באפשרות נכסים > מנהל יחסי התלות החיצוניים > Android Resolver > Force Resolve. הספרייה של מנהל יחסי התלות החיצוניים תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות המוצגים לתיקייה Assets/Plugins/Android של אפליקציית Unity.

שלב 4: מוסיפים את הקוד הנדרש

Android

אין צורך בקוד נוסף לשילוב עם Pangle.

iOS

שילוב עם SKAdNetwork

פועלים לפי המסמכים של Pangle כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.

שלב 5: בדיקה מעשית של ההטמעה

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ב-AdMob ולהפעיל את מצב הבדיקה בממשק המשתמש של Pangle.

חשוב: לפני השקת האפליקציה, צריך להשבית את מצב הבדיקה ב-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	ה-SDK של Pangle החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Pangle.

יומן השינויים של הפלאגין של Pangle לבחירת רשת ב-Unity

גרסה 4.4.1

• תמיכה במתאם Pangle ל-Android בגרסה 6.3.0.4.0.
• תמיכה במתאם Pangle ל-iOS בגרסה 6.3.0.8.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.3.0.

גרסה 4.4.0

• תמיכה במתאם Pangle ל-Android מגרסה 6.3.0.2.0.
• תמיכה במתאם Pangle ל-iOS בגרסה 6.3.0.6.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.3.0.

גרסה 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

• תמיכה במתאם Pangle ל-Android בגרסה 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.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.0.

גרסה 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

• תמיכה במתאם Pangle ל-Android בגרסה 6.1.0.7.0.
• תמיכה במתאם Pangle ל-iOS בגרסה 6.1.0.6.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.0.

גרסה 4.2.0

• השם של DummyClient השתנה ל-PlaceholderClient.
• תמיכה במתאם Pangle ל-Android בגרסה 6.1.0.6.0.
• תמיכה במתאם Pangle ל-iOS בגרסה 6.1.0.5.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.0.

גרסה 4.1.0

• תמיכה במתאם Pangle ל-Android בגרסה 6.0.0.8.0.
• תמיכה במתאם Pangle ל-iOS בגרסה 6.1.0.5.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.1.

גרסה 4.0.1

• תמיכה במתאם Pangle ל-Android בגרסה 6.0.0.5.0.
• תמיכה במתאם Pangle ל-iOS בגרסה 6.0.0.6.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של 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.
• תמיכה במתאם Pangle ל-iOS בגרסה 5.9.0.7.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.

גרסה 2.7.0

• תמיכה במתאם Pangle ל-Android בגרסה 5.9.0.2.0.
• תמיכה במתאם Pangle ל-iOS בגרסה 5.8.0.8.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.

גרסה 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

• תמיכה במתאם Pangle ל-Android בגרסה 5.7.0.1.0.
• תמיכה במתאם Pangle ל-iOS בגרסה 5.7.0.7.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.6.0.

גרסה 2.4.0

• תמיכה במתאם Pangle ל-Android בגרסה 5.5.0.9.0.
• תמיכה במתאם Pangle ל-iOS בגרסה 5.5.0.9.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.6.0.

גרסה 2.3.0

• תמיכה במתאם Pangle ל-Android בגרסה 5.3.0.6.0.
• תמיכה במתאם Pangle ל-iOS בגרסה 5.3.1.2.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.4.1.

גרסה 2.2.0

• תמיכה במתאם Pangle ל-Android בגרסה 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

• תמיכה במתאם Pangle ל-Android בגרסה 4.9.0.7.0.
• תמיכה במתאם Pangle ל-iOS בגרסה 4.9.0.8.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.4.0.

גרסה 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.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.3.1.

גרסה 1.3.1

• תמיכה במתאם Pangle ל-Android בגרסה 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

• תמיכה במתאם Pangle ל-Android בגרסה 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.
• תמיכה במתאם Pangle ל-iOS בגרסה 4.3.0.5.0.
• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.0.0.