דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

שילוב
בידינג
מפל
פורמטים
מודעה בפתיחת אפליקציה	¹
מודעת באנר
מעברון
ההטבה הופעלה
מודעות מעברון מתגמלות
מותאם

¹ השילוב של הבידינג בפורמט הזה נמצא בגרסת בטא סגורה.

דרישות

יעד הפריסה של iOS בגרסה 10.0 ואילך

הגרסה העדכנית ביותר של Google Mobile Ads SDK
מדריך לתחילת העבודה בנושא בחירת הרשת

שלב 1: הגדרת ההגדרות בממשק המשתמש של Pangle

נרשמים או נכנסים לחשבון Pangle.

הוספת אפליקציה חדשה

עוברים לכרטיסייה Applications ולוחצים על הלחצן Add App.

בוחרים את מערכת ההפעלה שעבורה רוצים ליצור בקשה וממלאים את שאר הטופס. לאחר מכן לוחצים על שליחה.

מומלץ לרשום לפניכם את מזהה האפליקציה של האפליקציה.

יצירת מיקום מודעה

אחרי שיוצרים את האפליקציה, לוחצים על הלחצן Add כדי ליצור את מיקום המודעה.

בידינג

בוחרים את פורמט המודעה ואת שם מיקום המודעה, ובוחרים באפשרות בידינג בתוך האפליקציה בתור סוג התמחור. ממלאים את שאר הטופס ולוחצים על שליחה.

אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה מיקום המודעה.

מפל

בוחרים את פורמט המודעה ואת שם מיקום המודעה, ובוחרים באפשרות עלות לאלף חשיפות גלובלית בתור סוג התמחור. ממלאים את שאר הפרטים בטופס ולוחצים על שליחה.

אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה מיקום המודעה.

איתור מפתח Pangle Reporting API

בידינג

השלב הזה לא נדרש בשילובי בידינג.

מפל

חפשו את User ID בפינה הימנית התחתונה של הדף.

לוחצים על Integrations (שילובים) > SDK & API (SDK ו-API) > Pangle Reporting API 2.0. חשוב לשים לב ל-Role ID ול-Security Key.

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

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

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

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

עליך להוסיף Pangle לתצורה של תהליך בחירת הרשת של יחידת המודעות.

קודם נכנסים לחשבון AdMob. לאחר מכן נכנסים לכרטיסייה תהליך בחירת הרשת (Mediation). אם יש קבוצה קיימת לבחירת רשת שאתם רוצים לשנות, צריך ללחוץ על השם של הקבוצה לבחירת רשת כדי לערוך אותה, ולדלג לקטע הוספה Pangle כמקור מודעות.

כדי ליצור קבוצה חדשה לבחירת רשת, בוחרים באפשרות יצירת קבוצה לבחירת רשת (Mediation).

מזינים את פורמט המודעה ואת הפלטפורמה, ולוחצים על המשך.

נותנים שם לקבוצה לבחירת רשת (Mediation) ובוחרים מיקומים גיאוגרפיים לטירגוט. בשלב הבא, מגדירים את הסטטוס של הקבוצה לבחירת רשת למופעלת ולוחצים על הוספת יחידות של מודעות.

משייכים את הקבוצה הזו לבחירת רשת לאחת או יותר מיחידות המודעותAdMob הקיימות. לאחר מכן לוחצים על סיום.

עכשיו אתם אמורים לראות שהכרטיס של יחידות המודעות מאוכלס ביחידות של המודעות שבחרתם:

הוספה של Pangle כמקור מודעות

בידינג

בכרטיס בידינג שבקטע מקורות מודעות, בוחרים באפשרות הוספה מקור מודעות. ובוחרים באפשרות Pangle.

לוחצים על איך חותמים על הסכם שותפות ומגדירים בידינג שותפות עם Pangle

לוחצים על אישור ו מסכים, ואז לוחצים על המשך.

אם כבר יש לך מיפוי של Pangle, אפשר לבחור אותו. אחרת, לוחצים על הוספת מיפוי.

בשלב הבא, מזינים את App ID and Ad Placement ID שקיבלתם בקטע הקודם. לאחר מכן לוחצים על סיום.

מפל

בכרטיס Waterfall בקטע מקורות מודעות, בוחרים באפשרות הוספת מקור מודעות. לאחר מכן בוחרים Pangle.

בוחרים באפשרות Pangle. לאחר מכן מזינים ערך של עלות בפועל לאלף חשיפות עבורPangle ולוחצים על המשך.

אם כבר יש לכם מיפוי של Pangle, תוכלו לבחור אותו. אם לא, לוחצים על הוספת מיפוי.

לאחר מכן, מזינים את App ID and Ad Placement IDשקיבלתם בקטע הקודם. לאחר מכן לוחצים על סיום.

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

שימוש ב-CocoaPods (מומלץ)

מוסיפים את השורה הבאה ל-Podfile של הפרויקט:
```
pod 'GoogleMobileAdsMediationPangle'
```
מריצים את הפקודה הבאה בשורת הפקודה:
```
pod install --repo-update
```

שילוב ידני

מורידים את הגרסה העדכנית של Pangle SDK for iOS ומקשרים את כל הקבצים והחבילות של .framework בפרויקט.
מורידים את הגרסה העדכנית של מתאם Pangle בלחיצה על קישור ההורדה ביומן שינויים ובקישור PangleAdapter.xcframework בפרויקט.

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

שילוב עם SKAdNetwork

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

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

שלבים אופציונליים

מודעות מותאמות

עיבוד מודעות

המתאם של Pangle מחזיר את המודעות המותאמות שלו בתור GADNativeAd אובייקטים. היא מאכלסת את השדות הבאים של GADNativeAd

שדה	נכסים שתמיד נכללים במתאם Pangle
כותרת
תמונה	1
גוף
סמל
קריאה לפעולה
Star rating
חנות
מחיר
מפרסם

¹ המתאם של Pangle לא מספק גישה ישירה לנכס התמונה הראשי עבור המודעות המותאמות שלו. במקום זאת, המתאם מאכלס את השדהGADMediaViewבסרטון או בתמונה.

קודי שגיאה

אם המתאם לא מקבל מודעה מ-Pangle, אפשר לבדוק את השגיאה הבסיסית בתגובה למודעה באמצעות GADResponseInfo.adNetworkInfoArray בקטגוריות הבאות:

GADMediationAdapterPangle

אלה הקודים וההודעות שמתקבלים מהמתאם של Pangle כשמודעה לא נטענת:

קוד שגיאה	דומיין	סיבה
101	com.google.ads.mediation.pangle	פרמטרים לא חוקיים של שרת (למשל, חסר מזהה אפליקציה או מזהה מיקום מודעה).
102	com.google.ads.mediation.pangle	גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-Pangle.
-1-60000	נשלח על ידי Pangle SDK	ה-SDK של Pangle החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Pangle.

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

גרסה 6.3.0.6.0

תאימות מאומתת ל-Pangle SDK בגרסה 6.3.0.6.

פותח ונבדק בעזרת:

Google Mobile Ads SDK גרסה 11.11.0.
גרסת Pangle SDK‏ 6.3.0.6.

גרסה 6.2.0.9.0

תאימות מאומתת ל-Pangle SDK גרסה 6.2.0.9.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 11.10.0.
גרסת Pangle SDK‏ 6.2.0.9.

גרסה 6.2.0.8.0

תאימות מאומתת עם Pangle SDK בגרסה 6.2.0.8.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 11.10.0.
גרסת Pangle SDK‏ 6.2.0.8.

גרסה 6.2.0.7.0

תאימות מאומתת ל-Pangle SDK בגרסה 6.2.0.7.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 11.8.0.
גרסת Pangle SDK‏ 6.2.0.7.

גרסה 6.2.0.6.0

תאימות מאומתת ל-Pangle SDK בגרסה 6.2.0.6.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 11.8.0.
Pangle SDK גרסה 6.2.0.6.

גרסה 6.2.0.5.0

תאימות מאומתת ל-Pangle SDK בגרסה 6.2.0.5.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 11.8.0.
גרסת Pangle SDK‏ 6.2.0.5.

גרסה 6.1.0.6.0

תאימות מאומתת ל-Pangle SDK גרסה 6.1.0.6.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 11.7.0.
גרסת Pangle SDK‏ 6.1.0.6.

גרסה 6.1.0.5.0

תאימות מאומתת ל-Pangle SDK בגרסה 6.1.0.5.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK גרסה 11.6.0.
גרסת Pangle SDK‏ 6.1.0.5.

גרסה 6.1.0.4.0

תאימות מאומתת ל-Pangle SDK בגרסה 6.1.0.4.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 11.6.0.
גרסת Pangle SDK‏ 6.1.0.4.

גרסה 6.0.0.6.0

תאימות מאומתת ל-Pangle SDK בגרסה 6.0.0.6.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 11.6.0.
Pangle SDK גרסה 6.0.0.6.

גרסה 6.0.0.5.0

תאימות מאומתת ל-Pangle SDK גרסה 6.0.0.5.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 11.5.0.
Pangle SDK גרסה 6.0.0.5.

גרסה 6.0.0.4.0

תאימות מאומתת ל-Pangle SDK בגרסה 6.0.0.4.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 11.5.0.
Pangle SDK גרסה 6.0.0.4.

גרסה 5.9.0.9.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.9.0.9.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 11.5.0.
גרסת Pangle SDK‏ 5.9.0.9.

גרסה 5.9.0.8.0

תאימות מאומתת עם Pangle SDK בגרסה 5.9.0.8.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 11.4.0.
Pangle SDK גרסה 5.9.0.8.

גרסה 5.9.0.7.0

תאימות מאומתת ל-Pangle SDK גרסה 5.9.0.7.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 11.3.0.
גרסת Pangle SDK‏ 5.9.0.7.

גרסה 5.8.0.8.0

תאימות מאומתת עם Pangle SDK בגרסה 5.8.0.8.
מתאם מעודכן שמשתמש בממשק ה-API החדש לאיסוף אותות של Pangle SDK.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 11.2.0.
Pangle SDK גרסה 5.8.0.8.

גרסה 5.8.0.7.0

תאימות מאומתת עם Pangle SDK בגרסה 5.8.0.7.
נדרשת עכשיו גרסת iOS 12.0 מינימלית.
מעכשיו נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
Info.plist נכלל במסגרות שב-PangleAdapter.xcframework.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 11.0.1.
גרסת Pangle SDK‏ 5.8.0.7.

גרסה 5.7.0.7.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.7.0.7.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 10.14.0.
גרסת Pangle SDK‏ 5.7.0.7.

גרסה 5.7.0.6.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.7.0.6.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 10.14.0.
גרסת Pangle SDK‏ 5.7.0.6.

גרסה 5.6.0.8.0

תאימות מאומתת עם Pangle SDK בגרסה 5.6.0.8.
שינינו את השיטה +setCOPPA על ידי החלפת המאפיין adConfiguration.childDirectedTreatment, שהוצא משימוש, במאפיין GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment החדש.

הקוד נוצר ונבדק באמצעות:

גרסה 10.14.0 של Google Mobile Ads SDK
גרסת Pangle SDK‏ 5.6.0.8.

גרסה 5.5.0.9.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.5.0.9.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 10.13.0.
גרסת Pangle SDK‏ 5.5.0.9.

גרסה 5.5.0.7.0

תאימות מאומתת ל-Pangle SDK גרסה 5.5.0.7.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK גרסה 10.12.0.
Pangle SDK גרסה 5.5.0.7.

גרסה 5.5.0.5.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.5.0.5.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 10.11.0.
Pangle SDK גרסה 5.5.0.5.

גרסה 5.4.1.1.0

הוספנו תמיכה בבידינג בפורמט מודעות לפתיחת אפליקציה.
תאימות מאומתת ל-Pangle SDK בגרסה 5.4.1.1.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 10.10.0.
גרסת Pangle SDK‏ 5.4.1.1.

גרסה 5.4.0.9.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.4.0.9.

פותח ונבדק בעזרת:

Google Mobile Ads SDK גרסה 10.9.0.
גרסת Pangle SDK‏ 5.4.0.9.

גרסה 5.4.0.8.0

תוקנה בעיה שבה GADPangleNetworkExtras לא עמד בדרישות לפרוטוקול GADAdNetworkExtras.
הטמעת שיטת פרוטוקול adDidShowFail במודעות מעברון, במודעות מתגמלות ובמודעות בפתיחת אפליקציה.
תאימות מאומתת ל-Pangle SDK בגרסה 5.4.0.8.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 10.9.0.
Pangle SDK גרסה 5.4.0.8.

גרסה 5.3.1.2.0

תאימות מאומתת ל-Pangle SDK גרסה 5.3.1.2.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 10.8.0.
Pangle SDK גרסה 5.3.1.2.

גרסה 5.3.1.0.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.3.1.0.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK גרסה 10.8.0.
גרסת Pangle SDK‏ 5.3.1.0.

גרסה 5.2.1.1.0

תאימות מאומתת עם Pangle SDK בגרסה 5.2.1.1.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 10.7.0.
גרסת Pangle SDK‏ 5.2.1.1.

גרסה 5.2.0.9.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.2.0.9.

הקוד נוצר ונבדק באמצעות:

גרסה 10.5.0 של Google Mobile Ads SDK.
גרסת Pangle SDK‏ 5.2.0.9.

גרסה 5.2.0.8.0

תאימות מאומתת ל-Pangle SDK גרסה 5.2.0.8.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 10.5.0.
גרסת Pangle SDK‏ 5.2.0.8.

גרסה 5.2.0.7.0

נוספה תמיכה במפל המים לפורמטים של מודעות בפתיחת אפליקציה, מודעות באנר (כולל מודעות MREC), מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
תאימות מאומתת ל-Pangle SDK גרסה 5.2.0.7.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 10.5.0.
גרסת Pangle SDK‏ 5.2.0.7.

גרסה 5.2.0.6.0

תאימות מאומתת ל-Pangle SDK גרסה 5.2.0.6.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 10.5.0.
גרסת Pangle SDK‏ 5.2.0.6.

גרסה 5.1.1.0.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.1.1.0.
הוספנו תמיכה בארכיטקטורה של הסימולטור arm64.
מעכשיו נדרשת גרסה 10.4.0 ואילך של Google Mobile Ads SDK.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 10.4.0.
גרסת Pangle SDK‏ 5.1.1.0.

גרסה 5.1.0.6.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.1.0.6.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 10.3.0.
גרסת Pangle SDK‏ 5.1.0.6.

גרסה 5.0.1.0.0

תאימות מאומתת ל-Pangle SDK גרסה 5.0.1.0.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 10.2.0.
גרסת Pangle SDK‏ 5.0.1.0.

גרסה 5.0.0.8.0

תאימות מאומתת ל-Pangle SDK גרסה 5.0.0.8.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 10.2.0.
גרסת Pangle SDK‏ 5.0.0.8.

גרסה 5.0.0.7.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.0.0.7.

הקוד נוצר ונבדק באמצעות:

גרסה 10.1.0 של Google Mobile Ads SDK.
גרסת Pangle SDK‏ 5.0.0.7.

גרסה 5.0.0.6.0

תאימות מאומתת ל-Pangle SDK בגרסה 5.0.0.6.

הקוד נוצר ונבדק באמצעות:

גרסה 10.1.0 של Google Mobile Ads SDK.
גרסת Pangle SDK‏ 5.0.0.6.

גרסה 4.9.1.0.0

הוסרה התמיכה בארכיטקטורה armv7.
תאימות מאומתת ל-Pangle SDK גרסה 4.9.1.0.
עכשיו נדרשת גרסת iOS 12.0 מינימלית.
מעכשיו נדרשת גרסה 10.0.0 ואילך של Google Mobile Ads SDK.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 10.0.0.
גרסת Pangle SDK‏ 4.9.1.0.

גרסה 4.9.0.8.0

תאימות מאומתת ל-Pangle SDK בגרסה 4.9.0.8.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 9.14.0.
גרסת Pangle SDK‏ 4.9.0.8.

גרסה 4.9.0.7.0

תאימות מאומתת ל-Pangle SDK בגרסה 4.9.0.7.

הקוד נוצר ונבדק באמצעות:

גרסה 9.14.0 של Google Mobile Ads SDK
גרסת Pangle SDK‏ 4.9.0.7.

גרסה 4.9.0.6.0

תאימות מאומתת ל-Pangle SDK בגרסה 4.9.0.6.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 9.14.0.
גרסת Pangle SDK‏ 4.9.0.6.

גרסה 4.8.1.0.0

תאימות מאומתת עם גרסת Pangle SDK 4.8.1.0.

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 9.14.0.
גרסת Pangle SDK‏ 4.8.1.0.

גרסה 4.8.0.9.0

תאימות מאומתת ל-Pangle SDK גרסה 4.8.0.9.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 9.13.0.
Pangle SDK גרסה 4.8.0.9.

גרסה 4.8.0.7.0

תאימות מאומתת ל-Pangle SDK בגרסה 4.8.0.7.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK גרסה 9.13.0.
גרסת Pangle SDK‏ 4.8.0.7.

גרסה 4.8.0.6.0

תאימות מאומתת ל-Pangle SDK גרסה 4.8.0.6.
תוקנה בעיה שבה השרשור הראשי נחסם בזמן טעינת התמונה של סמל המודעה המובנית.

פותח ונבדק בעזרת:

Google Mobile Ads SDK גרסה 9.13.0.
גרסת Pangle SDK‏ 4.8.0.6.

גרסה 4.7.0.7.0

תאימות מאומתת ל-Pangle SDK בגרסה 4.7.0.7.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 9.11.0.
גרסת Pangle SDK‏ 4.7.0.7.

גרסה 4.7.0.6.0

תאימות מאומתת ל-Pangle SDK בגרסה 4.7.0.6.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 9.11.0.
גרסת Pangle SDK‏ 4.7.0.6.

גרסה 4.7.0.5.0

תאימות מאומתת ל-Pangle SDK גרסה 4.7.0.5.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 9.11.0.
גרסת Pangle SDK‏ 4.7.0.5.

גרסה 4.7.0.4.0

תאימות מאומתת ל-Pangle SDK בגרסה 4.7.0.4.

הקוד נוצר ונבדק באמצעות:

Google Mobile Ads SDK בגרסה 9.10.0.
גרסת Pangle SDK‏ 4.7.0.4.

גרסה 4.6.2.2.0

השם של השיטות setGDPR() ו-setCCPA() מהקלאס GADMediationAdapterPangle השתנה ל-setGDPRConsent() ול-setDoNotSell, בהתאמה.
תאימות מאומתת ל-Pangle SDK בגרסה 4.6.2.2.

פותח ונבדק בעזרת: