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

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

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

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

דרישות

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

• ה-SDK העדכני של Google Mobile Ads

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

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

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

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

מנווטים לכרטיסייה Applications (אפליקציות) ולוחצים על הלחצן Add App (הוספת אפליקציה).

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

חשוב לזכור מהו מזהה האפליקציה של האפליקציה שלכם.

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

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

איתור מפתח ה-API של Pangle Reporting

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• מוסיפים את השורה הבאה ל-Podfile של הפרויקט:

  pod 'GoogleMobileAdsMediationPangle'
  

• מריצים את שורת הפקודה:

  pod install --repo-update

שילוב ידני

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

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

שילוב של SKAdNetwork

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

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

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

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

אימות מודעות בדיקה

כדי לוודא שמוצגות לך מודעות לבדיקה מ-Pangle, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Pangle (Bidding) and Pangle (Waterfall) מקורות המודעות.

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

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

רינדור המודעות

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

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

קודי שגיאה

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

GADMediationAdapterPangle

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

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

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

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

• גרסה 11.4.0 של Google Mobile Ads SDK.
• 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 כלול ב-frameworks בתוך PangleAdapter.xcframework.

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

• גרסה 11.0.1 של Google Mobile Ads SDK.
• Pangle SDK גרסה 5.8.0.7.

גרסה 5.7.0.7.0

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

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

• גרסה 10.14.0 של Google Mobile Ads SDK
• Pangle SDK גרסה 5.7.0.7.

גרסה 5.7.0.6.0

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

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

• גרסה 10.14.0 של Google Mobile Ads SDK
• 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.

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

• גרסה 10.10.0 של Google Mobile Ads SDK.
• 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.

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

• גרסה 10.7.0 של Google Mobile Ads SDK.
• 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.

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

• גרסה 10.5.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 5.2.0.8.

גרסה 5.2.0.7.0

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

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

• גרסה 10.5.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 5.2.0.7.

גרסה 5.2.0.6.0

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

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

• גרסה 10.5.0 של Google Mobile Ads SDK.
• 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.

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

• גרסה 10.4.0 של Google Mobile Ads SDK.
• 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.

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

• גרסה 10.2.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 5.0.1.0.

גרסה 5.0.0.8.0

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

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

• גרסה 10.2.0 של Google Mobile Ads SDK.
• 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 מינימלית.
• כדי להשתמש בתכונה הזו, צריך עכשיו להשתמש ב-Google Mobile Ads SDK בגרסה 10.0.0 ואילך.

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

• Google Mobile Ads SDK גרסה 10.0.0.
• Pangle SDK גרסה 4.9.1.0.

גרסה 4.9.0.8.0

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

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

• גרסה 9.14.0 של Google Mobile Ads SDK
• 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.

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

• גרסה 9.14.0 של Google Mobile Ads SDK
• Pangle SDK גרסה 4.9.0.6.

גרסה 4.8.1.0.0

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

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

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

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

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

גרסה 4.7.0.7.0

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

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

• גרסה 9.11.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.7.0.7.

גרסה 4.7.0.6.0

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

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

• גרסה 9.11.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.7.0.6.

גרסה 4.7.0.5.0

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

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

• גרסה 9.11.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.7.0.5.

גרסה 4.7.0.4.0

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

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

• גרסה 9.10.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.7.0.4.

גרסה 4.6.2.2.0

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

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

• גרסה 9.10.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.6.2.2.

גרסה 4.6.1.8.0

• תאימות מאומתת ל-Pangle SDK גרסה 4.6.1.8.
• נוספה תמיכה בבידינג בפורמט של מודעות מותאמות.
• המתאם עודכן לשימוש ב-API של didRewardUser.
• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 9.8.0 ואילך של Google Mobile Ads SDK.

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

• Google Mobile Ads SDK גרסה 9.9.0.
• Pangle SDK גרסה 4.6.1.8.

גרסה 4.5.2.8.0

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

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

• גרסה 9.7.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.5.2.8.

גרסה 4.5.2.7.0

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

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

• גרסה 9.7.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.5.2.7.

גרסה 4.5.2.5.0

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

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

• גרסה 9.6.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.5.2.5.

גרסה 4.5.2.4.0

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

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

• גרסה 9.6.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.5.2.4.

גרסה 4.5.2.3.0

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

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

• גרסה 9.6.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.5.2.3.

גרסה 4.5.1.3.0

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

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

• גרסה 9.5.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.5.1.3.

גרסה 4.3.1.9.0

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

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

• Google Mobile Ads SDK גרסה 9.3.0.
• Pangle SDK גרסה 4.3.1.9.

גרסה 4.3.0.5.0

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

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

• גרסה 9.2.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.3.0.5.

גרסה 4.3.0.4.0

• זו הגרסה הראשונה
• נוספה תמיכה בבידינג עבור מודעות באנר (כולל MREC), מודעות מעברון ומודעות מתגמלות.

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

• גרסה 9.1.0 של Google Mobile Ads SDK.
• Pangle SDK גרסה 4.3.0.4.