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

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

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

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

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

דרישות

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

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

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

Configure mediation settings for your ad unit

You need to add Pangle to the mediation configuration for your ad unit.

First, sign in to your AdMob account. Next, navigate to the Mediation tab. If you have an existing mediation group you'd like to modify, click the name of that mediation group to edit it, and skip ahead to Add Pangle as an ad source.

To create a new mediation group, select Create Mediation Group.

Enter your ad format and platform, then click Continue.

Give your mediation group a name, and select locations to target. Next, set the mediation group status to Enabled, and then click Add Ad Units.

Associate this mediation group with one or more of your existing AdMob ad units. Then click Done.

You should now see the ad units card populated with the ad units you selected:

Add Pangle as an ad source

Bidding

Under the Bidding card in the Ad Sources section, select Add Ad Source. Then select Pangle.

Click How to sign a partnership agreement and set up a bidding partnership with Pangle.

Click Acknowledge & agree, then click Continue.

If you already have a mapping for Pangle, you can select it. Otherwise, click Add mapping.

Next, enter the App ID and Ad Placement ID obtained in the previous section. Then click Done.

Waterfall

Under the Waterfall card in the Ad Sources section, select Add Ad Source. Then select Pangle.

Select Pangle. Then enter an eCPM value for Pangle and click Continue.

If you already have a mapping for Pangle, you can select it. Otherwise, click Add mapping.

Next, enter the App ID and Ad Placement ID obtained in the previous section. Then click Done.

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

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

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

    pod install --repo-update

שילוב ידני

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

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

שילוב של SKAdNetwork

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

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

Enable test ads

Make sure you register your test device for AdMob and enable test mode in Pangle UI.

Verify test ads

To verify that you are receiving test ads from Pangle, enable single ad source testing in ad inspector using the Pangle (Bidding) and Pangle (Waterfall) ad source(s).

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

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

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

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

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

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

קודי שגיאה

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

GADMediationAdapterPangle

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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