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

הערה: מסמכי העזרה של Pangle מפורטים לאזורים שנתמכים ב-Pangle.

במדריך הזה מוסבר איך להשתמש ב-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) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

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

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

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

חשוב: צריך להשבית את מצב הבדיקה עבור 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.