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

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Unity Ads באמצעות AdMob Mediation, כולל שילובים של רשימת הרשתות. המאמר מסביר איך להוסיף את 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 לאפליקציה.

כדי להטמיע את app-ads.txt ב-Unity Ads, אפשר לעיין במאמר בנושא הגדרה של קובץ app-ads.txt בפעם הראשונה.

הפעלת מצב בדיקה

אפשר להפעיל את מצב הבדיקה ממרכז הבקרה של Unity Ads. עוברים אל Unity Ads Monetization (מונטיזציה באמצעות Unity Ads) > Testing (בדיקה).

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

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

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

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

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

צריך להוסיף את Unity Ads להגדרת תהליך בחירת הרשת של יחידת המודעות.

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

כדי ליצור קבוצה חדשה לבחירת רשת, לוחצים על יצירת קבוצה לבחירת רשת.

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

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

משייכים את הקבוצה הזו לבחירת רשת (Mediation) לאחת או יותר מיחידות המודעות הקיימות ב-AdMob. לאחר מכן לוחצים על סיום.

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

הוספה של Unity Ads כמקור מודעות

בידינג

בכרטיס Bidding שבקטע Ad Sources, בוחרים באפשרות Add ad source. לאחר מכן בוחרים באפשרות Unity Ads .

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



לוחצים על אישור והסכמה ואז על המשך.



אם כבר יש לכם מיפוי ל-Unity Ads, אתם יכולים לבחור אותו. אחרת, לוחצים על הוספת מיפוי.



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



מפל


בכרטיס Waterfall שבקטע Ad Sources, בוחרים באפשרות Add Ad Source.

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



אם כבר יצרתם מיפוי ל-Unity Ads, אתם יכולים לבחור אותו. אחרת, לוחצים על הוספת מיפוי.

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


הוספה של Unity Ads לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב

כדי להוסיף את Unity Ads לרשימת שותפי הפרסום שעומדים בדרישות התקנות האירופאיות והתקנות במדינות בארה"ב בממשק המשתמש של AdMob, צריך לפעול לפי השלבים שמפורטים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.

שלב 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: בדיקת ההטמעה

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ב-AdMob ולהפעיל את מצב הבדיקה בממשק המשתמש של 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 שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
102 מערכת UnityAds החזירה מיקום עם מצב NO_FILL.
103 מערכת UnityAds החזירה מיקום עם סטטוס DISABLED.
104 המערכת של UnityAds ניסתה להציג מודעה עם הקשר null.
105 ההקשר שמשמש לאתחול, לטעינה או להצגה של מודעות מ-Unity Ads הוא לא מופע של Activity.
106 המערכת של UnityAds ניסתה להציג מודעה שלא מוכנה להצגה.
107 המכשיר לא תומך ב-UnityAds.
108 מערכת UnityAds יכולה לטעון רק מודעה אחת לכל מיקום בכל פעם.
109 הסתיים עם מצב שגיאה.
200-204 שגיאה ספציפית ב-UnityAds Banner. פרטים נוספים זמינים במאמר בנושא קוד.

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

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