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

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

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

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

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

שילוב
בידינג
מפל
פורמטים
כרזה
פרסומת מרווח ביניים
ההטבה הופעלה
מודעת מעברון מתגמלת

דרישות

• ה-SDK העדכני של מודעות Google לנייד
• 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) ביחידת המודעות

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

לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force Solution. ספריית Unity Play Services Solutionr תבצע פתרון תלויי מההתחלה ותעתיק את יחסי התלות המוצהרים לספרייה 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

גרסה 2.7.0

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

גרסה 2.6.0

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

גרסה 2.5.0

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

גרסה 2.4.0

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

גרסה 2.3.0

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

גרסה 2.2.0

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

גרסה 2.1.0

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

גרסה 2.0.0

• תוכן המתאם הועבר אל GoogleMobileAds/Mediation/Pangle/.
• מרחב השמות של המתאם שהוגדר מחדש לצורך שימוש ב-GoogleMobileAds.Mediation.Pangle.
• יש תמיכה במתאם Android של Pangle בגרסה 5.0.0.7.0.
• יש תמיכה במתאם ל-iOS בגרסה 5.0.0.6.0.
• נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.4.1.

גרסה 1.5.1

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

גרסה 1.5.0

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

גרסה 1.4.0

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

גרסה 1.3.1

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

גרסה 1.3.0

• שינו את השם של השיטות הבאות במחלקה Pangle:
  • SetGDPR() -> SetGDPRConsent()
  • SetCCPA() -> SetDoNotSell()
• יש תמיכה במתאם Android של Pangle בגרסה 4.7.0.5.0.
• יש תמיכה במתאם ל-iOS בגרסה 4.7.0.5.0.
• נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.2.0.

גרסה 1.2.0

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

גרסה 1.1.0

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

גרסה 1.0.0

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