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

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

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

המתאם לתהליך בחירת הרשת (Mediation) ב-Unity Ads כולל את היכולות הבאות:

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

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

דרישות

  • Android API ברמה 21 ואילך

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

נרשמים או נכנסים ל-Unity Ads.

יצירת פרויקט

במרכז הבקרה של Unity Ads, עוברים אל Projects ולוחצים על Create Project.

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

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

בחלון Project Setup (הגדרת פרויקט), בוחרים באפשרות I plan to use Mediation (אני רוצה להשתמש בתהליך בחירת הרשת (Mediation)) וב-Google Admob בקטע Mediation Partner (שותף בתהליך בחירת הרשת) ולוחצים על Next.

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

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

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

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

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

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

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

הוספת מיקום מודעה

בידינג

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

מפל

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

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

שימו לב למזהה מיקום המודעה.

איתור מפתח API לדיווח של Unity Ads

בידינג

לא צריך לבצע את השלב הזה בשילוב של בידינג.

מפל

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

עוברים אל מונטיזציה > Setup (הגדרה) > API Management (ניהול API) ושימו לב למפתח הגישה של ה-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 בממשק המשתמש של AdMob

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

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

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

כדי ליצור קבוצה חדשה לבחירת רשת, בוחרים באפשרות יצירת קבוצה לבחירת רשת (Mediation).

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

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

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

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

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

בידינג

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

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

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

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

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

מפל

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

בוחרים באפשרות Unity Ads ומפעילים את המתג Optimize. עליכם להזין את API Key and Organization core IDשקיבלתם בסעיף הקודם כדי להגדיר אופטימיזציה של מקורות מודעות עבורUnity Ads. לאחר מכן מזינים ערך של עלות בפועל לאלף חשיפות עבורUnity Ads ולוחצים על המשך.

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

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

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

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

שלב 3: מייבאים את ה-Unity Ads SDK והמתאם

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.unity3d.ads:unity-ads:4.12.4")
    implementation("com.google.ads.mediation:unity:4.12.4.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) מקבלים גילויים נאותים מסוימים לגבי השימוש במזהי מכשירים ובמידע אישי, ומאשרים את השימוש הזה. המדיניות הזו משקפת את הדרישות שמפורטות ב-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()

אפשר לעיין במדריכים של Unity Ads Privacy Consent and data APIs ו עמידה בדרישות GDPR לקבלת פרטים נוספים ולערכים שאפשר לספק בכל שיטה.

חוקי פרטיות במדינות בארה"ב

חוקי הפרטיות במדינות ארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה למכירת המידע האישי שלהם (בהתאם להגדרה המעוגנת בחוק). האפשרות לבטל את ההסכמה חייבת להיות מוצגת בקישור בולט עם הכיתוב 'אל תמכרו את המידע האישי שלי' בדף הבית של הצד המוֹכֵר. במדריך התאימות לחוקי הפרטיות במדינות ארה"ב מוסבר איך מפעילים עיבוד נתונים מוגבל להצגת מודעות של Google, אבל 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 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 (הסכמה לפרטיות וממשקי API לנתונים) וגם במדריכיםComplying with CCPA (תאימות ל-CCPA) ו-.

שלב 5: מוסיפים את הקוד הנדרש

אין צורך בקוד נוסף לשילובים של Unity Ads.

שלב 6: בדיקה מעשית של ההטמעה

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

חשוב לרשום את מכשיר הבדיקה ב-AdMob ולהפעיל את מצב הבדיקה בממשק המשתמש של 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 שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
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.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.

פותח ונבדק בעזרת:

  • גרסה 23.1.0 של Google Mobile Ads SDK
  • Unity Ads SDK גרסה 4.12.0.

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

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

  • 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() ) החדשה של onBannerBanner.
  • תאימות מאומתת ל-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.

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

  • גרסה 22.1.0 של Google Mobile Ads SDK.
  • 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.

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

  • גרסה 20.5.0 של Google Mobile Ads SDK.
  • 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, שהתרחשה כשקוראים ל-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].[גרסת התיקון של המתאם].
  • הגרסה המינימלית הנדרשת של Unity Ads SDK עודכנה לגרסה 2.0.2.
  • עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 9.0.0.
  • לאפליקציות כבר אין צורך לבצע קריאה ל-UnityAds.changeActivity(this).

גרסה 1.0.0

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