במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Liftoff Monetize באמצעות תהליך בחירת הרשת, שכולל גם בידינג וגם שילובים של Waterfall. במאמר מוסבר איך להוסיף את Liftoff Monetize להגדרת בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של Vungle באפליקציהUnity .
השילובים והפורמטים של המודעות שנתמכים
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
מודעות בפתיחת האפליקציה | 1, 3 |
כרזה | 2 |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות | 2 |
1 בידינג השילוב של הפורמט הזה נמצא בגרסת בטא סגורה.
2 בידינג של הפורמט הזה הוא בגרסת בטא פתוחה.
3 השילוב של Waterfall בפורמט הזה נמצא בגרסת בטא סגורה.
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Unity 4 ומעלה
- (לבידינג): הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) עבור Liftoff Monetize 3.8.2 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity עבודה שהוגדר באמצעות Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של Liftoff Monetize
שלב 2: מגדירים את הביקוש ב-Liftoff Monetize ב AdMob ממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה Liftoff לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Liftoff לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-SDK של Vungle ואת המתאם של Liftoff Monetize
הורדת הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-Liftoff
אפשר לייצר הכנסות מקישור ההורדה
Changelog (יומן שינויים) ומחלצים את הקטע
GoogleMobileAdsVungleMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > (נכסים >) ייבוא חבילה >
חבילה מותאמת אישית ואיתור הקובץ GoogleMobileAdsVungleMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.
בשלב הבא בוחרים באפשרות נכסים > המקודד של Play Services > מקודד Android >
סגירה ידנית. ספריית Unity Play Services Resolver תבצע פתרון של יחסי התלות מהתחלה ותעתיק את יחסי התלות שהוצהרו לתיקייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-Liftoff Monetize SDK
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection (הגנה על מידע כללי) של האיחוד האירופי התקנה (GDPR). כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שעשויים לאסוף, לקבל או להשתמש במידע אישי מספקים מידע על השימוש בכל רשת. ל-Google אין כרגע אפשרות להעביר את הבחירות של המשתמש בנושא פרטיות לרשתות כאלה באופן אוטומטי.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-Liftoff Monetize כולל שיטות שיעזרו לכם להעביר את פרטי ההסכמה ל-Vungle SDK. הקוד לדוגמה הבא מראה איך לצורך העברת פרטי ההסכמה ל-Vungle SDK. אם בוחרים לקרוא לזה מומלץ לעשות זאת לפני שליחת הבקשה להצגת מודעות באמצעות Google Mobile Ads SDK.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif
הוראות להטמעה מומלצת לפי GDPR פרטים נוספים זמינים ב-Android וב-iOS ואת הערכים שניתן לספק בשיטה.
חוקי פרטיות במדינות בארה"ב
ארה"ב חוקי הפרטיות במדינות צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. במדריך התאימות לחוקי הפרטיות במדינות ארה"ב מוסבר איך מפעילים עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת המודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-Liftoff Monetize כולל שיטות שיעזרו לכם להעביר את פרטי ההסכמה ל-Vungle SDK. הקוד לדוגמה הבא מראה איך לצורך העברת פרטי ההסכמה ל-Vungle SDK. אם בוחרים להפעיל את השיטה הזו, מומלץ לעשות זאת לפני שליחת בקשה להצגת מודעות דרך Google Mobile Ads SDK.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetCCPAStatus(true);
להוראות הטמעה מומלצות של CCPA לפרטים נוספים ול-Android ול-iOS בין הערכים שאפשר לציין ב-method.
שלב 5: מוסיפים את הקוד הנדרש
Android
לא נדרש קוד נוסף לשילוב עם Liftoff Monetize.
iOS
שילוב עם SKAdNetwork
עוקבים אחרי Liftoff Monetize
תיעוד
כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב Liftoff Monetize ממשק המשתמש.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-Liftoff Monetize, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) מקורות המודעות.
קודי שגיאה
אם המתאם לא מקבל מודעה מ-Liftoff Monetize, בעלי התוכן הדיגיטלי יכולים
לבדוק את השגיאה הבסיסית בתגובה למודעה באמצעות
ResponseInfo
במחלקות הבאות:
Android
פורמט | שם הכיתה |
---|---|
מודעות בפתיחת אפליקציה (בידינג) | com.google.ads.mediation.vungle.VungleMediationAdapter |
מודעות בפתיחת אפליקציה (Waterfall) | com.google.ads.mediation.vungle.VungleMediationAdapter |
מודעת באנר (בידינג) | com.google.ads.mediation.vungle.VungleMediationAdapter |
באנר (Waterfall) | com.vungle.mediation.VungleInterstitialAdapter |
מודעות מעברון (בידינג) | com.google.ads.mediation.vungle.VungleMediationAdapter |
מודעות מעברון (Waterfall) | com.vungle.mediation.VungleInterstitialAdapter |
מודעות מתגמלות (בידינג) | com.google.ads.mediation.vungle.VungleMediationAdapter |
מודעות מתגמלות (Waterfall) | com.vungle.mediation.VungleAdapter |
מודעות מעברון מתגמלות (בידינג) | com.google.ads.mediation.vungle.VungleMediationAdapter |
מודעות מעברון מתגמלות (Waterfall) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
פורמט | שם הכיתה |
---|---|
מודעות בפתיחת אפליקציה (בידינג) | GADMediationAdapterVungle |
מודעות בפתיחת אפליקציה (Waterfall) | GADMediationAdapterVungle |
מודעת באנר (בידינג) | GADMediationAdapterVungle |
באנר (Waterfall) | GADMAdapterVungleInterstitial |
מודעות מעברון (בידינג) | GADMediationAdapterVungle |
מודעות מעברון (Waterfall) | GADMAdapterVungleInterstitial |
מודעות מתגמלות (בידינג) | GADMediationAdapterVungle |
מודעות מתגמלות (Waterfall) | GADMAdapterVungleRewardBasedVideoAd |
מודעות מעברון מתגמלות (בידינג) | GADMediationAdapterVungle |
מודעות מעברון מתגמלות (Waterfall) | GADMediationAdapterVungle |
בטבלה הבאה מפורטים הקודים וההודעות הנלוות ל-Liftoff Monetize כשמודעה נכשלת להיטען:
Android
קוד שגיאה | סיבה |
---|---|
101 | פרמטרים לא חוקיים של השרת (למשל מזהה אפליקציה או מזהה מיקום מודעה). |
102 | גודל הבאנר המבוקש לא ממופה למודעת Liftoff Monetize חוקית גודל. |
103 | כדי לשלוח בקשה ב-Liftoff Monetize, צריך להוסיף הקשר Activity
מודעות. |
104 | לא ניתן לטעון ב-Vungle SDK כמה מודעות לאותו מיקום מודעה ID. |
105 | לא הצלחנו לאתחל את ה-SDK של Vungle. |
106 | הקריאה החוזרת (callback) של הטעינה החוזרת בוצעה בהצלחה, אבל Banners.getBanner() או Vungle.getNativeAd() החזירו null. |
107 | ה-SDK של Vungle לא מוכן להפעיל את המודעה. |
108 | Vungle SDK החזיר אסימון לא חוקי לבידינג. |
iOS
קוד שגיאה | סיבה |
---|---|
101 | פרמטרים לא חוקיים של השרת (למשל מזהה אפליקציה או מזהה מיקום מודעה). |
102 | כבר נטענה מודעה בהגדרת הרשת הזו. ה-SDK של Vungle לא יכול לטעון מודעה שנייה לאותו מזהה מיקום מודעה. |
103 | גודל המודעה המבוקש לא תואם לערך נתמך של Liftoff Monetize גודל הבאנר. |
104 | לא ניתן היה לעבד את מודעת הבאנר ב-Vungle SDK. |
105 | ה-SDK של Vungle תומך רק בחיוב של מודעה באנר אחת בכל פעם, ללא קשר למזהה מיקום המודעה. |
106 | נשלחה שיחה חוזרת מ-Vungle SDK ואומרת שלא ניתן להפעיל את המודעה. |
107 | ה-SDK של Vungle לא מוכן להפעיל את המודעה. |
אם מדובר בשגיאות שנובעות מ-Vungle SDK, יש לעיין במאמר קודי שגיאה: Vungle SDK ל-iOS ו-Android.
יומן שינויים של הפלאגין של תהליך בחירת הרשת ב-Liftoff Monetize
גרסה 5.2.1
- השם של
DummyClient
השתנה. השם החדש הואPlaceholderClient
. - יש תמיכה במתאם ל-Android של Liiftoff Monetize בגרסה 7.4.0.1.
- יש תמיכה במתאם ל-iOS של Liiftoff Monetize בגרסה 7.4.0.1.
- נוצר ונבדק באמצעות גרסה 9.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 5.2.0
- תמיכה במתאם Android של Liftoff Monetize בגרסה 7.4.0.0.
- תמיכה במתאם Liftoff Monetize ל-iOS בגרסה 7.4.0.0.
- נוצר ונבדק באמצעות גרסה 9.1.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 5.1.1
- יש תמיכה במתאם ל-Android של Liiftoff Monetize בגרסה 7.3.2.0.
- תמיכה במתאם Liftoff Monetize ל-iOS בגרסה 7.3.2.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 5.1.0
- תוקן באג ב-
NullPointerException
שגרם לכישלון build בזמן הייצוא כפרויקט ל-Android. - ממשקי ה-API לשמירה על פרטיות עודכנו:
- הסרת את השיטות
UpdateConsentStatus()
ו-UpdateCCPAStatus()
. - הוסרו הפריטים
VungleConsentStatus
ו-VungleCCPAStatus
. - עודכנה השיטה
SetGDPRStatus(bool)
ל-SetGDPRStatus(bool, String)
.
- הסרת את השיטות
- הסרת את השיטות הבאות מהכיתה
LiftoffMonetizeMediationExtras
:SetAllPlacements(String[])
SetSoundEnabled(bool)
- יש תמיכה במתאם ל-Android של Liiftoff Monetize בגרסה 7.3.1.0.
- יש תמיכה במתאם ל-iOS של Liiftoff Monetize בגרסה 7.3.1.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 5.0.0
- תוקנה אזהרה לגבי הגדרה כפולה של
MediationExtras
. - יש תמיכה במתאם ל-Android של Liiftoff Monetize בגרסה 7.1.0.0.
- יש תמיכה במתאם ל-iOS של Liiftoff Monetize בגרסה 7.2.1.1.
- נוצר ונבדק באמצעות גרסה 8.7.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.0.0
- פלאגין מיתוג מחדש של תהליך בחירת הרשת ב-Unity, מ-Vungle ל-Liftoff Monetize.
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/LiftoffMonetize/
. - מרחב השמות של המתאם עבר ארגון מחדש לשימוש ב-
GoogleMobileAds.Mediation.LiftoffMonetize
. - נוספו לכיתה
LiftoffMonetize
את השיטות הבאות:SetGDPRStatus(bool)
SetGDPRMessageVersion(String)
SetCCPAStatus(bool)
- יש תמיכה במתאם ל-Android של Liiftoff Monetize בגרסה 6.12.1.1.
- יש תמיכה במתאם ל-iOS של Liiftoff Monetize בגרסה 7.0.1.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.4.1.
גרסה 3.9.2
- הכיתה
Vungle
עודכנה:- נוספה השיטה
UpdateCCPAStatus(VungleCCPAStatus)
. - השיטה
GetCurrentConsentStatus()
הוסרה. - השיטה
GetCurrentConsentMessageVersion()
הוסרה.
- נוספה השיטה
- תמיכה במתאם Vungle ל-Android בגרסה 6.12.1.0.
- תומכת בגרסה 6.12.2.0 של מתאם Vungle ל-iOS.
- נוצר ונבדק באמצעות גרסה 7.4.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.9.1
- תמיכה במתאם Vungle ל-Android בגרסה 6.12.1.0.
- תומכת בגרסה 6.12.1.1 של מתאם Vungle ל-iOS.
- נוצר ונבדק באמצעות גרסה 7.4.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.9.0
- תמיכה במתאם Vungle ל-Android מגרסה 6.12.0.0.
- תמיכה במתאם Vungle ל-iOS בגרסה 6.12.0.0.
- נוצר ונבדק באמצעות גרסה 7.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.8.2
- תמיכה במתאם Vungle ל-Android בגרסה 6.11.0.2.
- תמיכה במתאם Vungle ל-iOS בגרסה 6.11.0.1.
- נוצר ונבדק באמצעות גרסה 7.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.8.1
- תמיכה במתאם Vungle ל-Android מגרסה 6.11.0.1.
- תומכת בגרסה 6.11.0.0 של מתאם Vungle ל-iOS.
- נוצר ונבדק באמצעות גרסה 7.0.2 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.8.0
- תמיכה במתאם Vungle ל-Android גרסה 6.11.0.0.
- תומכת בגרסה 6.11.0.0 של מתאם Vungle ל-iOS.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.7.5
- תמיכה במתאם Vungle ל-Android בגרסה 6.10.5.0.
- תומכת בגרסה 6.10.6.1 של מתאם Vungle ל-iOS.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.7.4
- תמיכה במתאם Vungle ל-Android בגרסה 6.10.4.0.
- תמיכה במתאם Vungle ל-iOS בגרסה 6.10.6.1.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.7.3
- תמיכה במתאם Vungle ל-Android בגרסה 6.10.3.0.
- תמיכה במתאם Vungle ל-iOS בגרסה 6.10.5.1.
גרסה 3.7.2
גרסה 3.7.1
גרסה 3.7.0
- תמיכה במתאם Vungle ל-Android בגרסה 6.10.2.0.
- תומכת במתאם Vungle ל-iOS בגרסה 6.10.3.0.
גרסה 3.6.0
- תמיכה במתאם Vungle ל-Android בגרסה 6.9.1.1.
- תומכת בגרסה 6.9.2.0 של מתאם Vungle ל-iOS.
גרסה 3.5.1
- תמיכה במתאם Vungle ל-Android בגרסה 6.8.1.0.
- תומכת בגרסה 6.8.1.0 של מתאם Vungle ל-iOS.
גרסה 3.5.0
- תמיכה במתאם Vungle ל-Android בגרסה 6.8.0.0.
- תומכת בגרסה 6.8.0.0 של מתאם Vungle ל-iOS.
גרסה 3.4.1
- תמיכה במתאם Vungle ל-Android בגרסה 6.7.1.0.
- תומכת בגרסה 6.7.1.0 של מתאם Vungle ל-iOS.
גרסה 3.4.0
- תמיכה במתאם Vungle ל-Android בגרסה 6.7.0.0.
- תומכת בגרסה 6.7.0.0 של מתאם Vungle ל-iOS.
גרסה 3.3.1
- נארז מחדש את
vungle-extras-library.jar
אלvungle-unity-android-library.aar
, באמצעות גרסת build של.aar
לתמיכה ב-Unity 2020.- כשמשדרגים לגרסה הזו, צריך להסיר את
vungle-extras-library.jar
מהפרויקט.
- כשמשדרגים לגרסה הזו, צריך להסיר את
- תמיכה במתאם ל-Android של Vungle בגרסה 6.5.3.0.
- תומכת במתאם Vungle ל-iOS בגרסה 6.5.3.0.
גרסה 3.3.0
גרסה 3.2.0
- תמיכה במתאם Vungle ל-Android בגרסה 6.4.11.1.
- תמיכה במתאם Vungle ל-iOS בגרסה 6.4.6.0.
גרסה 3.1.4
- תומך בגרסה 6.3.24.1 של מתאם Android.
- תמיכה במתאם iOS מגרסה 6.3.2.3.
גרסה 3.1.3
- תמיכה במתאם Android בגרסה 6.3.24.1.
- תומך בגרסה 6.3.2.2 של מתאם iOS.
גרסה 3.1.2
- עדכנו את הפלאגין כך שיתמוך ב-Rewarded API החדש בגרסת בטא פתוחה.
- תמיכה במתאם Android בגרסה 6.3.24.1.
- תומך בגרסה 6.3.2.1 של מתאם iOS.
גרסה 3.1.1
- תומך בגרסה 6.3.24.0 של מתאם Android.
- יש תמיכה בגרסה 6.3.2.0 של מתאם iOS.
- ה-method
Vungle.UpdateConsentStatus()
עודכנה כדי שהפרמטרconsentMessageVersion
יהיה אופציונלי. המערכת של iOS מתעלמת עכשיו מהערך שלconsentMessageVersion
. - הוצא משימוש
Vungle.GetCurrentConsentMessageVersion()
ל-iOS.
גרסה 3.1.0
- תומך בגרסה 6.3.17.0 של מתאם Android.
- יש תמיכה בגרסה 6.3.0.0 של מתאם iOS.
- השיטה
Vungle.UpdateConsentStatus()
עודכנה כדי להוסיף פרמטרString
נוסף לגרסת ההודעה לבקשת הסכמה שסופקה על ידי המפרסם. - נוספה השיטה
Vungle.GetCurrentConsentMessageVersion()
כדי לקבל את הגרסה של הודעת ההסכמה שסופקה על ידי בעל התוכן הדיגיטלי.
גרסה 3.0.1
- תומך בגרסה 6.2.5.1 של מתאם Android.
- יש תמיכה בגרסה 6.2.0.3 של מתאם iOS.
גרסה 3.0.0
- התמיכה במתאם ל-Android מגיעה לגרסה 6.2.5.0.
- יש תמיכה בגרסה 6.2.0.2 של מתאם iOS.
- הוספנו את השיטות הבאות:
- שיטה
Vungle.UpdateConsentStatus()
להגדרת סטטוס ההסכמה שיתועד ב-Vungle SDK. - שיטה אחת (
Vungle.GetCurrentConsentStatus()
) לקבלת סטטוס ההסכמה הנוכחי של המשתמש.
- שיטה
גרסה 2.0.0
- יש תמיכה במתאם Android בגרסה 5.3.2.1.
- יש תמיכה בגרסה 6.2.0.0 של מתאם iOS.
גרסה 1.1.0
- תומך בגרסה 5.3.2.1 של מתאם Android.
- יש תמיכה בגרסה 5.4.0.0 של מתאם iOS.
גרסה 1.0.0
- גרסה ראשונה!
- יש תמיכה בגרסה 5.3.0.0 של מתאם ל-Android.
- יש תמיכה בגרסה 5.3.0.0 של מתאם iOS.