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

בחירת פלטפורמה: Android iOS Unity Flutter Android (Legacy)

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

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

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

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

דרישות מוקדמות

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

  • יעד פריסה 13.0 ומעלה ב-iOS.

  • ‫[לבידינג]: כדי לשלב את כל פורמטי המודעות הנתמכים בבידינג, צריך להשתמש בגרסה 4.14.1.1 של Unity adapter ואילך (מומלץ להשתמש בגרסה העדכנית).

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

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

יצירת פרויקט

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

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

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

בחלון של New Project, בוחרים באפשרות I will use Mediation ובאפשרות Google Admob בתור Mediation Partner, ואז לוחצים על Next.

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

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

בידינג

מפל

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

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

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

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

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

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

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

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

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

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

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

בידינג

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

מפל

עוברים אל Unity Ads Monetization (מונטיזציה ב-Unity Ads) > API management (ניהול ממשקי API) ורושמים את מפתח ה-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.

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

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

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

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

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

הוספת Unity Ads לחברות

בידינג

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

Waterfall

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

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

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

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

בידינג

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

Waterfall

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

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

בידינג

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

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

Waterfall

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

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

בידינג

עוברים אל Delivery (הצגת מודעות) > Demand channel settings (הגדרות ערוץ ביקוש). בכרטיסייה הגדרות ברירת המחדל, מפעילים את האפשרות אישור שיתוף של אותות מאובטחים לבידינג ב-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 בתורסוג השילוב, באפשרות iOS בתור פלטפורמה ובאפשרות פעיל בתור סטטוס.

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

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

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

שלב 3: ייבוא Unity Ads SDK ולהצגת מודעות והמתאם

שימוש ב-Swift Package Manager

לפני שממשיכים, צריך לוודא שמותקנת במכשיר גרסת המתאם המינימלית הנתמכת, 4.16.0.0.

כדי להוסיף תלות בחבילה לפרויקט:

  1. ב-Xcode, עוברים אל File (קובץ) > Add Package Dependencies...‎ (הוספת יחסי תלות בין חבילות...).

  2. בפרומפט שמופיע, מחפשים את כתובת ה-URL של החבילה הבאה:

    https://github.com/googleads/googleads-mobile-ios-mediation-unity.git

  3. בקטע כלל תלות, בוחרים באפשרות הסתעפות.

  4. בשדה הטקסט, מזינים main.

שימוש ב-CocoaPods

  • מוסיפים את השורה הבאה לקובץ Podfile של הפרויקט:

    pod 'GoogleMobileAdsMediationUnity'

  • מריצים את הפקודה הבאה משורת הפקודה:

    pod install --repo-update

שילוב ידני

  • מורידים את הגרסה העדכנית של Unity Ads SDK להצגת מודעות ומקשרים את UnityAds.framework בפרויקט.

  • מורידים את הגרסה העדכנית של Unity Ads adapter מקישור ההורדה ביומן השינויים ומקשרים את UnityAdapter.framework בפרויקט.

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

כדי לעמוד בדרישות של מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם להציג הודעות גילוי נאות מסוימות למשתמשים שנמצאים באזור הכלכלי האירופי (EEA), בבריטניה ובשוויץ. במקומות שבהם זה נדרש על פי חוק, אתם צריכים גם לקבל את הסכמתם לשימוש בקובצי cookie או באמצעים אחרים לאחסון מקומי. נוסף לכך אתם צריכים לקבל את ההסכמה שלהם לאיסוף ולשיתוף של המידע האישי שלהם ולשימוש בו לצורך התאמה אישית של מודעות. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. באחריותכם לוודא שההסכמה מועברת לכל מקור מודעות בשרשרת לבחירת רשת.

גרסה 4.19.0.1 ואילך של מתאם Unity Ads ל-iOS תומכת בהעברת אותות הסכמה בהתאם ל-GDPR מפלטפורמות לניהול הסכמה (CMP) שמשולבות עם Transparency and Consent Framework (TCF – מסגרת השקיפות וההסכמה) של IAB אל Unity Ads SDK. מידע נוסף זמין במאמר הגדרת תצורה של הסכמה במסגרת TCF או שלא במסגרת TCF.

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

דיני הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהמונחים האלה מוגדרים בחוק). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אין למכור את המידע האישי שלי". במדריך בנושא עמידה בדרישות של דיני הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל בהצגת מודעות Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת רשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שאתם עומדים בדרישות.

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

Swift

let ccpaMetaData = UADSMetaData()
ccpaMetaData.set("privacy.consent", value: true)
ccpaMetaData.commit()

Objective-C

UADSMetaData *ccpaMetaData = [[UADSMetaData alloc] init];
[ccpaMetaData set:@"privacy.consent" value:@YES];
[ccpaMetaData commit];

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

הגדרת הגבלות שקשורות לגיל

המתאם של Unity Ads לגישור, בגרסה 4.16.6.0 ואילך, מעביר ל-Unity Ads את ההגדרה "מטורגט לילדים" ואת ההגדרה "משתמשים מתחת לגיל ההסכמה".

כדי לעבד את האותות האלה לכל משתמש בנפרד, צריך להפעיל ב-Unity Ads את הסיווג Mixed Audience (קהל מעורב) במרכז הבקרה של Unity Monetization. במאמר הגדרת סיווגי גיל ברמת המשחק מוסבר איך להפעיל סיווג של קהל מעורב בפרויקט.

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

הטמעה של SKAdNetwork

פועלים לפי מאמרי העזרה של Unity Ads כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.

שגיאות קומפילציה

Swift

לא נדרש קוד נוסף לשילובים של Swift.

Objective-C

אם אתם משתמשים בגרסה 4.4.0.0 של Unity Ads adapter ואילך, אתם צריכים לפעול לפי שלבי השילוב שמפורטים במסמכי התיעוד של Unity.

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

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

חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager והפעלתם את מצב הבדיקה בממשק המשתמש של Unity Ads.

אימות מודעות בדיקה

כדי לוודא שאתם מקבלים מודעות בדיקה מ-Unity Ads, הפעילו את בדיקת מקור המודעות היחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Unity Ads (בידינג) ו-Unity Ads (Waterfall).

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-Unity Ads, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות GADResponseInfo.adNetworkInfoArray במחלקות הבאות:

GADMAdapterUnity
GADMediationAdapterUnity

אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של UnityAds כשהטעינה של מודעה נכשלת:

קוד שגיאה סיבה
0-9 ‫UnityAds SDK החזיר שגיאה. פרטים נוספים זמינים במאמרי העזרה של Unity.
101 הפרמטרים של שרת UnityAds שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים.
102 המכשיר לא נתמך על ידי UnityAds.
103 ההצגה של UnityAds הסתיימה עם מצב השגיאה kUnityAdsFinishStateError.
104 אובייקט המודעה של Unity הוא nil אחרי שמפעילים את הפונקציה לאתחול שלו.
105 הצגת המודעות של Unity נכשלה כי המודעה לא מוכנה.
107 ‫UnityAds הפעיל קריאה חוזרת לשינוי מיקום עם סטטוס המיקום kUnityAdsPlacementStateDisabled.
108 מודעה כבר נטענה במיקום הזה. ‫UnityAds SDK לא תומך בטעינה של כמה מודעות לאותו מיקום מודעה.
109 מודעת הבאנר שהוחזרה על ידי UnityAds לא תואמת לגודל המבוקש.
110 הייתה בעיה באתחול של UnityAds.
111 פורמט המודעה לא נתמך.
112 ‫UnityAds החזירה טוקן בידינג ריק או null.

יומן השינויים של מתאם תהליך בחירת הרשת Unity Ads ל-iOS

גרסה 4.21.0.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.21.0.

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

  • גרסה 13.11.0 של Google Mobile Ads SDK.
  • גרסה 4.21.0 של Unity Ads SDK.

גרסה 4.20.1.0

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

פותח ונבדק עם:

  • גרסה 13.9.0 של Google Mobile Ads SDK.
  • גרסה 4.20.1 של Unity Ads SDK.

גרסה 4.20.0.0

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

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

  • גרסה 13.8.0 של Google Mobile Ads SDK.
  • גרסה 4.20.0 של Unity Ads SDK.

גרסה 4.19.0.1

  • המתאם מעביר עכשיו באופן אוטומטי את ההסכמה בהתאם ל-GDPR שנמצאת בתוך IABTCF_AddtlConsent אל Unity Ads SDK, אם חל ה-GDPR.

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

  • גרסה 13.7.0 של Google Mobile Ads SDK.
  • גרסה 4.19.0 של Unity Ads SDK.

גרסה 4.19.0.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.19.0.
  • מעדכנים את גרסת iOS המינימלית כדי להקל על התלות ב-Google Mobile Ads SDK ולאפשר גרסאות משניות.

פותח ונבדק עם:

  • גרסה 13.6.0 של Google Mobile Ads SDK.
  • גרסה 4.19.0 של Unity Ads SDK.

גרסה 4.18.1.0

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

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

  • גרסה 13.4.0 של Google Mobile Ads SDK.
  • גרסה 4.18.1 של Unity Ads SDK.

גרסה 4.18.0.0

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

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

  • גרסה 13.3.0 של Google Mobile Ads SDK.
  • גרסה 4.18.0 של Unity Ads SDK.

גרסה 4.17.0.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.17.0.

פותח ונבדק עם:

  • גרסה 13.1.0 של Google Mobile Ads SDK.
  • גרסה 4.17.0 של Unity Ads SDK.

גרסה 4.16.6.1

  • עדכנו את התלות ב-Google Mobile Ads SDK לגרסה 13.0.0.
  • תוקנה בעיה בגרסה 4.16.6.0 שבה קובץ ה-podspec הצביע באופן שגוי על קובץ הבינארי 4.16.5.0.

פותח ונבדק עם:

  • גרסה 13.0.0 של Google Mobile Ads SDK.
  • גרסה 4.16.6 של Unity Ads SDK.

גרסה 4.16.6.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.16.6.
  • נוספה תמיכה בהעברת הפרמטר tagForUnderAgeOfConsent של Google Mobile Ads SDK אל Unity Ads SDK.

פותח ונבדק עם:

  • גרסה 13.0.0 של Google Mobile Ads SDK.
  • גרסה 4.16.6 של Unity Ads SDK.

גרסה 4.16.5.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.16.5.

פותח ונבדק עם:

  • גרסה 12.14.0 של Google Mobile Ads SDK.
  • גרסה 4.16.5 של Unity Ads SDK.

גרסה 4.16.4.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.16.4.

פותח ונבדק עם:

  • גרסה 12.13.0 של Google Mobile Ads SDK.
  • גרסה 4.16.4 של Unity Ads SDK.

גרסה 4.16.3.0

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

פותח ונבדק עם:

  • גרסה 12.12.0 של Google Mobile Ads SDK.
  • גרסה 4.16.3 של Unity Ads SDK.

גרסה 4.16.2.0

  • שינינו את שיטות טעינת המודעות כך שימתינו עד שה-SDK של Unity Ads יופעל במלואו לפני שינסו לטעון מודעה.
  • נפתר מרוץ תהליכים שבו קריאות חוזרות (callbacks) של השלמה עלולות להימחק אם מתבצעות כמה הפעלות.
  • תאימות מאומתת ל-Unity Ads SDK 4.16.2.

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

  • גרסה 12.12.0 של Google Mobile Ads SDK.
  • גרסה 4.16.2 של Unity Ads SDK.

גרסה 4.16.1.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.16.1.

פותח ונבדק עם:

  • גרסה 12.9.0 של Google Mobile Ads SDK.
  • גרסה 4.16.1 של Unity Ads SDK.

גרסה 4.16.0.0

  • עכשיו נדרשת גרסת iOS מינימלית 13.0.
  • תאימות מאומתת ל-Unity Ads SDK 4.16.0.

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

  • גרסה 12.8.0 של Google Mobile Ads SDK.
  • גרסה 4.16.0 של Unity Ads SDK.

גרסה 4.15.1.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.15.1.

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

  • גרסה 12.6.0 של Google Mobile Ads SDK.
  • גרסה 4.15.1 של Unity Ads SDK.

גרסה 4.15.0.0

  • נוסף קוד השגיאה 111: Unsupported ad format.
  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.15.0.

פותח ונבדק עם:

  • גרסה 12.5.0 של Google Mobile Ads SDK.
  • גרסה 4.15.0 של Unity Ads SDK.

גרסה 4.14.2.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.14.2.

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

  • גרסה 12.3.0 של Google Mobile Ads SDK.
  • גרסה 4.14.2 של Unity Ads SDK.

גרסה 4.14.1.1

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

פותח ונבדק עם:

  • גרסה 12.2.0 של Google Mobile Ads SDK.
  • גרסה 4.14.1 של Unity Ads SDK.

גרסה 4.14.1.0

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

פותח ונבדק עם:

  • גרסה 12.2.0 של Google Mobile Ads SDK.
  • גרסה 4.14.1 של Unity Ads SDK.

גרסה 4.14.0.0

  • הפעלתם את התכונות הניסיוניות -fobjc-arc ו--fstack-protector-all.
  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.14.0.

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

  • גרסה 12.2.0 של Google Mobile Ads SDK.
  • גרסה 4.14.0 של Unity Ads SDK.

גרסה 4.13.2.0

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

פותח ונבדק עם:

  • גרסה 12.1.0 של Google Mobile Ads SDK.
  • גרסה 4.13.2 של Unity Ads SDK.

גרסה 4.13.1.1

  • עכשיו נדרשת גרסה 12.0.0 ומעלה של Google Mobile Ads SDK.

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

  • גרסה 12.0.0 של Google Mobile Ads SDK.
  • גרסה 4.13.1 של Unity Ads SDK.

גרסה 4.13.1.0

  • הוספנו את המאפיין GADMediationAdapterUnity.testMode כדי לציין אם צריך להפעיל את Unity Ads SDK במצב בדיקה. צריך להגדיר את הדגל הזה לפני שמפעילים את Google Mobile Ads SDK.
  • המתאם עודכן כך שידווח על קוד השגיאה של Unity Ads SDK כשמודעה לא נטענת.

פותח ונבדק עם:

  • גרסה 11.13.0 של Google Mobile Ads SDK.
  • גרסה 4.13.1 של Unity Ads SDK.

גרסה 4.13.0.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.13.0.

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

  • גרסה 11.13.0 של Google Mobile Ads SDK.
  • גרסה 4.13.0 של Unity Ads SDK.

גרסה 4.12.5.0

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

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

  • גרסה 11.12.0 של Google Mobile Ads SDK.
  • גרסה 4.12.5 של Unity Ads SDK.

גרסה 4.12.4.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.12.4.

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

  • גרסה 11.12.0 של Google Mobile Ads SDK.
  • גרסה 4.12.4 של Unity Ads SDK.

גרסה 4.12.3.1

  • עדכנו את CFBundleShortVersionString כך שיכלול שלושה רכיבים במקום ארבעה.

פותח ונבדק עם:

  • גרסה 11.10.0 של Google Mobile Ads SDK.
  • גרסה 4.12.3 של Unity Ads SDK.

גרסה 4.12.3.0

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

פותח ונבדק עם:

  • גרסה 11.10.0 של Google Mobile Ads SDK.
  • גרסה 4.12.3 של Unity Ads SDK.

גרסה 4.12.2.0

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

פותח ונבדק עם:

  • גרסה 11.7.0 של Google Mobile Ads SDK.
  • גרסה 4.12.2 של Unity Ads SDK.

גרסה 4.12.1.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.12.1.

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

  • גרסה 11.6.0 של Google Mobile Ads SDK.
  • גרסה 4.12.1 של Unity Ads SDK.

גרסה 4.12.0.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.12.0.

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

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

גרסה 4.11.3.1

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

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

  • גרסה 11.5.0 של Google Mobile Ads SDK.
  • גרסה 4.11.3 של Unity Ads SDK.

גרסה 4.11.3.0

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

פותח ונבדק עם:

  • גרסה 11.4.0 של Google Mobile Ads SDK.
  • גרסה 4.11.3 של Unity Ads SDK.

גרסה 4.11.2.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.11.2.

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

  • גרסה 11.4.0 של Google Mobile Ads SDK.
  • גרסה 4.11.2 של Unity Ads SDK.

גרסה 4.10.0.0

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

פותח ונבדק עם:

  • גרסה 11.2.0 של Google Mobile Ads SDK.
  • גרסה 4.10.0 של Unity Ads SDK.

גרסה 4.9.3.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.9.3.
  • עכשיו נדרשת גרסת iOS מינימלית של 12.0.
  • עכשיו נדרשת גרסה 11.0 ומעלה של Google Mobile Ads SDK.
  • הכללה של Info.plist במסגרות בתוך UnityAdapter.xcframework.

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

  • גרסה 11.0.1 של Google Mobile Ads SDK.
  • גרסה 4.9.3 של Unity Ads SDK.

גרסה 4.9.2.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.9.2.

פותח ונבדק עם:

  • גרסה 10.13.0 של Google Mobile Ads SDK.
  • גרסה 4.9.2 של Unity Ads SDK.

גרסה 4.9.1.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.9.1.

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

  • גרסה 10.12.0 של Google Mobile Ads SDK.
  • גרסת Unity Ads SDK‏ 4.9.1.

גרסה 4.9.0.0

  • הוסרו התאימות והתלות ב-GADMAdNetworkAdapter מהמתאם של Unity.
  • נוספה קריאה (invocation) לשיטה report impression בשיטה unityAdsShowStart delegate.
  • תאימות מאומתת ל-Unity Ads SDK 4.9.0.

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

  • גרסה 10.12.0 של Google Mobile Ads SDK.
  • גרסה 4.9.0 של Unity Ads SDK.

גרסה 4.8.0.0

  • נוספה תמיכה באירועי חשיפה של מודעות באנר.
  • תאימות מאומתת ל-Unity Ads SDK 4.8.0.

פותח ונבדק עם:

  • גרסה 10.7.0 של Google Mobile Ads SDK.
  • גרסה 4.8.0 של Unity Ads SDK.

גרסה 4.7.1.0

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

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

  • גרסה 10.5.0 של Google Mobile Ads SDK.
  • גרסת Unity Ads SDK‏ 4.7.1.

גרסה 4.7.0.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.7.0.
  • נדרשת עכשיו גרסת iOS מינימלית של 11.0.
  • עכשיו נדרשת גרסה 10.4.0 ומעלה של Google Mobile Ads SDK.

פותח ונבדק עם:

  • גרסה 10.4.0 של Google Mobile Ads SDK.
  • גרסה 4.7.0 של Unity Ads SDK.

גרסה 4.6.1.0

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

פותח ונבדק עם:

  • גרסה 10.2.0 של Google Mobile Ads SDK.
  • גרסה 4.6.1 של Unity Ads SDK.

גרסה 4.6.0.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.6.0.
  • הוספנו תמיכה בהעברת מידע בנושא COPPA אל Unity Ads SDK.
  • הוסרה התמיכה בארכיטקטורה armv7.
  • עכשיו נדרשת גרסה 10.0.0 ומעלה של Google Mobile Ads SDK.

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

  • גרסה 10.2.0 של Google Mobile Ads SDK.
  • גרסה 4.6.0 של Unity Ads SDK.

גרסה 4.5.0.0

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

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

  • גרסה 9.14.0 של Google Mobile Ads SDK.
  • גרסה 4.5.0 של Unity Ads SDK.

גרסה 4.4.1.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.4.1.

פותח ונבדק עם:

  • גרסה 9.11.0 של Google Mobile Ads SDK.
  • גרסה 4.4.1 של Unity Ads SDK.

גרסה 4.4.0.0

  • המתאם עודכן כך שישתמש ב-API של didRewardUser.
  • מעכשיו נדרשת גרסה 9.8.0 ואילך של Google Mobile Ads SDK.
  • תאימות מאומתת ל-Unity Ads SDK 4.4.0.

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

  • גרסה 9.10.0 של Google Mobile Ads SDK.
  • גרסה 4.4.0 של Unity Ads SDK.

גרסה 4.3.0.0

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

פותח ונבדק עם:

  • גרסה 9.8.0 של Google Mobile Ads SDK.
  • גרסה 4.3.0 של Unity Ads SDK.

גרסה 4.2.1.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 4.2.1.

פותח ונבדק עם:

  • גרסה 9.4.0 של Google Mobile Ads SDK.
  • גרסה 4.2.1 של Unity Ads SDK.

גרסה 4.1.0.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.1.0.

פותח ונבדק עם:

  • גרסה 9.2.0 של Google Mobile Ads SDK.
  • גרסה 4.1.0 של Unity Ads SDK.

גרסה 4.0.1.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.0.1.

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

  • גרסה 9.0.0 של Google Mobile Ads SDK.
  • גרסה 4.0.1 של Unity Ads SDK.

גרסה 4.0.0.2

  • הוספנו תמיכה בארכיטקטורת הסימולטור arm64.

פותח ונבדק עם:

  • גרסה 9.0.0 של Google Mobile Ads SDK.
  • גרסה 4.0.0 של Unity Ads SDK.

גרסה 4.0.0.1

  • תאימות מאומתת לגרסה 9.0.0 של Google Mobile Ads SDK.
  • עכשיו נדרשת גרסה 9.0.0 ומעלה של Google Mobile Ads SDK.

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

  • גרסה 9.0.0 של Google Mobile Ads SDK.
  • גרסה 4.0.0 של Unity Ads SDK.

גרסה 4.0.0.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 4.0.0.
  • נדרשת עכשיו גרסת iOS מינימלית 10.0.

פותח ונבדק עם

  • גרסה 8.13.0 של Google Mobile Ads SDK.
  • גרסה 4.0.0 של Unity Ads SDK.

גרסה 3.7.5.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 3.7.5.

פותח ונבדק עם

  • גרסה 8.8.0 של Google Mobile Ads SDK.
  • גרסה 3.7.5 של Unity Ads SDK.

גרסה 3.7.4.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 3.7.4.

פותח ונבדק עם

  • גרסה 8.7.0 של Google Mobile Ads SDK.
  • גרסה 3.7.4 של Unity Ads SDK.

גרסה 3.7.2.0

  • תאימות מאומתת ל-Unity Ads SDK 3.7.2.
  • התלות בגרסה 8.0.0 ואילך של Google Mobile Ads SDK הופחתה.

פותח ונבדק עם

  • גרסה 8.5.0 של Google Mobile Ads SDK.
  • גרסה 3.7.2 של Unity Ads SDK.

גרסה 3.7.1.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 3.7.1.
  • מעכשיו נדרשת גרסה 8.4.0 ואילך של Google Mobile Ads SDK.

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

  • גרסה 8.4.0 של Google Mobile Ads SDK.
  • גרסה 3.7.1 של Unity Ads SDK.

גרסה 3.6.2.0

  • המתאם עודכן לשימוש בפורמט .xcframework.
  • תאימות מאומתת ל-Unity Ads SDK 3.6.2.
  • עכשיו נדרשת גרסה 8.2.0 ומעלה של Google Mobile Ads SDK.

פותח ונבדק עם

  • גרסה 8.2.0 של Google Mobile Ads SDK.
  • גרסה 3.6.2 של Unity Ads SDK.

גרסה 3.6.0.0

  • תאימות מאומתת ל-Unity Ads SDK 3.6.0.
  • עכשיו נדרשת גרסה 7.69.0 ומעלה של Google Mobile Ads SDK.

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

  • גרסה 7.69.0 של Google Mobile Ads SDK.
  • גרסה 3.6.0 של Unity Ads SDK.

גרסה 3.5.1.1

  • תוקנה קריסה שלפעמים התרחשה כשהאתחול של Unity Ads SDK הסתיים.

פותח ונבדק עם

  • גרסה 7.68.0 של Google Mobile Ads SDK.
  • גרסה 3.5.1 של Unity Ads SDK.

גרסה 3.5.1.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 3.5.1.

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

  • גרסה 7.68.0 של Google Mobile Ads SDK.
  • גרסה 3.5.1 של Unity Ads SDK.

גרסה 3.5.0.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 3.5.0.
  • הוספנו תמיכה במודעות באנר מותאמות.
  • עכשיו נדרשת גרסה 7.68.0 ומעלה של Google Mobile Ads SDK.

פותח ונבדק עם

  • גרסה 7.68.0 של Google Mobile Ads SDK.
  • גרסה 3.5.0 של Unity Ads SDK.

גרסה 3.4.8.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 3.4.8.
  • עכשיו נדרשת גרסה 7.63.0 ומעלה של Google Mobile Ads SDK.

פותח ונבדק עם

  • גרסה 7.63.0 של Google Mobile Ads SDK.
  • גרסה 3.4.8 של Unity Ads SDK.

גרסה 3.4.6.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 3.4.6.
  • עכשיו נדרשת גרסה 7.60.0 ומעלה של Google Mobile Ads SDK.

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

  • גרסה 7.60.0 של Google Mobile Ads SDK.
  • גרסת Unity Ads SDK‏ 3.4.6.

גרסה 3.4.2.2

  • הוספנו קודים והודעות שגיאה סטנדרטיים של מתאמים.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-7.59.0.

פותח ונבדק עם

  • גרסה 7.59.0 של Google Mobile Ads SDK.
  • גרסה 3.4.2 של Unity Ads SDK.

גרסה 3.4.2.1

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

פותח ונבדק עם

  • גרסה 7.57.0 של Google Mobile Ads SDK.
  • גרסה 3.4.2 של Unity Ads SDK.

גרסה 3.4.2.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 3.4.2.

פותח ונבדק עם

  • גרסה 7.55.1 של Google Mobile Ads SDK.
  • גרסה 3.4.2 של Unity Ads SDK.

גרסה 3.4.0.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 3.4.0.
  • עכשיו אפשר לטעון כמה מודעות באנר בבת אחת.

פותח ונבדק עם

  • גרסה 7.53.0 של Google Mobile Ads SDK.
  • גרסה 3.4.0 של Unity Ads SDK.

גרסה 3.3.0.0

  • תאימות מאומתת ל-Unity Ads SDK בגרסה 3.3.0.
  • עכשיו אפשר לטעון כמה מודעות באנר בבת אחת.

פותח ונבדק עם

  • גרסה 7.51.0 של Google Mobile Ads SDK.
  • גרסה 3.3.0 של Unity Ads SDK.

גרסה 3.2.0.1

  • תאימות מאומתת ל-Unity Ads SDK 3.2.0.
  • עכשיו נדרשת גרסה 7.46.0 ומעלה של Google Mobile Ads SDK.
  • תוקנה בעיה שבה מודעות באנר ב-Unity לא הוצגו אחרי הטעינה.
  • תוקנה בעיה שבה המתאם לא העביר כמו שצריך את הקריאה החוזרת unityAdsReady.

גרסה 3.2.0.0

  • הגרסה הוסרה בגלל רגרסיה בדיווח על בקשות שלא מולאו.

‫גרסה 3.1.0.0

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

גרסה 3.0.3.0

  • תאימות מאומתת ל-Unity Ads SDK 3.0.3.
  • עכשיו נדרשת גרסה 7.42.2 ומעלה של Google Mobile Ads SDK.
  • נוספה תמיכה בגדלים גמישים של מודעות באנר.
  • תוקנה בעיה שבה מודעות באנר של Unity נטענו בהצלחה רק פעם אחת בכל סשן.

גרסה 3.0.1.0

  • תאימות מאומתת ל-Unity Ads SDK 3.0.1.
  • תוקנה קריסה שהתרחשה כשבוטלה ההקצאה של מודעות מתגמלות.

גרסה 3.0.0.3

  • עדכון המתאם לשימוש ב-API החדש של מודעות מתגמלות.
  • מעכשיו נדרשת גרסה 7.41.0 ואילך של Google Mobile Ads SDK.

גרסה 3.0.0.2

  • נוספה תמיכה במודעות באנר.

גרסה 3.0.0.1

  • נפתרה בעיה שבה המתאם שומר את הערך 'placementId' של בקשה קודמת.

גרסה 3.0.0.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 3.0.0.

גרסה 2.3.0.0

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

גרסה 2.2.1.1

  • נוספה קריאה חוזרת (callback) מסוג adapterDidCompletePlayingRewardBasedVideoAd: למתאם.

גרסה 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.
  • הוסרה התמיכה בארכיטקטורה 'armv7s'.

גרסה 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 יכולים להתאים.
  • עכשיו האפליקציות מקבלות קריאות חוזרות (callbacks) מסוג interstitialWillLeaveApplication: ו-rewardBasedVideoAdWillLeaveApplication:.

גרסה 2.0.6.0

  • תאימות מאומתת עם Unity Ads SDK בגרסה 2.0.6.

גרסה 2.0.5.0

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

‫גרסה 2.0.4.0

  • שינינו את מערכת השמות של הגרסאות ל[גרסת Unity Ads SDK].[גרסת תיקון המתאם].
  • גרסת ה-SDK המינימלית הנדרשת של Unity Ads עודכנה לגרסה 2.0.4.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 7.10.1.

גרסה 1.0.2

  • המפתח של פריט התגמול למשתמשים לא יכול להיות ריק. מפתח הפרס תמיד יהיה מחרוזת ריקה או מחרוזת תקינה.

גרסה 1.0.1

  • תוקן באג שגרם לכך שהקריאה החוזרת rewardBasedVideoAdDidOpen: לא נקראה.

גרסה 1.0.0

  • תומכת במודעות מעברון ובמודעות וידאו מתגמלות.