במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Unity Ads באמצעות תהליך בחירת רשת, כולל שילוב של בידינג ו-Waterfall. המדריך כולל הסבר על הוספת Unity Ads להגדרת תהליך הבחירה של יחידת מודעות, ועל שילוב של Unity Ads SDK ומתאם באפליקציה ל-Android.
שילובים ופורמטים נתמכים של מודעות
מתאם תהליך בחירת הרשת של Unity Ads כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| מפל | 1 |
| פורמטים | |
| מודעת באנר | |
| מעברון | |
| ההטבה הופעלה | |
| מותאם | |
דרישות
- רמת API 23 ומעלה ב-Android
- [לבידינג]: כדי לשלב את כל פורמטי המודעות הנתמכים בבידינג, צריך להשתמש בגרסה 4.16.0.1 של Unity adapter ואילך (מומלץ להשתמש בגרסה העדכנית)
הגרסה העדכנית של Google Mobile Ads SDK
ביצוע של תהליך בחירת הרשת מדריך לתחילת העבודה
שלב 1: הגדרת תצורות בממשק המשתמש של Unity Ads
יצירת פרויקט
במרכז הבקרה של Unity Ads, עוברים אל Projects (פרויקטים) ולוחצים על New (חדש).

ממלאים את הטופס ולוחצים על יצירה כדי להוסיף את הפרויקט.

עוברים אל Unity Ads Monetization (מונטיזציה באמצעות Unity Ads) ולוחצים על Get started (שנתחיל?).

בתיבת הדו-שיח New Project (פרויקט חדש), בוחרים באפשרות I will use Mediation (אשתמש בתהליך בחירת הרשת) ובאפשרות Google Admob (גוגל AdMob) בשדה Mediation Partner (שותף בתהליך בחירת הרשת), ואז לוחצים על Next (הבא).

בוחרים באפשרות של הגדרות המודעות ולוחצים על הבא.

בוחרים את הגדרת מיקום המודעה ולוחצים על הבא.
בידינג

מפל

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

חשוב לשמור את מזהה המשחק.

יצירה של יחידות מודעות ומיקומי מודעות
עוברים אל Unity Ads Monetization > Placements (מונטיזציה של Unity Ads > מיקומי מודעות), בוחרים את הפרויקט ולוחצים על Add ad unit (הוספת יחידת מודעות).

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

עוברים אל מונטיזציה > מיקומי מודעות ולוחצים על הוספת יחידת מודעות.

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

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

חשוב לשמור את מזהה המיקום.
לבסוף, לוחצים על הוספת יחידת מודעות כדי לשמור את יחידת המודעות ואת מיקום המודעה.
איתור מפתח Unity Ads Reporting API
בידינג
השלב הזה לא נדרש לשילובים של בידינג.
מפל
עוברים אל Unity Ads Monetization (מונטיזציה ב-Unity Ads) > API management (ניהול API) ורושמים את API Key (מפתח API) ב-Monetization Stats API Access (גישה ל-API של נתוני מונטיזציה).

לאחר מכן, עוברים אל Unity Ads Monetization (מונטיזציה ב-Unity Ads) > Organization Settings (הגדרות הארגון) ורושמים את Organization core ID (מזהה הליבה של הארגון).

עדכון של הקובץ app-ads.txt
Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt.
אם עדיין לא עשיתם זאת, צרו קובץ app-ads.txt ל-Ad Manager.
כדי להטמיע את app-ads.txt ב-Unity Ads, אפשר לעיין במאמר בנושא הגדרה של קובץ app-ads.txt בפעם הראשונה.
הפעלת מצב בדיקה
אפשר להפעיל את מצב הבדיקה ממרכז הבקרה של Unity Ads. עוברים אל Unity Ads Monetization > Testing.
כדי להפעיל בכוח את מצב הבדיקה באפליקציה, לוחצים על לחצן העריכה לצד חנות Google Play, מפעילים את האפשרות החלפת מצב הבדיקה של הלקוח ובוחרים באפשרות הפעלת מצב הבדיקה בכוח (כלומר, שימוש במודעות בדיקה) בכל המכשירים.

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

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

שלב 2: הגדרת הביקוש של Unity Ads בממשק המשתמש של Ad Manager
נכנסים לחשבון Ad Manager.
הוספת Unity Ads אל 'חברות'
בידינג
השלב הזה לא נדרש לשילובים של בידינג.
Waterfall
עוברים אל Admin > Companies ולוחצים על הכפתור New company בכרטיסייה All companies. בוחרים באפשרות רשת מודעות.

בוחרים באפשרות Unity Ads בתור רשת המודעות, מזינים שם ייחודי ומפעילים את האפשרות בחירת רשת. מפעילים את האפשרות איסוף נתונים אוטומטי ומזינים את מפתח ה-API ומזהה הליבה של הארגון שהתקבלו בקטע הקודם.
אין צורך להזין שם משתמש או סיסמה. כשמסיימים, לוחצים על שמירה.

הפעלת שיתוף אותות מאובטח
בידינג
עוברים אל Admin > Global settings. עוברים לכרטיסייה הגדרות החשבון ב-Ad Exchange, בודקים את ההגדרה שיתוף אותות מאובטח ומפעילים אותה. לוחצים על שמירה.

Waterfall
השלב הזה לא נדרש לשילובים של שיטת ה-waterfall.
שיתוף אותות מאובטחים בבקשות להצעות מחיר
בידינג
עוברים אל Inventory > Secure Signals. בקטע אותות מאובטחים, מחפשים את Unity Ads ומפעילים את המתג הפעלת שילוב אפליקציות.

לוחצים על שמירה.
Waterfall
השלב הזה לא נדרש לשילובים של שיטת ה-waterfall.
הפעלת שיתוף אותות מאובטח עבור בידינג ב-SDK
בידינג
עוברים אל הצגת מודעות > ההגדרות של ערוץ הביקוש. בכרטיסייה הגדרות ברירת מחדל, מפעילים את האפשרות הפעלת שיתוף אותות מאובטחים עבור בידינג ב-SDK.

לוחצים על שמירה.
Waterfall
השלב הזה לא נדרש לשילובים של שיטת ה-waterfall.
הגדרת בידינג ב-Unity Ads
בידינג
עוברים אל אספקה > מגישי הצעות מחיר ולוחצים על מעבר לבידינג מבוסס SDK חיצוני.

לוחצים על מגיש הצעות מחיר חדש.

בוחרים באפשרות Unity Ads כמגיש הצעות המחיר.

לוחצים על המשך כדי להפעיל בידינג SDK עבור מגיש הצעות המחיר הזה.

לוחצים על סיום.
Waterfall
השלב הזה לא נדרש לשילובים של שיטת ה-waterfall.
הגדרת מיפוי של יחידות מודעות
בידינג
עוברים אל אספקה > מגישי הצעות מחיר ולוחצים על מעבר לבידינג מבוסס SDK חיצוני.

בוחרים את החברה ל-Unity Ads.

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

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

מפל
עוברים אל Delivery > Yield groups ולוחצים על הכפתור New yield group. בוחרים את האפליקציה לנייד.

גוללים למטה ולוחצים על הוספת שותף להגדלת נפח תנועת הגולשים.

בוחרים את החברה שיצרתם עבור Unity Ads בקטע הקודם. בוחרים באפשרות Mobile SDK mediation (תהליך בחירת רשתות לניידים באמצעות SDK) בתור Integration type (סוג השילוב), באפשרות Android בתור Platform (פלטפורמה) ובאפשרות Active (פעיל) בתור Status (סטטוס).
מזינים את מזהה המשחק ואת מזהה מיקום המודעה שהתקבלו בקטע הקודם, ואת הערך של עלות ברירת המחדל לאלף חשיפות. לוחצים על שמירה.

הערה: כדי שמערכת AdMob תוכל לחשב בצורה מדויקת את ערך העלות הדינמית לאלף חשיפות עבור רשת גישור, היא צריכה לאסוף נתונים במשך כמה ימים. אחרי שמערכת AdMob יכולה לחשב את העלות בפועל לאלף חשיפות, היא מעדכנת אותה אוטומטית בשבילכם.
הוספת Unity Ads לרשימת שותפי הפרסום שקשורים ל-GDPR ולתקנות במדינות בארה"ב
כדי להוסיף את Unity Ads לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב בממשק המשתמש של Ad Manager, פועלים לפי השלבים שמפורטים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.
שלב 3: ייבוא Unity Ads SDK והמתאם
שילוב עם Android Studio (מומלץ)
בקובץ build.gradle.kts ברמת האפליקציה, מוסיפים את התלות וההגדרות הבאות של ההטמעה. משתמשים בגרסאות העדכניות ביותר של Unity Ads SDK ושל המתאם:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.7.0")
implementation("com.unity3d.ads:unity-ads:4.16.2")
implementation("com.google.ads.mediation:unity:4.16.3.0")
}
שילוב ידני
מורידים את הגרסה העדכנית של Unity Ads SDK (
unity-ads.aar) ממאגר GitHub ומוסיפים אותה לפרויקט.עוברים אל Unity Ads adapter artifacts במאגר Maven של Google. בוחרים את הגרסה העדכנית, מורידים את קובץ
.aarשל מתאם Unity Ads ומוסיפים אותו לפרויקט.
שלב 4: הטמעה של הגדרות פרטיות ב-Unity Ads SDK
GDPR והסכמה בהתאם ולתקנות האירופאיות
כדי לעמוד בדרישות של מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לחשוף מידע מסוים למשתמשים באזור הכלכלי האירופי (EEA), בבריטניה ובשווייץ, ולקבל מהם הסכמה לשימוש בקובצי Cookie או באחסון מקומי אחר במקרים שבהם הדבר נדרש על פי חוק, וכן לאיסוף, לשיתוף ולשימוש במידע אישי לצורך התאמה אישית של מודעות. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. באחריותכם לוודא שההסכמה מועברת לכל מקור מודעות בשרשרת לבחירת רשת. Google לא יכולה להעביר את בחירת ההסכמה של המשתמש לרשתות האלה באופן אוטומטי.
בגרסה 2.0.0 של SDK, Unity Ads הוסיפה API לתמיכה בהגדרות פרטיות. בדוגמת הקוד הבאה אפשר לראות איך מעבירים את פרטי ההסכמה האלה אל Unity Ads SDK. אם אתם בוחרים להעביר את פרטי ההסכמה אל Unity Ads SDK באופן ידני, מומלץ לקרוא לקוד הזה לפני ששולחים בקשות להצגת מודעות דרך Google Mobile Ads SDK.
Java
MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
Kotlin
val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
מידע נוסף על הערכים שאפשר לספק בכל שיטה זמין במאמר בנושא תאימות ל-GDPR ב-Unity Ads.
דיני פרטיות במדינות בארה"ב
דיני הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהמונחים האלה מוגדרים בחוק). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אין למכור את המידע האישי שלי". במדריך בנושא עמידה בדרישות של דיני הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל בהצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שאתם עומדים בדרישות.
בגרסה 2.0.0 של SDK, Unity Ads הוסיפה API לתמיכה בהגדרות פרטיות. בדוגמת הקוד הבאה אפשר לראות איך מעבירים את פרטי ההסכמה האלה אל Unity Ads SDK. אם אתם בוחרים להעביר את פרטי ההסכמה אל Unity Ads SDK באופן ידני, מומלץ לקרוא לקוד הזה לפני ששולחים בקשות להצגת מודעות דרך Google Mobile Ads SDK.
Java
MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
Kotlin
val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
פרטים נוספים על הערכים שאפשר לספק בכל שיטה זמינים במאמר בנושא תאימות לחוק הפרטיות של הצרכנים ב-Unity Ads.
שלב 5: מוסיפים את הקוד הנדרש
טעינת מודעה עם הקשר של פעילות
העברת הקשר Activity בזמן טעינת פורמטים של מודעות באנר, מודעות מעברון ומודעות מותאמות.
אם אין הקשר של פעילות, טעינת המודעה תיכשל.
שלב 6: בדיקת ההטמעה
הפעלת מודעות בדיקה
חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager והפעלתם את מצב הבדיקה בממשק המשתמש של Unity Ads.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-Unity Ads, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות Unity Ads (בידינג) ו-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 | הסתיים עם מצב שגיאה. |
| 200-204 | שגיאה ספציפית במודעת באנר ב-UnityAds. פרטים נוספים זמינים במאמר בנושא קוד. |
יומן השינויים של מתאם תהליך בחירת הרשת Unity Ads ל-Android
גרסה 4.16.3.0
- תאימות מאומתת ל-Unity Ads SDK 4.16.3.
נבנה ונבדק באמצעות:
- גרסה 24.7.0 של Google Mobile Ads SDK.
- גרסה 4.16.3 של Unity Ads SDK.
גרסה 4.16.2.0
- נוסף פרמטר פורמט כשמקבלים אסימון אות מ-Unity Ads SDK.
- הסרנו הטמעה ישנה של API של באנר. הערה: הטמעה חדשה של באנר API כבר קיימת במתאם, ו-GMA SDK ישתמש בה.
- נוסף קוד שגיאה לזיהוי כשל בהצגת תוכן בגלל פסק זמן.
- הוסרו הפניות ברמת המחלקה לאובייקטים מסוג
Contextכדי לפתור בעיות שקשורות לדליפת זיכרון. - תאימות מאומתת ל-Unity Ads SDK 4.16.2.
נבנה ונבדק באמצעות:
- גרסה 24.6.0 של Google Mobile Ads SDK.
- גרסה 4.16.2 של Unity Ads SDK.
גרסה 4.16.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.16.1.
נבנה ונבדק באמצעות:
- גרסה 24.5.0 של Google Mobile Ads SDK.
- גרסה 4.16.1 של Unity Ads SDK.
גרסה 4.16.0.1
- הסרנו את בדיקת הגודל מהמתאם של מודעות באנר ב-RTB.
נבנה ונבדק באמצעות:
- גרסה 24.5.0 של Google Mobile Ads SDK.
- גרסה 4.16.0 של Unity Ads SDK.
גרסה 4.16.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.16.0.
נבנה ונבדק באמצעות:
- גרסה 24.5.0 של Google Mobile Ads SDK.
- גרסה 4.16.0 של Unity Ads SDK.
גרסה 4.15.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.15.1.
נבנה ונבדק באמצעות:
- גרסה 24.4.0 של Google Mobile Ads SDK.
- גרסה 4.15.1 של Unity Ads SDK.
גרסה 4.15.0.0
- העדכון כולל שינוי באופן שבו מתבצע איסוף אותות למודעות באנר ב-RTB. אם ההקשר הוא לא פעילות (כי Unity Ads SDK דורש הקשר של פעילות כדי לטעון מודעות באנר ב-RTB), האיסוף ייכשל. הפתרון הזה ישפר את שיעור ההצלחה של טעינת המודעות אצל בעלי תוכן דיגיטלי.
- תאימות מאומתת ל-Unity Ads SDK 4.15.0.
נבנה ונבדק באמצעות:
- גרסה 24.3.0 של Google Mobile Ads SDK.
- גרסה 4.15.0 של Unity Ads SDK.
גרסה 4.14.2.0
- תאימות מאומתת ל-Unity Ads SDK 4.14.2.
נבנה ונבדק באמצעות:
- גרסה 24.2.0 של Google Mobile Ads SDK.
- גרסה 4.14.2 של Unity Ads SDK.
גרסה 4.14.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.14.1.
נבנה ונבדק באמצעות:
- גרסה 24.1.0 של Google Mobile Ads SDK.
- גרסה 4.14.1 של Unity Ads SDK.
גרסה 4.14.0.0
- תאימות מאומתת לגרסה 4.14.0 של Unity Ads SDK.
נבנה ונבדק באמצעות:
- גרסה 24.0.0 של Google Mobile Ads SDK.
- גרסה 4.14.0 של Unity Ads SDK.
גרסה 4.13.2.0
- עדכנו את רמת ה-API המינימלית הנדרשת ל-Android ל-23.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-24.0.0.
נבנה ונבדק באמצעות:
- גרסה 24.0.0 של Google Mobile Ads SDK.
- גרסה 4.13.2 של Unity Ads SDK.
גרסה 4.13.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.13.1.
נבנה ונבדק באמצעות:
- גרסה 23.6.0 של Google Mobile Ads SDK.
- גרסה 4.13.1 של Unity Ads SDK.
גרסה 4.13.0.0
- הוסרו מהמתאם בדיקות מיותרות של
Activityהקשר. - תאימות מאומתת לגרסה 4.13.0 של Unity Ads SDK.
נבנה ונבדק באמצעות:
- גרסה 23.6.0 של Google Mobile Ads SDK.
- גרסה 4.13.0 של Unity Ads SDK.
גרסה 4.12.5.1
- תיקנו את הכשלים בטעינת מודעות באנר לבידינג על ידי הגדרת מזהה האובייקט בזמן טעינת המודעות.
נבנה ונבדק באמצעות:
- גרסה 23.6.0 של Google Mobile Ads SDK.
- גרסה 4.12.5 של Unity Ads SDK.
גרסה 4.12.5.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.5.
נבנה ונבדק באמצעות:
- גרסה 23.5.0 של Google Mobile Ads SDK.
- גרסה 4.12.5 של Unity Ads SDK.
גרסה 4.12.4.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.4.
נבנה ונבדק באמצעות:
- גרסה 23.3.0 של Google Mobile Ads SDK.
- גרסה 4.12.4 של Unity Ads SDK.
גרסה 4.12.3.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.3.
נבנה ונבדק באמצעות:
- גרסה 23.3.0 של Google Mobile Ads SDK.
- גרסה 4.12.3 של Unity Ads SDK.
גרסה 4.12.2.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.2.
נבנה ונבדק באמצעות:
- גרסה 23.2.0 של Google Mobile Ads SDK.
- גרסה 4.12.2 של Unity Ads SDK.
גרסה 4.12.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.1.
נבנה ונבדק באמצעות:
- גרסה 23.2.0 של Google Mobile Ads SDK.
- גרסה 4.12.1 של Unity Ads SDK.
גרסה 4.12.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.12.0.
נבנה ונבדק באמצעות:
- גרסה 23.1.0 של Google Mobile Ads SDK.
- גרסה 4.12.0 של Unity Ads SDK.
גרסה 4.11.3.0
- נוספה תמיכה בבידינג לפורמטים של מודעות באנר, מודעות מעברון ומודעות מתגמלות.
- תאימות מאומתת ל-Unity Ads SDK 4.11.3.
נבנה ונבדק באמצעות:
- גרסה 23.1.0 של Google Mobile Ads SDK.
- גרסה 4.11.3 של Unity Ads SDK.
גרסה 4.11.2.0
- תאימות מאומתת ל-Unity Ads SDK 4.11.2.
נבנה ונבדק באמצעות:
- גרסה 23.0.0 של Google Mobile Ads SDK.
- גרסה 4.11.2 של Unity Ads SDK.
גרסה 4.10.0.0
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-23.0.0.
- תאימות מאומתת ל-Unity Ads SDK 4.10.0.
נבנה ונבדק באמצעות:
- גרסה 23.0.0 של Google Mobile Ads SDK.
- גרסה 4.10.0 של Unity Ads SDK.
גרסה 4.9.3.0
- תאימות מאומתת ל-Unity Ads SDK 4.9.3.
נבנה ונבדק באמצעות:
- גרסה 22.6.0 של Google Mobile Ads SDK.
- גרסה 4.9.3 של Unity Ads SDK.
גרסה 4.9.2.0
- תאימות מאומתת ל-Unity Ads SDK 4.9.2.
נבנה ונבדק באמצעות:
- גרסה 22.3.0 של Google Mobile Ads SDK.
- גרסה 4.9.2 של Unity Ads SDK.
גרסה 4.9.1.0
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.3.0.
- תאימות מאומתת ל-Unity Ads SDK 4.9.1.
נבנה ונבדק באמצעות:
- גרסה 22.3.0 של Google Mobile Ads SDK.
- גרסה 4.9.1 של Unity Ads SDK.
גרסה 4.8.0.0
- דיווח על חשיפה של מודעה כש-Unity Ads SDK מפעיל את שיטת הקריאה החוזרת החדשה שלו onBannerShown() .
- תאימות מאומתת ל-Unity Ads SDK 4.8.0.
נבנה ונבדק באמצעות:
- גרסה 22.2.0 של Google Mobile Ads SDK.
- גרסה 4.8.0 של Unity Ads SDK.
גרסה 4.7.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.7.1.
נבנה ונבדק באמצעות:
- גרסה 22.1.0 של Google Mobile Ads SDK.
- גרסה 4.7.1 של Unity Ads SDK.
גרסה 4.7.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.7.0.
נבנה ונבדק באמצעות:
- גרסה 22.0.0 של Google Mobile Ads SDK.
- גרסה 4.7.0 של Unity Ads SDK.
גרסה 4.6.1.1
- המתאם עודכן כדי להשתמש במחלקה החדשה
VersionInfo. - הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.0.0.
נבנה ונבדק באמצעות:
- גרסה 22.0.0 של Google Mobile Ads SDK.
- גרסה 4.6.1 של Unity Ads SDK.
גרסה 4.6.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.6.1.
נבנה ונבדק באמצעות:
- גרסה 21.5.0 של Google Mobile Ads SDK
- גרסה 4.6.1 של Unity Ads SDK.
גרסה 4.6.0.0
- הוספנו תמיכה בהעברת מידע בנושא COPPA אל Unity Ads SDK.
- תאימות מאומתת ל-Unity Ads SDK 4.6.0.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.5.0.
נבנה ונבדק באמצעות:
- גרסה 21.5.0 של Google Mobile Ads SDK
- גרסה 4.6.0 של Unity Ads SDK.
גרסה 4.5.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.5.0.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.4.0.
נבנה ונבדק באמצעות:
- גרסה 21.4.0 של Google Mobile Ads SDK
- גרסה 4.5.0 של Unity Ads SDK.
גרסה 4.4.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.4.1.
נבנה ונבדק באמצעות:
- גרסה 21.2.0 של Google Mobile Ads SDK
- גרסה 4.4.1 של Unity Ads SDK.
גרסה 4.4.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.4.0.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.2.0.
נבנה ונבדק באמצעות:
- גרסה 21.2.0 של Google Mobile Ads SDK
- גרסה 4.4.0 של Unity Ads SDK.
גרסה 4.3.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.3.0.
- הקריאה החוזרת
onAdOpened()מועברת עכשיו כשמודעות מעברון ומודעות מתגמלות מתחילות לפעול.
נבנה ונבדק באמצעות:
- גרסה 21.1.0 של Google Mobile Ads SDK
- גרסה 4.3.0 של Unity Ads SDK.
גרסה 4.2.1.1
- העדכנו את
compileSdkVersionואתtargetSdkVersionל-API 31. - עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-21.0.0.
נבנה ונבדק באמצעות:
- גרסה 21.0.0 של Google Mobile Ads SDK.
- גרסה 4.2.1 של Unity Ads SDK.
גרסה 4.2.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.2.1.
נבנה ונבדק באמצעות:
- גרסה 20.6.0 של Google Mobile Ads SDK.
- גרסה 4.2.1 של Unity Ads SDK.
גרסה 4.1.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.1.0.
נבנה ונבדק באמצעות:
- גרסה 20.6.0 של Google Mobile Ads SDK.
- גרסה 4.1.0 של Unity Ads SDK.
גרסה 4.0.1.0
- תאימות מאומתת ל-Unity Ads SDK 4.0.1.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.6.0.
נבנה ונבדק באמצעות:
- גרסה 20.6.0 של Google Mobile Ads SDK.
- גרסה 4.0.1 של Unity Ads SDK.
גרסה 4.0.0.0
- תאימות מאומתת ל-Unity Ads SDK 4.0.0.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.5.0.
נבנה ונבדק באמצעות:
- גרסה 20.5.0 של Google Mobile Ads SDK.
- גרסה 4.0.0 של Unity Ads SDK.
גרסה 3.7.5.0
- תאימות מאומתת ל-Unity Ads SDK 3.7.5.
נבנה ונבדק באמצעות:
- גרסה 20.2.0 של Google Mobile Ads SDK.
- גרסה 3.7.5 של Unity Ads SDK.
גרסה 3.7.4.0
- תאימות מאומתת ל-Unity Ads SDK 3.7.4.
נבנה ונבדק באמצעות:
- גרסה 20.2.0 של Google Mobile Ads SDK.
- גרסה 3.7.4 של Unity Ads SDK.
גרסה 3.7.2.0
- תאימות מאומתת ל-Unity Ads SDK 3.7.2.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.2.0.
נבנה ונבדק באמצעות:
- גרסה 20.2.0 של Google Mobile Ads SDK.
- גרסה 3.7.2 של Unity Ads SDK.
גרסה 3.7.1.0
- תאימות מאומתת ל-Unity Ads SDK 3.7.1.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.1.0.
נבנה ונבדק באמצעות:
- גרסה 20.1.0 של Google Mobile Ads SDK.
- גרסה 3.7.1 של Unity Ads SDK.
גרסה 3.6.2.0
- תאימות מאומתת ל-Unity Ads SDK 3.6.2.
- תוקנה בעיה שבה מודעות מתגמלות לא העבירו קריאות חוזרות (callback) של קליקים.
- ערכת UnityAds SDK הוסרה מהגרסה של המתאם המצורף. מוציאים לאור נדרשים עכשיו לכלול באופן ידני את UnityAds SDK כתלות נוספת.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.8.0.
נבנה ונבדק באמצעות:
- גרסה 19.8.0 של Google Mobile Ads SDK.
- גרסה 3.6.2 של Unity Ads SDK.
גרסה 3.6.0.0
- תאימות מאומתת ל-Unity Ads SDK 3.6.0.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.6.0.
נבנה ונבדק באמצעות:
- גרסה 19.6.0 של Google Mobile Ads SDK.
- גרסה 3.6.0 של Unity Ads SDK.
גרסה 3.5.1.1
- תוקנה בעיה שקרתה כשניסו לשלוח בקשה לכמה מודעות מעברון ולכמה מודעות מתגמלות.
נבנה ונבדק באמצעות:
- גרסה 19.5.0 של Google Mobile Ads SDK.
- גרסה 3.5.1 של Unity Ads SDK.
גרסה 3.5.1.0
- תאימות מאומתת ל-Unity Ads SDK 3.5.1.
- תוקנה בעיה שגרמה לכך שבקשות להצגת מודעות באנר חכמות נכשלו.
נבנה ונבדק באמצעות:
- גרסה 19.5.0 של Google Mobile Ads SDK.
- גרסה 3.5.1 של Unity Ads SDK.
גרסה 3.5.0.0
- תאימות מאומתת ל-Unity Ads SDK 3.5.0.
- הוספנו תמיכה במודעות באנר מותאמות.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.5.0.
נבנה ונבדק באמצעות:
- גרסה 19.5.0 של Google Mobile Ads SDK.
- גרסה 3.5.0 של Unity Ads SDK.
גרסה 3.4.8.0
- תוקנה שגיאת
NullPointerExceptionשמתרחשת כשמודעת באנר מושמדת. - הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.3.0.
נבנה ונבדק באמצעות:
- גרסה 19.3.0 של Google Mobile Ads SDK.
- גרסה 3.4.8 של Unity Ads SDK.
גרסה 3.4.6.1
- נוצרת גרסת build של מתאם שלא כוללת את Unity Ads SDK.
כך בעלי תוכן דיגיטלי יכולים להשתמש ב-Unity Ads Services כשהם מנהלים תהליך בחירת רשת (mediation) ב-Unity, כדי להימנע מבעיות של תלות שגורמות לקונפליקטים.
- בעלי אפליקציות יכולים להשתמש בזה על ידי הוספת התלות
com.google.ads.mediation:unity-adapter-only:x.y.z.pבקובץbuild.gradleברמת האפליקציה.
- בעלי אפליקציות יכולים להשתמש בזה על ידי הוספת התלות
נבנה ונבדק באמצעות:
- גרסה 19.1.0 של Google Mobile Ads SDK.
- גרסה 3.4.6 של Unity Ads SDK.
גרסה 3.4.6.0
- תאימות מאומתת ל-Unity Ads SDK 3.4.6.
- המתאם מעביר עכשיו את הקריאה החוזרת
onAdOpened()כשמשתמש לוחץ על מודעת באנר.
נבנה ונבדק באמצעות:
- גרסה 19.1.0 של Google Mobile Ads SDK.
- גרסה 3.4.6 של Unity Ads SDK.
גרסה 3.4.2.3
- נוספו קודי שגיאה תיאוריים וסיבות לכשלים בטעינה או בהצגה של מתאמים.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.1.0.
נבנה ונבדק באמצעות:
- גרסה 19.1.0 של Google Mobile Ads SDK.
- גרסה 3.4.2 של Unity Ads SDK.
גרסה 3.4.2.2
- תוקנה קריסת
ConcurrentModificationExceptionשהתרחשה כש-Unity Ads מחזיר שגיאה.
נבנה ונבדק באמצעות:
- גרסה 19.0.1 של Google Mobile Ads SDK.
- גרסה 3.4.2 של Unity Ads SDK.
גרסה 3.4.2.1
- שיפרנו את העברת השגיאות של Unity כדי לזהות מוקדם יותר כשלים בהפעלת המודעות ובטעינתן, וכדי לצמצם את הזמן הקצוב לתפוגה.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.0.1.
נבנה ונבדק באמצעות:
- גרסה 19.0.1 של Google Mobile Ads SDK.
- גרסה 3.4.2 של Unity Ads SDK.
גרסה 3.4.2.0
- תאימות מאומתת ל-Unity Ads SDK 3.4.2.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-18.3.0.
נבנה ונבדק באמצעות:
- גרסה 18.3.0 של Google Mobile Ads SDK.
- גרסה 3.4.2 של Unity Ads SDK.
גרסה 3.4.0.0
- תאימות מאומתת ל-Unity Ads SDK 3.4.0.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-18.3.0.
נבנה ונבדק באמצעות:
- גרסה 18.3.0 של Google Mobile Ads SDK.
- גרסה 3.4.0 של Unity Ads SDK.
גרסה 3.3.0.0
- תאימות מאומתת ל-Unity Ads SDK 3.3.0.
נבנה ונבדק באמצעות:
- גרסה 18.2.0 של Google Mobile Ads SDK.
- גרסה 3.3.0 של Unity Ads SDK.
גרסה 3.2.0.1
- תוקנה קריסה של חריגת מצביע null שקרתה כשמתקשרים אל
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 (חריגה של מצביע null) במהלך הצגת מודעת מעברון.
גרסה 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].[גרסת תיקון המתאם].
- עדכנו את הגרסה המינימלית הנדרשת של Unity Ads SDK לגרסה 2.0.2.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 9.0.0.
- אין יותר צורך שאפליקציות יקראו ל-UnityAds.changeActivity(this).
גרסה 1.0.0
- זו הגרסה הראשונה. יש תמיכה במודעות וידאו מתגמלות ובמודעות מעברון.