במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Pangle באמצעות תהליך בחירת הרשת ב-AdMob, שכולל גם שילובים של Waterfall וגם שילובים של בידינג. נסביר איך להוסיף את Pangle הגדרת הגישור של יחידת מודעות, ואיך לשלב את Pangle SDK מתאם לאפליקציה iOS .
השילובים והפורמטים של המודעות שנתמכים
המתאם לתהליך בחירת הרשת (Mediation) ב-Pangle כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
מודעות בפתיחת אפליקציה | 1 |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות | |
מותאם |
דרישות
- יעד הפריסה של iOS מגרסה 10.0 ואילך
ה-SDK העדכני של Google Mobile Ads
השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 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
שימוש ב-CocoaPods (מומלץ)
מוסיפים את השורה הבאה ל-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.