שילוב מודעות Unity עם תהליך בחירת הרשת (Mediation)

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

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

המתאם לבחירת רשת של Unity Ads כולל את היכולות הבאות:

שילוב
בידינג  1
מפל
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה
מותאם

‫1 שילוב בידינג נמצא בגרסת בטא פתוחה.

דרישות

  • רמת API ‏23 ואילך ב-Android

שלב 1: הגדרת תצורות בממשק המשתמש של Unity Ads

נרשמים או מתחברים ל-Unity Ads.

יצירת פרויקט

במרכז הבקרה של Unity Ads, עוברים אל Projects (פרויקטים) ולוחצים על New (חדש).

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

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

בתיבת הדו-שיח פרויקט חדש, בוחרים באפשרות אשתמש בתהליך בחירת הרשת ובאפשרות Google AdMob בשדה שותף בתהליך בחירת הרשת, ואז לוחצים על הבא.

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

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

בידינג

מפל

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

חשוב לשים לב למזהה המשחק.

יצירת יחידות של מודעות ומיקומי מודעות

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

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

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

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

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

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

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

איתור מפתח Unity Ads Reporting API

בידינג

השלב הזה לא נדרש לשילובי בידינג.

מפל

עוברים אל Unity Ads Monetization > API management ורושמים את API Key ב-Monetization Stats API Access.

לאחר מכן, עוברים אל 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 (מונטיזציה באמצעות Unity Ads) > Testing (בדיקה).

כדי להפעיל בכוח את מצב הבדיקה באפליקציה, לוחצים על לחצן העריכה לצד חנות Google Play, מפעילים את האפשרות החלפת מצב הבדיקה של הלקוח ובוחרים באפשרות הפעלת מצב הבדיקה בכוח (כלומר, שימוש במודעות בדיקה) בכל המכשירים.

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

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

שלב 2: הגדרת הביקוש של Unity Ads בממשק המשתמש של Ad Manager

נכנסים לחשבון Ad Manager.

הוספת Unity Ads בקטע 'חברות'

בידינג

השלב הזה לא נדרש לשילובי בידינג.

מפל

עוברים אל Admin (אדמין) > Companies (חברות) ולוחצים על הלחצן New company (חברה חדשה) בכרטיסייה All companies (כל החברות). בוחרים באפשרות רשת פרסום.

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

אין צורך להזין שם משתמש או סיסמה. בסיום, לוחצים על שמירה.

הפעלת שיתוף אותות מאובטח

בידינג

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

מפל

השלב הזה לא נדרש לשילובים של שיטת ה-waterfall.

שיתוף אותות מאובטחים בבקשות להצעות מחיר

בידינג

עוברים אל Inventory (מלאי שטחי פרסום) > Secure Signals (אותות מאובטחים). בקטע אותות מאובטחים, מחפשים את Unity Ads ומפעילים את המתג הפעלת שילוב אפליקציות.

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

מפל

השלב הזה לא נדרש לשילובים של שיטת ה-waterfall.

איך מאפשרים שיתוף אותות מאובטחים בבידינג מבוסס SDK

בידינג

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

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

מפל

השלב הזה לא נדרש לשילובים של שיטת ה-waterfall.

הגדרת בידינג ב-Unity Ads

בידינג

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

לוחצים על משתתף חדש במכרז.

בוחרים באפשרות Unity Ads בתור הבידאר.

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

לוחצים על סיום.

מפל

השלב הזה לא נדרש לשילובים של שיטת ה-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 והמתאם

בקובץ build.gradle.kts ברמת האפליקציה, מוסיפים את התלות וההגדרות הבאות של ההטמעה. משתמשים בגרסאות העדכניות ביותר של Unity Ads SDK ושל המתאם:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("com.unity3d.ads:unity-ads:4.16.1")
    implementation("com.google.ads.mediation:unity:4.16.1.0")
}

שילוב ידני

  1. מורידים את הגרסה העדכנית של Unity Ads SDK‏ (unity-ads.aar) ממאגר GitHub ומוסיפים אותה לפרויקט.

  2. עוברים אל Unity Ads adapter artifacts במאגר Maven של Google. בוחרים את הגרסה האחרונה, מורידים את קובץ .aar של מתאם Unity Ads ומוסיפים אותו לפרויקט.

שלב 4: הטמעה של הגדרות פרטיות ב-Unity Ads SDK

כדי לעמוד בדרישות של מדיניות 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

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). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (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()

פרטים נוספים והערכים שאפשר לספק בכל שיטה מופיעים במדריכים של Unity Ads בנושא Privacy Consent and data APIs ו-Complying with CCPA.

שלב 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 Mediation Adapter Changelog

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

נבנה ונבדק באמצעות:

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

  • תאימות מאומתת ל-Unity Ads SDK 4.14.0.

נבנה ונבדק באמצעות:

  • גרסה 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 הקשר.
  • תאימות מאומתת ל-Unity Ads SDK 4.13.0.

נבנה ונבדק באמצעות:

  • גרסה 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.
  • ‫Unity Ads SDK גרסה 4.11.3.

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

נבנה ונבדק באמצעות:

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

נבנה ונבדק באמצעות:

  • ‫Google Mobile Ads SDK גרסה 21.5.0
  • גרסה 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() מועברת עכשיו כשמודעות מעברון ומודעות מתגמלות מתחילות לפעול.

נבנה ונבדק באמצעות:

  • ‫Google Mobile Ads SDK גרסה 21.1.0
  • גרסה 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.
  • גרסת Unity Ads SDK‏ 4.2.1.

גרסה 4.2.1.0

  • תאימות מאומתת ל-Unity Ads SDK 4.2.1.

נבנה ונבדק באמצעות:

  • גרסה 20.6.0 של Google Mobile Ads SDK.
  • גרסת Unity Ads SDK‏ 4.2.1.

גרסה 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.
  • גרסת Unity Ads SDK‏ 3.5.0.

גרסה 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 כשהם מנהלים משא ומתן ב-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

  • זו הגרסה הראשונה. יש תמיכה במודעות וידאו מתגמלות ובמודעות מעברון.