במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Unity Ads באמצעות תהליך בחירת הרשת, כולל שילובים של רשתות מודעות ב-Waterfall. במדריך מוסבר איך להוסיף את Unity Ads להגדרות בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של Unity Ads באפליקציה ל-Android.
השילובים והפורמטים של המודעות הנתמכים
למתאם התאמת הרשת של Unity Ads יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | 1 |
מפל | |
פורמטים | |
מודעת באנר | |
מעברון | |
ההטבה הופעלה | |
מותאם |
1 השילוב של הבידינג נמצא בגרסת בטא סגורה. כדי לבקש גישה, פנו למנהל החשבון שלכם.
דרישות
- Android API ברמה 21 ואילך
- [For bidding]: כדי לשלב את כל הפורמטים הנתמכים של המודעות בבידינג, צריך להשתמש במתאם Unity מגרסה 4.12.5.1 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)
הגרסה העדכנית ביותר של Google Mobile Ads SDK
מדריך לתחילת העבודה בנושא בחירת הרשת
שלב 1: הגדרת ההגדרות בממשק המשתמש של Unity Ads
נרשמים או נכנסים ל-Unity Ads.
יצירת פרויקט
במרכז הבקרה של Unity Ads, עוברים אל Projects ולוחצים על Create Project.
ממלאים את הטופס ולוחצים על Create Project (יצירת פרויקט) כדי להוסיף את הפרויקט.
עוברים אל מונטיזציה > תחילת העבודה ולוחצים על תחילת העבודה.
בחלון הדו-שיח Project Setup, בוחרים באפשרות I plan to use Mediation (אני מתכנן להשתמש בתהליך בחירת הרשת) ובאפשרות Google AdMob עבור Mediation Partner (שותף תהליך בחירת הרשת), ואז לוחצים על Next (הבא).
בוחרים את הגדרות המודעות ולוחצים על הבא.
ממלאים את הטופס ולוחצים על הוספת פרויקט.
שימו לב למזהה המשחק.
יצירת יחידת מודעות
עוברים אל מונטיזציה > יחידות מודעות ולוחצים על הוספת יחידת מודעות.
מזינים שם של יחידת מודעות ובוחרים את הפלטפורמה ואת פורמט המודעה.
בסיום, לוחצים על יצירה כדי לשמור את יחידת המודעות.
הוספת מיקום מודעה
אחרי שיוצרים את הפרויקט, עוברים אל Monetization (מונטיזציה) > Placements (מיקומי מודעות). כדי ליצור מיקום מודעה חדש, לוחצים על Add Placement (הוספת מיקום מודעה) עבור יחידת המודעות.
ממלאים את הפרטים הנדרשים ולוחצים על הוספת מיקום.
שימו לב למזהה המיקום.
איתור מפתח Reporting API של Unity Ads
בידינג
השלב הזה לא נדרש לשילובי בידינג.
מפל
בנוסף למזהה המשחק ולמזהה מיקום המודעה, תצטרכו גם את מפתח ה-API ומזהה הליבה של הארגון ב-Unity Ads כדי להגדיר את מזהה יחידת המודעות ב-Ad Manager.
עוברים אל Monetization > Setup > API Management ומתעדים את מפתח הגישה ל-Monetization Stats API.
לאחר מכן, עוברים אל Monetization (מונטיזציה) > Organization Settings (הגדרות הארגון) ומתעדים את Organization core ID (מזהה הליבה של הארגון).
הפעלת מצב בדיקה
אפשר להפעיל את מצב הבדיקה דרך מרכז הבקרה של Unity Ads. בהגדרות הפרויקט, בוחרים בכרטיסייה Testing.
כדי לאלץ את מצב הבדיקה באפליקציה, לוחצים על לחצן העריכה לצד Google Play Store, מסמנים את התיבה Override client test mode ובוחרים באפשרות Force test mode ON (i.e. use test ads) for all devices.
לחלופין, אפשר להפעיל את מצב הבדיקה במכשירים ספציפיים בלחיצה על הלחצן הוספת מכשיר בדיקה.
ממלאים את הטופס ולוחצים על שמירה.
שלב 2: הגדרת הביקוש מ-Unity Ads בממשק המשתמש של Ad Manager
נכנסים לחשבון Ad Manager.
הוספת Unity Ads ב'חברות'
בידינג
השלב הזה לא נדרש לשילובי בידינג.
מפל
עוברים אל ניהול > חברות, ולוחצים על הלחצן חברה חדשה בכרטיסייה כל החברות. בוחרים באפשרות רשת מודעות.
בוחרים באפשרות Unity Ads בתור רשת המודעות, מזינים שם ייחודי ומפעילים את בחירת הרשת. מפעילים את האפשרות איסוף נתונים אוטומטי ומזינים את מפתח ה-API ומזהה הליבה של הארגון שהתקבלו בקטע הקודם.
אין צורך להזין שם משתמש או סיסמה. בסיום, לוחצים על שמירה.
הפעלת שיתוף אותות מאובטחים
בידינג
עוברים אל ניהול > הגדרות גלובליות. עוברים לכרטיסייה הגדרות חשבון Ad Exchange, בודקים את ההגדרה שיתוף אותות מאובטח ומפעילים אותה. לוחצים על שמירה.
מפל
השלב הזה לא נדרש בשילובים של Waterfall.
הגדרת בידינג ב-Unity Ads
בידינג
עוברים אל Delivery (הצגה) > Bidders (מגישי הצעות מחיר), ולוחצים על New bidder (מגיש הצעות מחיר חדש) בכרטיסייה SDK Bidding (בידינג באמצעות SDK).
בוחרים באפשרות Unity Ads בתור הבידינג.
מפעילים את המתגים הוספת ספריית האותות של מגיש הצעות המחיר הזה לרשימת האותות המותרים ואישור שיתוף האותות עם מגיש הצעות המחיר הזה. לאחר מכן, לוחצים על המשך.
לוחצים על המשך.
לוחצים על סיום.
מפל
השלב הזה לא נדרש בשילובים של Waterfall.
הגדרת מיפוי של יחידות מודעות
בידינג
עוברים אל Delivery > Bidders ובוחרים את החברה של Unity Ads בכרטיסייה SDK Bidding.
עוברים לכרטיסייה מיפוי יחידות של מודעות ולוחצים על מיפוי חדש של יחידות של מודעות.
בוחרים באפשרות יחידת מודעות ספציפית. בוחרים יחידת מודעות ופורמט, את האפשרות אפליקציה לנייד בתור סוג מלאי שטחי הפרסום ואת האפליקציה לנייד. לאחר מכן, מזינים את מזהה המשחק ואת מזהה מיקום המודעה שהתקבלו בקטע הקודם. בסיום, לוחצים על שמירה.
מפל
עוברים אל Delivery (הצגה) > Yield groups (קבוצות תשואה) ולוחצים על הלחצן New yield group (קבוצת תשואה חדשה). בוחרים את האפליקציה לנייד.
גוללים למטה ולוחצים על הוספת שותף להגדלת התשואה.
בוחרים את החברה שיצרתם ב-Unity Ads בקטע הקודם. בוחרים באפשרות Mobile SDK mediation בתור סוג השילוב, באפשרות Android בתור פלטפורמה ובאפשרות Active בתור סטטוס.
מזינים את מזהה המשחק ואת מזהה מיקום המודעה שהתקבלו בקטע הקודם, ואת הערך של Default CPM. לוחצים על שמירה.
הערה: האיסוף האוטומטי של הנתונים נמשך כמה ימים, עד שאפשר לחשב בצורה מדויקת את ערך העלות לדינמי לאלף חשיפות ברשת בחירת הרשת. ברגע שאפשר יהיה לחשב את העלות בפועל לאלף חשיפות, היא תתעדכן בשמכם באופן אוטומטי.
הוספת Unity Ads לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות ארה"ב
פועלים לפי השלבים שמפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את Unity Ads לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב בממשק המשתמש של Ad Manager.
שלב 3: מייבאים את ה-SDK ואת המתאם של Unity Ads
שילוב עם Android Studio (מומלץ)
בקובץ build.gradle.kts
ברמת האפליקציה, מוסיפים את יחסי התלות וההגדרות הבאים להטמעה. להשתמש בגרסאות העדכניות ביותר של ה-SDK והמתאם של Unity Ads:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.unity3d.ads:unity-ads:4.12.5")
implementation("com.google.ads.mediation:unity:4.12.5.1")
}
שילוב ידני
מורידים את Unity Ads SDK (
unity-ads.aar
) העדכני ביותר ממאגר GitHub ומוסיפים אותו לפרויקט.עוברים אל Unity Ads adapter artifacts במאגר Maven של Google. בוחרים את הגרסה האחרונה, מורידים את הקובץ
.aar
של מתאם Unity Ads ומוסיפים אותו לפרויקט.
שלב 4: הטמעת הגדרות הפרטיות ב-Unity Ads SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, אתם צריכים לוודא שהמשתמשים באזור הכלכלי האירופי (EEA) מקבלים גילויים נאותים מסוימים לגבי השימוש במזהי מכשירים ובמידע אישי, ומאשרים את השימוש הזה. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש של כל רשת. בשלב זה, Google לא יכולה להעביר את הבחירה של המשתמש בנושא הסכמה לרשתות כאלה באופן אוטומטי.
בגרסה 2.0.0 של ה-SDK, הוספנו ל-Unity Ads ממשק API לתמיכה בהגדרות הפרטיות. דוגמת הקוד הבאה מראה איך להעביר את פרטי ההסכמה האלה ל-Unity Ads SDK. אם בוחרים להעביר את פרטי ההסכמה ל-Unity Ads SDK באופן ידני, מומלץ להפעיל את הקוד הזה לפני שליחת בקשה להצגת מודעות דרך Google Mobile Ads SDK.
Java
import com.unity3d.ads.metadata.MetaData;
// ...
MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
Kotlin
import com.unity3d.ads.metadata.MetaData
// ...
val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
פרטים נוספים על הערכים שאפשר לספק בכל שיטה מופיעים במדריך Privacy Consent and data APIs ובמדריך Complying with GDPR של Unity Ads.
חוקי פרטיות במדינות בארה"ב
חוקי הפרטיות במדינות ארה"ב מחייבים לתת למשתמשים את הזכות לבטל את ההסכמה למכירת 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). האפשרות לבטל את ההסכמה חייבת להיות מוצגת בקישור בולט עם הכיתוב 'אל תמכרו את המידע האישי שלי' בדף הבית של הצד המוֹכֵר. במדריך התאימות לחוקי הפרטיות במדינות ארה"ב מוסבר איך מפעילים עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.
בגרסה 2.0.0 של ה-SDK, הוספנו ל-Unity Ads ממשק API לתמיכה בהגדרות הפרטיות. דוגמת הקוד הבאה מראה איך להעביר את פרטי ההסכמה האלה ל-Unity Ads SDK. אם בוחרים להעביר את פרטי ההסכמה ל-Unity Ads SDK באופן ידני, מומלץ להפעיל את הקוד הזה לפני שליחת בקשה להצגת מודעות דרך Google Mobile Ads SDK.
Java
import com.unity3d.ads.metadata.MetaData;
// ...
MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
Kotlin
import com.unity3d.ads.metadata.MetaData
// ...
val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
פרטים נוספים על הערכים שאפשר לספק בכל שיטה מופיעים במדריך Privacy Consent and data APIs ובמדריך Complying with CCPA של Unity Ads.
שלב 5: מוסיפים את הקוד הנדרש
אין צורך בקוד נוסף לשילובים של Unity Ads.
שלב 6: בדיקה מעשית של ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-Ad Manager ולהפעיל את מצב הבדיקה בממשק המשתמש של Unity Ads.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-Unity Ads, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות Unity Ads (Bidding) ו-Unity Ads (Waterfall).
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-Unity Ads, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות ResponseInfo.getAdapterResponses()
, בקטגוריות הבאות:
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
אלה הקודים וההודעות שמופיעים במתאם UnityAds כשלא ניתן לטעון מודעה:
קוד שגיאה | סיבה |
---|---|
0-10 | UnityAds SDK החזיר שגיאה. פרטים נוספים זמינים במאמר קוד. |
101 | פרמטרים של שרת UnityAds שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים. |
102 | מערכת UnityAds החזירה מיקום מודעה במצב NO_FILL. |
103 | מערכת UnityAds החזירה מיקום מודעה במצב DISABLED. |
104 | מערכת UnityAds ניסתה להציג מודעה עם הקשר null. |
105 | ההקשר שמשמש להפעלה, לטעינה ו/או להצגת מודעות מ-Unity Ads הוא לא מופע של Activity. |
106 | מערכת UnityAds ניסתה להציג מודעה שלא מוכנה להצגה. |
107 | אין תמיכה ב-UnityAds במכשיר. |
108 | מערכת UnityAds יכולה לטעון רק מודעה אחת בכל מיקום מודעה בכל רגע נתון. |
109 | הקריאה ל-UnityAds הסתיימה במצב ERROR. |
200-204 | שגיאה ספציפית למודעות באנר של UnityAds. פרטים נוספים זמינים במאמר קוד. |
יומן השינויים של מתאם תהליך בחירת הרשת (Mediation) של Unity Ads ל-Android
גרסה 4.12.5.1
- תיקנו כשלים בטעינה של מודעות באנר לבידינג על ידי הגדרת מזהה האובייקט בזמן טעינת המודעות.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 23.6.0.
- Unity Ads SDK בגרסה 4.12.5.
גרסה 4.12.5.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.5.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 23.5.0.
- Unity Ads SDK בגרסה 4.12.5.
גרסה 4.12.4.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.4.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 23.3.0.
- Unity Ads SDK בגרסה 4.12.4.
גרסה 4.12.3.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.3.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 23.3.0.
- Unity Ads SDK בגרסה 4.12.3.
גרסה 4.12.2.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.2.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 23.2.0.
- Unity Ads SDK בגרסה 4.12.2.
גרסה 4.12.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.1.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 23.2.0.
- Unity Ads SDK בגרסה 4.12.1.
גרסה 4.12.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 23.1.0.
- Unity Ads SDK בגרסה 4.12.0.
גרסה 4.11.3.0
- הוספנו תמיכה בבידינג בפורמטים של מודעות באנר, מודעות מעברון ומודעות מתגמלות.
- תאימות מאומתת ל-Unity Ads SDK 4.11.3.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 23.1.0.
- Unity Ads SDK בגרסה 4.11.3.
גרסה 4.11.2.0
- תאימות מאומתת ל-Unity Ads SDK 4.11.2.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 23.0.0.
- Unity Ads SDK בגרסה 4.11.2.
גרסה 4.10.0.0
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-23.0.0.
- תאימות מאומתת ל-Unity Ads SDK 4.10.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 23.0.0.
- Unity Ads SDK בגרסה 4.10.0.
גרסה 4.9.3.0
- תאימות מאומתת ל-Unity Ads SDK 4.9.3.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 22.6.0.
- Unity Ads SDK בגרסה 4.9.3.
גרסה 4.9.2.0
- תאימות מאומתת ל-Unity Ads SDK 4.9.2.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 22.3.0.
- Unity Ads SDK בגרסה 4.9.2.
גרסה 4.9.1.0
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 22.3.0.
- תאימות מאומתת ל-Unity Ads SDK 4.9.1.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 22.3.0.
- Unity Ads SDK בגרסה 4.9.1.
גרסה 4.8.0.0
- האירוע הזה מדווח על חשיפת מודעה כש-Unity Ads SDK מפעיל את שיטת ה-callback החדשה שלו, onBannerShown().
- תאימות מאומתת ל-Unity Ads SDK 4.8.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 22.2.0.
- Unity Ads SDK בגרסה 4.8.0.
גרסה 4.7.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.7.1.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 22.1.0.
- Unity Ads SDK בגרסה 4.7.1.
גרסה 4.7.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.7.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 22.0.0.
- Unity Ads SDK בגרסה 4.7.0.
גרסה 4.6.1.1
- המתאם עודכן כך שישתמש בכיתה החדשה
VersionInfo
. - עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-22.0.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 22.0.0.
- Unity Ads SDK בגרסה 4.6.1.
גרסה 4.6.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.6.1.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 21.5.0
- Unity Ads SDK בגרסה 4.6.1.
גרסה 4.6.0.0
- הוספנו תמיכה בהעברת מידע על COPPA ל-Unity Ads SDK.
- תאימות מאומתת ל-Unity Ads SDK 4.6.0.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-21.5.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 21.5.0
- Unity Ads SDK בגרסה 4.6.0.
גרסה 4.5.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.5.0.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-21.4.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 21.4.0
- Unity Ads SDK בגרסה 4.5.0.
גרסה 4.4.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.4.1.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 21.2.0
- Unity Ads SDK בגרסה 4.4.1.
גרסה 4.4.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.4.0.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 21.2.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 21.2.0
- Unity Ads SDK בגרסה 4.4.0.
גרסה 4.3.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.3.0.
- הקריאה החוזרת
onAdOpened()
מועברת עכשיו כשמודעות מעברון ומודעות מתגמלות מתחילות לפעול.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK גרסה 21.1.0
- Unity Ads SDK בגרסה 4.3.0.
גרסה 4.2.1.1
- עודכנו
compileSdkVersion
ו-targetSdkVersion
ל-API 31. - עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 21.0.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 21.0.0.
- Unity Ads SDK בגרסה 4.2.1.
גרסה 4.2.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.2.1.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 20.6.0.
- Unity Ads SDK בגרסה 4.2.1.
גרסה 4.1.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.1.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 20.6.0.
- Unity Ads SDK בגרסה 4.1.0.
גרסה 4.0.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.0.1.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-20.6.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 20.6.0.
- Unity Ads SDK בגרסה 4.0.1.
גרסה 4.0.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.0.0.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-20.5.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 20.5.0.
- Unity Ads SDK בגרסה 4.0.0.
גרסה 3.7.5.0
- תאימות מאומתת ל-Unity Ads SDK 3.7.5.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 20.2.0.
- Unity Ads SDK בגרסה 3.7.5.
גרסה 3.7.4.0
- תאימות מאומתת ל-Unity Ads SDK 3.7.4.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 20.2.0.
- Unity Ads SDK בגרסה 3.7.4.
גרסה 3.7.2.0
- תאימות מאומתת ל-Unity Ads SDK 3.7.2.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-20.2.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 20.2.0.
- Unity Ads SDK בגרסה 3.7.2.
גרסה 3.7.1.0
- תאימות מאומתת ל-Unity Ads SDK 3.7.1.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-20.1.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 20.1.0.
- Unity Ads SDK בגרסה 3.7.1.
גרסה 3.6.2.0
- תאימות מאומתת ל-Unity Ads SDK 3.6.2.
- תוקנה בעיה שבה מודעות עם תגמול לא העבירו קריאות חוזרות על קליקים.
- ערכת ה-SDK של UnityAds הוסרה מהגרסה המצורפת של המתאם. מעכשיו, בעלי האפליקציות צריכים לכלול את UnityAds SDK באופן ידני כיחסי תלות נוספים.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 19.8.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 19.8.0.
- Unity Ads SDK בגרסה 3.6.2.
גרסה 3.6.0.0
- תאימות מאומתת ל-Unity Ads SDK 3.6.0.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-19.6.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 19.6.0.
- Unity Ads SDK בגרסה 3.6.0.
גרסה 3.5.1.1
- תוקנה בעיה שגרמה לכך שלא ניתן היה לבקש כמה מודעות מעברון ומודעות מתגמלות.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 19.5.0.
- Unity Ads SDK בגרסה 3.5.1.
גרסה 3.5.1.0
- תאימות מאומתת ל-Unity Ads SDK 3.5.1.
- תוקנה בעיה שגרמה לכך שבקשות להצגת מודעות באנר חכמות נכשלו.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 19.5.0.
- Unity Ads SDK בגרסה 3.5.1.
גרסה 3.5.0.0
- תאימות מאומתת ל-Unity Ads SDK 3.5.0.
- נוספה תמיכה במודעות באנר מותאמות.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-19.5.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 19.5.0.
- Unity Ads SDK בגרסה 3.5.0.
גרסה 3.4.8.0
- תוקנה שגיאה מסוג
NullPointerException
שמתרחשת כשמודעת באנר נמחקת. - עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-19.3.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 19.3.0.
- Unity Ads SDK בגרסה 3.4.8.
גרסה 3.4.6.1
- יצרתם גרסה של מתאם שלא כוללת את Unity Ads SDK בחבילה.
כך בעלי התוכן הדיגיטלי יכולים להשתמש בשירותי Unity Ads כשהם מבצעים תהליך בחירת הרשת (Mediation) ב-Unity, כדי למנוע בעיות של יחסי תלות סותרים.
- בעלי תוכן דיגיטלי יכולים להשתמש באפשרות הזו על ידי הוספת התלות ב-
com.google.ads.mediation:unity-adapter-only:x.y.z.p
לקובץbuild.gradle
ברמת האפליקציה.
- בעלי תוכן דיגיטלי יכולים להשתמש באפשרות הזו על ידי הוספת התלות ב-
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 19.1.0.
- Unity Ads SDK בגרסה 3.4.6.
גרסה 3.4.6.0
- תאימות מאומתת ל-Unity Ads SDK 3.4.6.
- המתאם מעביר עכשיו את הקריאה החוזרת
onAdOpened()
כשלוחצים על מודעת באנר.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 19.1.0.
- Unity Ads SDK בגרסה 3.4.6.
גרסה 3.4.2.3
- נוספו קודי שגיאה תיאוריים וסיבות לכשלים בהצגה או בעומס של מתאמים.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-19.1.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 19.1.0.
- Unity Ads SDK בגרסה 3.4.2.
גרסה 3.4.2.2
- תוקנה קריסה של
ConcurrentModificationException
שהתרחשה כש-Unity Ads מחזירה שגיאה.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 19.0.1.
- Unity Ads SDK בגרסה 3.4.2.
גרסה 3.4.2.1
- שיפור בהעברת השגיאות של Unity כדי לזהות מוקדם יותר כשלים באתחול ובטעינה של מודעות, ולצמצם את זמן הקצאת הזמן הקצוב לתפוגה.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-19.0.1.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 19.0.1.
- Unity Ads SDK בגרסה 3.4.2.
גרסה 3.4.2.0
- תאימות מאומתת ל-Unity Ads SDK 3.4.2.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-18.3.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 18.3.0.
- Unity Ads SDK בגרסה 3.4.2.
גרסה 3.4.0.0
- תאימות מאומתת ל-Unity Ads SDK 3.4.0.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-18.3.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 18.3.0.
- Unity Ads SDK בגרסה 3.4.0.
גרסה 3.3.0.0
- תאימות מאומתת ל-Unity Ads SDK 3.3.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 18.2.0.
- Unity Ads SDK בגרסה 3.3.0.
גרסה 3.2.0.1
- תוקנה קריסה מסוג null pointer exception (NPE) שהתרחשה כשהתקשרו ל-
loadAd()
לפני שהתקשרו ל-UnityAds.initialize()
. - עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-18.2.0.
גרסה 3.2.0.0
- תוקנה בעיה שגרמה לכישלון של בקשות להצגת מודעות באנר.
- תאימות מאומתת ל-Unity Ads SDK 3.2.0.
- העברת המתאם ל-AndroidX.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 18.1.1.
גרסה 3.1.0.0
- הוספנו תמיכה בגדלים גמישים של מודעות באנר.
- אם הגודל המבוקש לא תואם לאף אחד מהגדלים של מודעות הבאנר ב-Unity Ads, הבקשה להצגת מודעה תיכשל
- תאימות מאומתת ל-Unity Ads SDK 3.1.0.
גרסה 3.0.1.0
- תאימות מאומתת ל-Unity Ads SDK 3.0.1.
- תוקן באג שגרם ל-'NPE' במהלך הצגת מודעת מעברון.
גרסה 3.0.0.2
- עדכנו את המתאם כך שיתמוך ב-Rewarded API החדש בגרסת בטא פתוחה.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-17.2.0.
גרסה 3.0.0.1
- נוספה תמיכה במודעות באנר של Unity Ads.
גרסה 3.0.0.0
- תאימות מאומתת ל-Unity Ads SDK 3.0.0.
גרסה 2.3.0.0
- תאימות מאומתת ל-Unity Ads SDK 2.3.0.
גרסה 2.2.1.1
- עדכנו את המתאם כדי להפעיל את אירוע המודעה
onRewardedVideoComplete()
.
גרסה 2.2.1.0
- תאימות מאומתת ל-Unity Ads SDK 2.2.1.
גרסה 2.2.0.0
- תאימות מאומתת ל-Unity Ads SDK 2.2.0.
גרסה 2.1.2.0
- תאימות מאומתת ל-Unity Ads SDK 2.1.2.
גרסה 2.1.1.0
- תאימות מאומתת ל-Unity Ads SDK 2.1.1.
גרסה 2.1.0.0
- עדכנו את המתאם כך שיהיה תואם ל-Unity Ads SDK 2.1.0.
גרסה 2.0.8.0
- תאימות מאומתת ל-Unity Ads SDK 2.0.8.
גרסה 2.0.7.0
- באמצעות דיווח על קליקים ב-Unity Ads (נתוני הקליקים ב-AdMob וב-Unity Ads יהיו זהים).
- הוספנו תמיכה בקריאה חוזרת (callback) של onAdLeftApplication.
גרסה 2.0.6.0
- תאימות מאומתת ל-Unity Ads SDK 2.0.6.
גרסה 2.0.5.0
- עכשיו אפשר להוסיף את המתאמים כיחסי תלות בזמן הידור. לשם כך, מוסיפים את הטקסט הבא לתג dependencies בקובץ build.gradle:
compile 'com.google.ads.mediation:unity:2.0.5.0'
- שינינו את אופן הפצת המתאם לקובץ aar במקום לקובץ jar (הוראות נוספות מפורטות בקובץ README).
גרסה 2.0.4.0
- תוקן באג שגרם לכך שמודעות וידאו עם תגמול לא נטענו כשמודעת מעברון נטענה קודם.
גרסה 2.0.2.0
- שינינו את מערכת השמות של הגרסאות ל-[גרסת Unity Ads SDK].[גרסת התיקון של המתאם].
- עדכנו את גרסת ה-SDK המינימלית הנדרשת של Unity Ads ל-2.0.2.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 9.0.0.
- לאפליקציות כבר אין צורך לבצע קריאה ל-UnityAds.changeActivity(this).
גרסה 1.0.0
- הגרסה הראשונית. תמיכה במודעות וידאו מתגמלות ובמודעות מעברון.