تبلیغات Unity را با Mediation ادغام کنید

پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر ، اندروید (قدیمی)

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK (Legacy) برای بارگذاری و نمایش تبلیغات از Unity Ads با استفاده از میانجیگری استفاده کنید، که شامل ادغام‌های پیشنهاد قیمت و آبشاری می‌شود. این راهنما نحوه اضافه کردن Unity Ads به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور Unity Ads در یک برنامه اندروید را پوشش می‌دهد.

ادغام‌ها و قالب‌های تبلیغاتی پشتیبانی‌شده

آداپتور میانجیگری برای Unity Ads دارای قابلیت‌های زیر است:

ادغام
مناقصه
آبشار ۱
قالب‌ها
بنر
بینابینی
پاداش داده شده
بومی

پیش‌نیازها

قبل از ادامه، موارد زیر را بررسی کنید:

  • اندروید API سطح ۲۴ یا بالاتر.
  • [برای پیشنهاد قیمت]: برای ادغام تمام قالب‌های تبلیغاتی پشتیبانی‌شده در پیشنهاد قیمت، از آداپتور Unity نسخه ۴.۱۶.۰.۱ یا بالاتر ( آخرین نسخه توصیه می‌شود ) استفاده کنید.

مرحله 1: تنظیمات را در رابط کاربری تبلیغات یونیتی تنظیم کنید

در Unity Ads ثبت نام کنید یا وارد شوید .

ایجاد یک پروژه

در داشبورد Unity Ads ، به بخش Projects بروید و روی New کلیک کنید.

فرم را پر کنید و برای اضافه کردن پروژه خود، روی ایجاد کلیک کنید.

به بخش کسب درآمد از تبلیغات یونیتی بروید، سپس روی شروع به کار کلیک کنید.

در پنجره New Project ، گزینه I will use Mediation and Google Admob for Mediation Partner را انتخاب کنید، سپس روی Next کلیک کنید.

گزینه مربوط به تنظیمات تبلیغات را انتخاب کنید، سپس روی «بعدی» کلیک کنید.

تنظیمات قرارگیری خود را انتخاب کنید، سپس روی «بعدی» کلیک کنید.

مناقصه

آبشار

فرم را پر کنید، سپس روی افزودن پروژه کلیک کنید.

به شناسه بازی (Game ID) توجه کنید.

ایجاد واحدهای تبلیغاتی و جایگاه‌ها

به بخش کسب درآمد از تبلیغات یونیتی > مکان‌ها بروید، سپس پروژه خود را انتخاب کنید و روی افزودن واحد تبلیغاتی کلیک کنید.

نام واحد تبلیغاتی را وارد کنید، سپس پلتفرم و قالب تبلیغاتی خود را انتخاب کنید.

به بخش کسب درآمد > مکان‌ها بروید، سپس روی افزودن واحد تبلیغاتی کلیک کنید.

نام واحد تبلیغاتی خود را وارد کنید، سپس پلتفرم و قالب تبلیغاتی خود را انتخاب کنید.

برای تنظیمات، آبشار (Waterfall) را انتخاب کنید. در قسمت جایگذاری (Placement) ، نام جایگذاری (Placement name) ، برچسب‌گذاری جغرافیایی (GEO Tagging) و هدف (Target) را وارد کنید.

شناسه‌ی محل قرارگیری را یادداشت کنید.

در نهایت، برای ذخیره واحد تبلیغاتی و جایگاه آن، روی افزودن واحد تبلیغاتی کلیک کنید.

کلید API گزارش تبلیغات Unity را پیدا کنید

مناقصه

این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.

آبشار

به Unity Ads Monetization > API management بروید و کلید API را در Monetization Stats API Access یادداشت کنید.

سپس، به مسیر Unity Ads Monetization > Organization Settings بروید و شناسه اصلی سازمان (Organization core ID) را یادداشت کنید.

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .

برای پیاده‌سازی app-ads.txt برای Unity Ads، به بخش راه‌اندازی app-ads.txt برای اولین بار مراجعه کنید.

حالت تست را روشن کنید

حالت آزمایشی را می‌توان از داشبورد Unity Ads فعال کرد. به Unity Ads Monetization > Testing بروید.

شما می‌توانید با کلیک روی دکمه ویرایش در کنار فروشگاه گوگل پلی ، فعال کردن حالت تست کلاینت Override و انتخاب حالت تست اجباری (یعنی استفاده از تبلیغات آزمایشی) برای همه دستگاه‌ها، حالت تست را برای برنامه خود اجباری کنید.

از طرف دیگر، می‌توانید با کلیک روی «افزودن دستگاه آزمایشی»، حالت آزمایشی را برای دستگاه‌های خاص فعال کنید.

جزئیات دستگاه آزمایشی خود را وارد کنید، سپس روی ذخیره کلیک کنید.

مرحله ۲: تنظیم تقاضای تبلیغات یونیتی در رابط کاربری مدیریت تبلیغات

وارد حساب مدیر تبلیغات خود شوید.

تبلیغات Unity را در شرکت‌ها اضافه کنید

مناقصه

این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.

آبشار

به بخش مدیریت > شرکت‌ها بروید، سپس در تب «همه شرکت‌ها» روی دکمه «شرکت جدید» کلیک کنید. شبکه تبلیغاتی را انتخاب کنید.

Unity Ads را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید. جمع‌آوری خودکار داده‌ها را فعال کنید و کلید API و شناسه اصلی سازمان (Organization core ID) که در بخش قبل به دست آورده‌اید را وارد کنید.

نیازی به وارد کردن نام کاربری یا رمز عبور نیست. پس از اتمام، روی ذخیره کلیک کنید.

فعال کردن اشتراک‌گذاری امن سیگنال

مناقصه

به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید

مناقصه

به Inventory > Secure Signals بروید. در زیر Secure signals ، Unity Ads را جستجو کنید و Enable app integration را روشن کنید.

روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

امکان اشتراک‌گذاری امن سیگنال برای مناقصه SDK

مناقصه

به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیش‌فرض ، گزینه «اجازه اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.

روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

پیکربندی پیشنهاد قیمت تبلیغات Unity

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

روی پیشنهاددهنده جدید کلیک کنید.

Unity Ads را به عنوان پیشنهاد دهنده انتخاب کنید.

برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.

روی انجام شد کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

پیکربندی نگاشت واحد تبلیغات

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

شرکت Unity Ads را انتخاب کنید.

به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.

واحد تبلیغاتی خاص را انتخاب کنید. یک واحد تبلیغاتی و قالب آن، برنامه موبایل را به عنوان نوع موجودی و برنامه موبایل خود انتخاب کنید. سپس، شناسه بازی و شناسه قرارگیری به دست آمده در بخش قبلی را وارد کنید.

در نهایت، روی ذخیره کلیک کنید.

آبشار

به بخش تحویل > گروه‌های بازده بروید و روی دکمه‌ی گروه بازده جدید کلیک کنید. موجودی و برنامه‌ی خود را انتخاب کنید.

به Yield partners بروید و روی Add Mediation partner کلیک کنید.

شرکتی را که در بخش قبل برای Unity Ads ایجاد کردید، انتخاب کنید. در قسمت Integration type گزینه Mobile SDK mediation ، در قسمت Platform گزینه Android و در قسمت Status گزینه Active را انتخاب کنید.

شناسه بازی (Game ID) و شناسه مکان (Placement ID) که در بخش قبل به دست آوردید و مقدار پیش‌فرض CPM را وارد کنید. روی ذخیره (Save) کلیک کنید.

اضافه کردن Unity Ads به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده

برای افزودن Unity Ads به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری Ad Manager، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.

مرحله ۳: SDK و آداپتور Unity Ads را وارد کنید

در فایل gradle سطح برنامه خود، وابستگی‌های پیاده‌سازی زیر را اضافه کنید:

کاتلین 

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.unity3d.ads:unity-ads:4.20.0")
    implementation("com.google.ads.mediation:unity:4.20.0.1")
}

گرووی 

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.unity3d.ads:unity-ads:4.20.0'
    implementation 'com.google.ads.mediation:unity:4.20.0.1'
}

ادغام دستی

  1. آخرین نسخه SDK مربوط به Unity Ads ( unity-ads.aar ) را از مخزن گیت‌هاب آنها دانلود کرده و به پروژه خود اضافه کنید.

  2. به مصنوعات آداپتور Unity Ads در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور Unity Ads را دانلود کنید و آن را به پروژه خود اضافه کنید.

مرحله ۴: تنظیمات حریم خصوصی را روی SDK تبلیغات Unity پیاده‌سازی کنید

برای رعایت سیاست رضایت کاربر Google EU ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر ذخیره‌سازی‌های محلی در صورت لزوم قانونی، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات، دریافت کنید. این سیاست منعکس‌کننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از داده‌ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره میانجیگری خود هستید.

آداپتور اندروید Unity Ads نسخه ۴.۱۹.۰.۱ و بالاتر، از انتقال سیگنال‌های رضایت GDPR از پلتفرم‌های مدیریت رضایت که با چارچوب شفافیت و رضایت (TCF) IAB ادغام می‌شوند، به Unity Ads SDK پشتیبانی می‌کند. برای اطلاعات بیشتر، به تنظیم پیکربندی رضایت TCF یا غیر TCF مراجعه کنید.

قوانین حفظ حریم خصوصی ایالت‌های آمریکا

قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف می‌کند) را می‌دهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه می‌شود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، امکان فعال کردن پردازش داده‌های محدود برای سرویس تبلیغات گوگل را ارائه می‌دهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطه‌گری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطه‌گری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنمایی‌های هر یک از این شبکه‌ها پیروی کنید.

در نسخه ۲.۰.۰ SDK، Unity Ads یک API برای پشتیبانی از تنظیمات حریم خصوصی اضافه کرد. نمونه کد زیر نحوه ارسال این اطلاعات رضایت به Unity Ads SDK را نشان می‌دهد. اگر تصمیم دارید اطلاعات رضایت را به صورت دستی به Unity Ads SDK ارسال کنید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK (Legacy) ، این کد فراخوانی شود.

جاوا 

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

کاتلین 

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()

برای جزئیات بیشتر و مقادیری که می‌توان در هر روش ارائه داد، به بخش انطباق با قانون حفظ حریم خصوصی مصرف‌کنندگان Unity Ads مراجعه کنید.

درمان تعیین سن

آداپتور میانجیگری Unity Ads نسخه ۴.۱۶.۶.۰ و بالاتر، تنظیمات مربوط به کودکان و تنظیمات مربوط به کاربران زیر سن قانونی را به Unity Ads منتقل می‌کند.

برای پردازش این سیگنال‌ها بر اساس هر کاربر، Unity Ads از شما می‌خواهد که تعیین مخاطب مختلط را در داشبورد کسب درآمد Unity فعال کنید. برای اطلاعات بیشتر در مورد فعال کردن تعیین مخاطب مختلط در پروژه خود، به تنظیم تعیین سن در سطح بازی مراجعه کنید.

مرحله ۵: اضافه کردن کد مورد نیاز

بارگذاری تبلیغ با زمینه فعالیت

هنگام بارگذاری قالب‌های تبلیغات بنری، بینابینی و بومی، زمینه Activity را ارسال کنید. بدون زمینه فعالیت، بارگذاری تبلیغ با شکست مواجه خواهد شد.

مرحله ۶: پیاده‌سازی خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید و حالت آزمایشی را در رابط کاربری Unity Ads فعال کرده‌اید .

تأیید تبلیغات آزمایشی

برای تأیید اینکه تبلیغات آزمایشی را از Unity Ads دریافت می‌کنید، تست منبع تبلیغات تکی را در Ad inspector با استفاده از منبع(های) تبلیغاتی Unity Ads (Bidding) و Unity Ads (Waterfall) فعال کنید.

کدهای خطا

اگر آداپتور نتواند تبلیغی از Unity Ads دریافت کند، ناشران می‌توانند خطای اساسی را از پاسخ تبلیغ با استفاده ResponseInfo.getAdapterResponses() تحت کلاس‌های زیر بررسی کنند:

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

در اینجا کدها و پیام‌های همراه که توسط آداپتور UnityAds هنگام عدم بارگیری یک تبلیغ نمایش داده می‌شوند، آمده است:

کد خطا دلیل
۰-۱۰ UnityAds SDK خطایی را برگرداند. برای جزئیات بیشتر به کد مراجعه کنید.
۱۰۱ پارامترهای سرور UnityAds که در رابط کاربری Ad Manager پیکربندی شده‌اند، وجود ندارند/نامعتبر هستند.
۱۰۲ UnityAds یک موقعیت مکانی با حالت NO_FILL را برگرداند.
۱۰۳ UnityAds یک موقعیت مکانی را با وضعیت غیرفعال (DISABLED) برگرداند.
۱۰۴ UnityAds سعی کرد تبلیغی با متن تهی (null context) نمایش دهد.
۱۰۵ زمینه‌ای که برای مقداردهی اولیه، بارگذاری و/یا نمایش تبلیغات از Unity Ads استفاده می‌شود، یک نمونه Activity نیست.
۱۰۶ UnityAds سعی کرد تبلیغی را نمایش دهد که آماده نمایش نبود.
۱۰۷ UnityAds روی این دستگاه پشتیبانی نمی‌شود.
۱۰۸ UnityAds فقط می‌تواند در هر بار نمایش، یک تبلیغ را بارگذاری کند.
۱۰۹ UnityAds با وضعیت خطا (ERROR) کار خود را به پایان رساند.
۱۱۰ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط UnityAds مطابقت ندارد.
۱۱۱ UnityAds خطای مقداردهی اولیه را نشان داد.
۱۱۲ تبلیغات یونیتی یک توکن پیشنهاد قیمت تهی یا خالی را برمی‌گرداند.
۲۰۰-۲۰۴ خطای مربوط به بنر UnityAds. برای جزئیات بیشتر به کد مراجعه کنید.

تغییرات آداپتور میانجیگری اندروید تبلیغات یونیتی

نسخه ۴.۲۰.۱.۰ (در حال انجام)

نسخه ۴.۲۰.۰.۲ (در حال انجام)

  • وابستگی کاتلین آداپتور را به نسخه ۱.۹.۰ (حداقل نسخه کاتلین پشتیبانی شده توسط GMA NextGen SDK) پین کنید.

نسخه ۴.۲۰.۰.۱

  • نیاز به آداپتور برای زمینه فعالیت برای بارگیری تبلیغات بنری حذف شد.
  • به‌روزرسانی جمع‌آوری سیگنال‌های پیشنهاد قیمت به گونه‌ای که در صورت دریافت سیگنال خالی، با خطا مواجه شده و گزارش خطا دهد.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۴.۰ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • نسخه ۴.۲۰.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۲۰.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.20.0.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۳.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • نسخه ۴.۲۰.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۹.۰.۱

  • آداپتور اکنون در صورت اعمال GDPR، رضایت GDPR موجود در IABTCF_AddtlConsent را به طور خودکار به Unity Ads SDK ارسال می‌کند.
  • به‌روزرسانی شد تا هنگام نمایش تبلیغ بینابینی یونیتی، میزان نمایش تبلیغ گزارش شود.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۳.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • نسخه ۴.۱۹.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۹.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.19.0.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۲.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۹.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۸.۱.۰

  • پیاده‌سازی قدیمی API برای تبلیغات بینابینی حذف شد. آداپتور شروع به استفاده از پیاده‌سازی جدید API خواهد کرد.
  • سازگاری تأیید شده با Unity Ads SDK 4.18.1.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۲.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۸.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۸.۰.۰

  • ویژگی برای ساخت آداپتور با وابستگی به GMA Next-Gen SDK اضافه شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.18.0.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۰.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • نسخه ۴.۱۸.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۷.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.17.0.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۷.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۶.۰

  • پشتیبانی از ارسال پارامتر tagForUnderAgeOfConsent برای SDK تبلیغات موبایل گوگل به SDK تبلیغات یونیتی اضافه شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.16.6.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۹.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۶ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۵.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.16.5.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۸.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۵ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۴.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.16.4.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۴ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۳.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.16.3.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۳ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۲.۰

  • پارامتر فرمت هنگام دریافت توکن سیگنال از Unity Ads SDK اضافه شد.
  • پیاده‌سازی قدیمی API بنر حذف شد. توجه: پیاده‌سازی جدید API بنر از قبل در آداپتور وجود دارد و GMA SDK از آن استفاده خواهد کرد.
  • یک کد خطا برای شناسایی عدم موفقیت نمایش به دلیل تایم اوت اضافه شد.
  • ارجاعات سطح کلاس به اشیاء Context حذف شد تا به مشکلات نشت حافظه کمک کند.
  • سازگاری تأیید شده با Unity Ads SDK 4.16.2.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.16.1.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۰.۱

  • بررسی اندازه از آداپتور برای تبلیغات بنری RTB حذف شد.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.16.0.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۵.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.15.1.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۵.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۵.۰.۰

  • به‌روزرسانی شد تا در صورتی که context یک activity نباشد، جمع‌آوری سیگنال برای بنرهای تبلیغاتی RTB با شکست مواجه شود (زیرا Unity Ads SDK برای بارگذاری بنرهای تبلیغاتی RTB به activity context نیاز دارد). این اصلاحیه نرخ موفقیت بارگذاری تبلیغات را برای ناشران افزایش می‌دهد.
  • سازگاری تأیید شده با Unity Ads SDK 4.15.0.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۵.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۴.۲.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.14.2.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۴.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۴.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.14.1.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۴.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۴.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.14.0.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۴.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۳.۲.۰

  • حداقل سطح API اندروید مورد نیاز به ۲۳ ارتقا یافت.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۴.۰.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۳.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۳.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.13.1.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۳.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۳.۰.۰

  • بررسی‌های غیرضروریِ زمینه‌ی Activity از آداپتور حذف شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.13.0.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۳.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۵.۱

  • با تنظیم شناسه شیء هنگام بارگیری تبلیغات، مشکل بارگذاری بنرهای تبلیغاتی پیشنهاد قیمت برطرف شد.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۵ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۵.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.12.5.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۵ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۴.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.12.4.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۴ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۳.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.12.3.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۳ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۲.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.12.2.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.12.1.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.12.0.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۱.۳.۰

  • پشتیبانی از پیشنهاد قیمت برای قالب‌های تبلیغات بنری، بینابینی و پاداشی اضافه شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.11.3.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۱.۳ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۱.۲.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.11.2.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۱.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۰.۰.۰

  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۳.۰.۰ به‌روزرسانی شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.10.0.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۰.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۹.۳.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.9.3.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۹.۳ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۹.۲.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.9.2.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۹.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۹.۱.۰

  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۳.۰ به‌روزرسانی شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.9.1.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۹.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۸.۰.۰

  • هنگامی که Unity Ads SDK متد فراخوانی جدید onBannerShown() خود را فراخوانی می‌کند، میزان نمایش تبلیغ را گزارش می‌دهد.
  • سازگاری تأیید شده با Unity Ads SDK 4.8.0.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۸.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۷.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.7.1.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۷.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۷.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.7.0.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۶.۱.۱

  • آداپتور برای استفاده از کلاس VersionInfo جدید به‌روزرسانی شد.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۰.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۶.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۶.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.6.1.

ساخته و آزمایش شده با:

  • نسخه ۲۱.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل
  • نسخه ۴.۶.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۶.۰.۰

  • پشتیبانی از ارسال اطلاعات COPPA به SDK تبلیغات یونیتی اضافه شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.6.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۵.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۱.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل
  • نسخه ۴.۶.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۵.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.5.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۴.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۱.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل
  • نسخه ۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۴.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.4.1.

ساخته و آزمایش شده با:

  • نسخه ۲۱.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایل گوگل
  • نسخه ۴.۴.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۴.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.4.0.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۲۱.۲.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۱.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایل گوگل
  • نسخه ۴.۴.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۳.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.3.0.
  • تابع فراخوانی onAdOpened() اکنون هنگام شروع پخش تبلیغات بینابینی و پاداشی، ارسال می‌شود.

ساخته و آزمایش شده با:

  • نسخه ۲۱.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل
  • نسخه ۴.۳.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۲.۱.۱

  • compileSdkVersion و targetSdkVersion به API 31 به‌روزرسانی شدند.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۰.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۱.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۲.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۲.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.2.1.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۲.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.1.0.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۰.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.0.1.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.6.0 به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۰.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۰.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.0.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به 20.5.0 به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۰.۰ کیت توسعه نرم‌افزاری (SDK) تبلیغات یونیتی.

نسخه ۳.۷.۵.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.7.5.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۷.۵ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۷.۴.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.7.4.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • SDK تبلیغات یونیتی نسخه ۳.۷.۴.

نسخه ۳.۷.۲.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.7.2.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.2.0 به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۷.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۷.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.7.1.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.1.0 به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۷.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۶.۲.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.6.2.
  • مشکلی که باعث می‌شد تبلیغات جایزه‌دار، کلیک‌های برگشتی را هدایت نکنند، برطرف شد.
  • SDK مربوط به UnityAds از نسخه آداپتور همراه حذف شده است. اکنون ناشران موظفند SDK مربوط به UnityAds را به صورت دستی به عنوان یک وابستگی اضافی اضافه کنند.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۸.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۸.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۶.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۶.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.6.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۹.۶.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۵.۱.۱

  • مشکلی که باعث می‌شد هنگام تلاش برای درخواست چندین تبلیغ بینابینی و پاداشی، با مشکل مواجه شوید، برطرف شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۵.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۵.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.5.1.
  • مشکلی که باعث می‌شد درخواست‌های تبلیغات بنری هوشمند با شکست مواجه شوند، برطرف شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۵.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۵.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.5.0.
  • پشتیبانی از بنر تطبیقی ​​اضافه شد.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۵.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۵.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۴.۸.۰

  • خطای NullPointerException که هنگام تخریب یک بنر تبلیغاتی رخ می‌داد، برطرف شد.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۳.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۴.۸ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۴.۶.۱

  • یک آداپتور ساختم که شامل SDK تبلیغات یونیتی که همراه آن است، نمی‌شود. این به ناشران این امکان را می‌دهد که هنگام میانجیگری در یونیتی، از سرویس‌های تبلیغات یونیتی استفاده کنند تا از مشکلات وابستگی متناقض جلوگیری شود.
    • ناشران می‌توانند با اضافه کردن وابستگی com.google.ads.mediation:unity-adapter-only:xyzp به فایل build.gradle سطح برنامه خود، از این مورد استفاده کنند.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۴.۶ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۴.۶.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.4.6.
  • آداپتور اکنون وقتی روی یک بنر تبلیغاتی کلیک می‌شود، تابع فراخوانی onAdOpened() را ارسال می‌کند.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۴.۶ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۴.۲.۳

  • کدهای خطای توصیفی و دلایل خرابی‌های بارگذاری/نمایش آداپتور اضافه شد.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۱.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۴.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۴.۲.۲

  • مشکل خطای ConcurrentModificationException که هنگام نمایش خطا در Unity Ads رخ می‌داد، برطرف شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۰.۱ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۴.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۴.۲.۱

  • بهبود ارسال خطاهای یونیتی برای تشخیص زودتر خطاهای مقداردهی اولیه و بارگذاری تبلیغات و کاهش زمان‌های وقفه.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۰.۱ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۰.۱ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۴.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۴.۲.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.4.2.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۳.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۸.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۴.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۴.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.4.0.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۳.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۸.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۴.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۳.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.3.0.

ساخته و آزمایش شده با:

  • نسخه ۱۸.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۳.۳.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۳.۲.۰.۱

  • مشکل خطای اشاره‌گر تهی که هنگام فراخوانی loadAd() قبل از فراخوانی UnityAds.initialize() رخ می‌داد، برطرف شد.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۲.۰ به‌روزرسانی شد.

نسخه ۳.۲.۰.۰

  • مشکلی که باعث می‌شد درخواست‌های بنر تبلیغاتی با شکست مواجه شوند، برطرف شد.
  • سازگاری تأیید شده با Unity Ads SDK 3.2.0.
  • آداپتور را به AndroidX منتقل کردم.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۸.۱.۱ به‌روزرسانی شد.

نسخه ۳.۱.۰.۰

  • پشتیبانی از اندازه‌های انعطاف‌پذیر بنرهای تبلیغاتی اضافه شد.
  • اگر اندازه درخواستی با هیچ یک از اندازه‌های بنر تبلیغاتی Unity سازگار نباشد، آداپتور درخواست تبلیغ را رد می‌کند.
  • سازگاری تأیید شده با Unity Ads SDK 3.1.0.

نسخه ۳.۰.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.0.1.
  • اشکالی که باعث می‌شد هنگام نمایش تبلیغات بینابینی، خطای «NPE» نمایش داده شود، برطرف شد.

نسخه ۳.۰.۰.۲

  • آداپتور به‌روزرسانی شده برای پشتیبانی از API پاداش‌دهی بتای باز جدید.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۷.۲.۰ به‌روزرسانی شد.

نسخه ۳.۰.۰.۱

  • پشتیبانی از بنر تبلیغاتی Unity اضافه شد.

نسخه ۳.۰.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 3.0.0.

نسخه ۲.۳.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 2.3.0.

نسخه ۲.۲.۱.۱

  • آداپتور به‌روزرسانی شد تا رویداد تبلیغ onRewardedVideoComplete() را فراخوانی کند.

نسخه ۲.۲.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 2.2.1.

نسخه ۲.۲.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 2.2.0.

نسخه ۲.۱.۲.۰

  • سازگاری تأیید شده با Unity Ads SDK 2.1.2.

نسخه ۲.۱.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 2.1.1.

نسخه ۲.۱.۰.۰

  • آداپتور به‌روزرسانی شد تا با Unity Ads SDK 2.1.0 سازگار شود.

نسخه ۲.۰.۸.۰

  • سازگاری تأیید شده با Unity Ads SDK 2.0.8.

نسخه ۲.۰.۷.۰

  • استفاده از گزارش کلیک Unity Ads (آمار کلیک AdMob و Unity Ads مطابقت خواهد داشت).
  • پشتیبانی از فراخوانی onAdLeftApplication اضافه شد.

نسخه ۲.۰.۶.۰

  • سازگاری تأیید شده با Unity Ads SDK 2.0.6.

نسخه ۲.۰.۵.۰

  • اکنون می‌توان آداپتورها را به عنوان یک وابستگی کامپایل با افزودن موارد زیر به تگ وابستگی‌های فایل build.gradle اضافه کرد: compile 'com.google.ads.mediation:unity:2.0.5.0'
  • به جای یک فایل jar، توزیع آداپتور به صورت aar انجام شد (برای دستورالعمل‌های بیشتر به README مراجعه کنید).

نسخه ۲.۰.۴.۰

  • اشکالی که باعث می‌شد تبلیغات ویدیویی جایزه‌دار هنگام بارگذاری اولیه یک تبلیغ بینابینی، بارگذاری نشوند، برطرف شد.

نسخه ۲.۰.۲.۰

  • سیستم نامگذاری نسخه به [نسخه SDK تبلیغات یونیتی].[نسخه وصله آداپتور] تغییر یافت.
  • حداقل SDK مورد نیاز Unity Ads به نسخه ۲.۰.۲ به‌روزرسانی شد.
  • حداقل SDK مورد نیاز برای تبلیغات موبایلی گوگل به نسخه ۹.۰.۰ به‌روزرسانی شد.
  • برنامه‌ها دیگر نیازی به فراخوانی UnityAds.changeActivity(this) ندارند.

نسخه ۱.۰.۰

  • انتشار اولیه. از تبلیغات ویدیویی مبتنی بر پاداش و تبلیغات بینابینی پشتیبانی می‌کند.
،
پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر ، اندروید (قدیمی)

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK (Legacy) برای بارگذاری و نمایش تبلیغات از Unity Ads با استفاده از میانجیگری استفاده کنید، که شامل ادغام‌های پیشنهاد قیمت و آبشاری می‌شود. این راهنما نحوه اضافه کردن Unity Ads به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور Unity Ads در یک برنامه اندروید را پوشش می‌دهد.

ادغام‌ها و قالب‌های تبلیغاتی پشتیبانی‌شده

آداپتور میانجیگری برای Unity Ads دارای قابلیت‌های زیر است:

ادغام
مناقصه
آبشار ۱
قالب‌ها
بنر
بینابینی
پاداش داده شده
بومی

پیش‌نیازها

قبل از ادامه، موارد زیر را بررسی کنید:

  • اندروید API سطح ۲۴ یا بالاتر.
  • [برای پیشنهاد قیمت]: برای ادغام تمام قالب‌های تبلیغاتی پشتیبانی‌شده در پیشنهاد قیمت، از آداپتور Unity نسخه ۴.۱۶.۰.۱ یا بالاتر ( آخرین نسخه توصیه می‌شود ) استفاده کنید.

مرحله 1: تنظیمات را در رابط کاربری تبلیغات یونیتی تنظیم کنید

در Unity Ads ثبت نام کنید یا وارد شوید .

ایجاد یک پروژه

در داشبورد Unity Ads ، به بخش Projects بروید و روی New کلیک کنید.

فرم را پر کنید و برای اضافه کردن پروژه خود، روی ایجاد کلیک کنید.

به بخش کسب درآمد از تبلیغات یونیتی بروید، سپس روی شروع به کار کلیک کنید.

در پنجره New Project ، گزینه I will use Mediation and Google Admob for Mediation Partner را انتخاب کنید، سپس روی Next کلیک کنید.

گزینه مربوط به تنظیمات تبلیغات را انتخاب کنید، سپس روی «بعدی» کلیک کنید.

تنظیمات قرارگیری خود را انتخاب کنید، سپس روی «بعدی» کلیک کنید.

مناقصه

آبشار

فرم را پر کنید، سپس روی افزودن پروژه کلیک کنید.

به شناسه بازی (Game ID) توجه کنید.

ایجاد واحدهای تبلیغاتی و جایگاه‌ها

به بخش کسب درآمد از تبلیغات یونیتی > مکان‌ها بروید، سپس پروژه خود را انتخاب کنید و روی افزودن واحد تبلیغاتی کلیک کنید.

نام واحد تبلیغاتی را وارد کنید، سپس پلتفرم و قالب تبلیغاتی خود را انتخاب کنید.

به بخش کسب درآمد > مکان‌ها بروید، سپس روی افزودن واحد تبلیغاتی کلیک کنید.

نام واحد تبلیغاتی خود را وارد کنید، سپس پلتفرم و قالب تبلیغاتی خود را انتخاب کنید.

برای تنظیمات، آبشار (Waterfall) را انتخاب کنید. در قسمت جایگذاری (Placement) ، نام جایگذاری (Placement name) ، برچسب‌گذاری جغرافیایی (GEO Tagging) و هدف (Target) را وارد کنید.

شناسه‌ی محل قرارگیری را یادداشت کنید.

در نهایت، برای ذخیره واحد تبلیغاتی و جایگاه آن، روی افزودن واحد تبلیغاتی کلیک کنید.

کلید API گزارش تبلیغات Unity را پیدا کنید

مناقصه

این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.

آبشار

به Unity Ads Monetization > API management بروید و کلید API را در Monetization Stats API Access یادداشت کنید.

سپس، به مسیر Unity Ads Monetization > Organization Settings بروید و شناسه اصلی سازمان (Organization core ID) را یادداشت کنید.

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .

برای پیاده‌سازی app-ads.txt برای Unity Ads، به بخش راه‌اندازی app-ads.txt برای اولین بار مراجعه کنید.

حالت تست را روشن کنید

حالت آزمایشی را می‌توان از داشبورد Unity Ads فعال کرد. به Unity Ads Monetization > Testing بروید.

شما می‌توانید با کلیک روی دکمه ویرایش در کنار فروشگاه گوگل پلی ، فعال کردن حالت تست کلاینت Override و انتخاب حالت تست اجباری (یعنی استفاده از تبلیغات آزمایشی) برای همه دستگاه‌ها، حالت تست را برای برنامه خود اجباری کنید.

از طرف دیگر، می‌توانید با کلیک روی «افزودن دستگاه آزمایشی»، حالت آزمایشی را برای دستگاه‌های خاص فعال کنید.

جزئیات دستگاه آزمایشی خود را وارد کنید، سپس روی ذخیره کلیک کنید.

مرحله ۲: تنظیم تقاضای تبلیغات یونیتی در رابط کاربری مدیریت تبلیغات

وارد حساب مدیر تبلیغات خود شوید.

تبلیغات Unity را در شرکت‌ها اضافه کنید

مناقصه

این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.

آبشار

به بخش مدیریت > شرکت‌ها بروید، سپس در تب «همه شرکت‌ها» روی دکمه «شرکت جدید» کلیک کنید. شبکه تبلیغاتی را انتخاب کنید.

Unity Ads را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید. جمع‌آوری خودکار داده‌ها را فعال کنید و کلید API و شناسه اصلی سازمان (Organization core ID) که در بخش قبل به دست آورده‌اید را وارد کنید.

نیازی به وارد کردن نام کاربری یا رمز عبور نیست. پس از اتمام، روی ذخیره کلیک کنید.

فعال کردن اشتراک‌گذاری امن سیگنال

مناقصه

به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید

مناقصه

به Inventory > Secure Signals بروید. در زیر Secure signals ، Unity Ads را جستجو کنید و Enable app integration را روشن کنید.

روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

امکان اشتراک‌گذاری امن سیگنال برای مناقصه SDK

مناقصه

به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیش‌فرض ، گزینه «اجازه اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.

روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

پیکربندی پیشنهاد قیمت تبلیغات Unity

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

روی پیشنهاددهنده جدید کلیک کنید.

Unity Ads را به عنوان پیشنهاد دهنده انتخاب کنید.

برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.

روی انجام شد کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

پیکربندی نگاشت واحد تبلیغات

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

شرکت Unity Ads را انتخاب کنید.

به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.

واحد تبلیغاتی خاص را انتخاب کنید. یک واحد تبلیغاتی و قالب آن، برنامه موبایل را به عنوان نوع موجودی و برنامه موبایل خود انتخاب کنید. سپس، شناسه بازی و شناسه قرارگیری به دست آمده در بخش قبلی را وارد کنید.

در نهایت، روی ذخیره کلیک کنید.

آبشار

به بخش تحویل > گروه‌های بازده بروید و روی دکمه‌ی گروه بازده جدید کلیک کنید. موجودی و برنامه‌ی خود را انتخاب کنید.

به Yield partners بروید و روی Add Mediation partner کلیک کنید.

شرکتی را که در بخش قبل برای Unity Ads ایجاد کردید، انتخاب کنید. در قسمت Integration type گزینه Mobile SDK mediation ، در قسمت Platform گزینه Android و در قسمت Status گزینه Active را انتخاب کنید.

شناسه بازی (Game ID) و شناسه مکان (Placement ID) که در بخش قبل به دست آوردید و مقدار پیش‌فرض CPM را وارد کنید. روی ذخیره (Save) کلیک کنید.

اضافه کردن Unity Ads به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده

برای افزودن Unity Ads به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری Ad Manager، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.

مرحله ۳: SDK و آداپتور Unity Ads را وارد کنید

در فایل gradle سطح برنامه خود، وابستگی‌های پیاده‌سازی زیر را اضافه کنید:

کاتلین 

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.unity3d.ads:unity-ads:4.20.0")
    implementation("com.google.ads.mediation:unity:4.20.0.1")
}

گرووی 

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.unity3d.ads:unity-ads:4.20.0'
    implementation 'com.google.ads.mediation:unity:4.20.0.1'
}

ادغام دستی

  1. آخرین نسخه SDK مربوط به Unity Ads ( unity-ads.aar ) را از مخزن گیت‌هاب آنها دانلود کرده و به پروژه خود اضافه کنید.

  2. به مصنوعات آداپتور Unity Ads در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور Unity Ads را دانلود کنید و آن را به پروژه خود اضافه کنید.

مرحله ۴: تنظیمات حریم خصوصی را روی SDK تبلیغات Unity پیاده‌سازی کنید

برای رعایت سیاست رضایت کاربر Google EU ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر ذخیره‌سازی‌های محلی در صورت لزوم قانونی، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات، دریافت کنید. این سیاست منعکس‌کننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از داده‌ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره میانجیگری خود هستید.

آداپتور اندروید Unity Ads نسخه ۴.۱۹.۰.۱ و بالاتر، از انتقال سیگنال‌های رضایت GDPR از پلتفرم‌های مدیریت رضایت که با چارچوب شفافیت و رضایت (TCF) IAB ادغام می‌شوند، به Unity Ads SDK پشتیبانی می‌کند. برای اطلاعات بیشتر، به تنظیم پیکربندی رضایت TCF یا غیر TCF مراجعه کنید.

قوانین حفظ حریم خصوصی ایالت‌های آمریکا

قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف می‌کند) را می‌دهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه می‌شود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، امکان فعال کردن پردازش داده‌های محدود برای سرویس تبلیغات گوگل را ارائه می‌دهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطه‌گری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطه‌گری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنمایی‌های هر یک از این شبکه‌ها پیروی کنید.

در نسخه ۲.۰.۰ SDK، Unity Ads یک API برای پشتیبانی از تنظیمات حریم خصوصی اضافه کرد. نمونه کد زیر نحوه ارسال این اطلاعات رضایت به Unity Ads SDK را نشان می‌دهد. اگر تصمیم دارید اطلاعات رضایت را به صورت دستی به Unity Ads SDK ارسال کنید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK (Legacy) ، این کد فراخوانی شود.

جاوا 

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

کاتلین 

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()

برای جزئیات بیشتر و مقادیری که می‌توان در هر روش ارائه داد، به بخش انطباق با قانون حفظ حریم خصوصی مصرف‌کنندگان Unity Ads مراجعه کنید.

درمان تعیین سن

آداپتور میانجیگری Unity Ads نسخه ۴.۱۶.۶.۰ و بالاتر، تنظیمات مربوط به کودکان و تنظیمات مربوط به کاربران زیر سن قانونی را به Unity Ads منتقل می‌کند.

برای پردازش این سیگنال‌ها بر اساس هر کاربر، Unity Ads از شما می‌خواهد که تعیین مخاطب مختلط را در داشبورد کسب درآمد Unity فعال کنید. برای اطلاعات بیشتر در مورد فعال کردن تعیین مخاطب مختلط در پروژه خود، به تنظیم تعیین سن در سطح بازی مراجعه کنید.

مرحله ۵: اضافه کردن کد مورد نیاز

بارگذاری تبلیغ با زمینه فعالیت

هنگام بارگذاری قالب‌های تبلیغات بنری، بینابینی و بومی، زمینه Activity را ارسال کنید. بدون زمینه فعالیت، بارگذاری تبلیغ با شکست مواجه خواهد شد.

مرحله ۶: پیاده‌سازی خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید و حالت آزمایشی را در رابط کاربری Unity Ads فعال کرده‌اید .

تأیید تبلیغات آزمایشی

برای تأیید اینکه تبلیغات آزمایشی را از Unity Ads دریافت می‌کنید، تست منبع تبلیغات تکی را در Ad inspector با استفاده از منبع(های) تبلیغاتی Unity Ads (Bidding) و Unity Ads (Waterfall) فعال کنید.

کدهای خطا

اگر آداپتور نتواند تبلیغی از Unity Ads دریافت کند، ناشران می‌توانند خطای اساسی را از پاسخ تبلیغ با استفاده ResponseInfo.getAdapterResponses() تحت کلاس‌های زیر بررسی کنند:

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

در اینجا کدها و پیام‌های همراه که توسط آداپتور UnityAds هنگام عدم بارگیری یک تبلیغ نمایش داده می‌شوند، آمده است:

کد خطا دلیل
۰-۱۰ UnityAds SDK خطایی را برگرداند. برای جزئیات بیشتر به کد مراجعه کنید.
۱۰۱ پارامترهای سرور UnityAds که در رابط کاربری Ad Manager پیکربندی شده‌اند، وجود ندارند/نامعتبر هستند.
۱۰۲ UnityAds یک موقعیت مکانی با حالت NO_FILL را برگرداند.
۱۰۳ UnityAds یک موقعیت مکانی را با وضعیت غیرفعال (DISABLED) برگرداند.
۱۰۴ UnityAds سعی کرد تبلیغی با متن تهی (null context) نمایش دهد.
۱۰۵ زمینه‌ای که برای مقداردهی اولیه، بارگذاری و/یا نمایش تبلیغات از Unity Ads استفاده می‌شود، یک نمونه Activity نیست.
۱۰۶ UnityAds سعی کرد تبلیغی را نمایش دهد که آماده نمایش نبود.
۱۰۷ UnityAds روی این دستگاه پشتیبانی نمی‌شود.
۱۰۸ UnityAds فقط می‌تواند در هر بار نمایش، یک تبلیغ را بارگذاری کند.
۱۰۹ UnityAds با وضعیت خطا (ERROR) کار خود را به پایان رساند.
۱۱۰ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط UnityAds مطابقت ندارد.
۱۱۱ UnityAds خطای مقداردهی اولیه را نشان داد.
۱۱۲ تبلیغات یونیتی یک توکن پیشنهاد قیمت تهی یا خالی را برمی‌گرداند.
۲۰۰-۲۰۴ خطای مربوط به بنر UnityAds. برای جزئیات بیشتر به کد مراجعه کنید.

تغییرات آداپتور میانجیگری اندروید تبلیغات یونیتی

نسخه ۴.۲۰.۱.۰ (در حال انجام)

نسخه ۴.۲۰.۰.۲ (در حال انجام)

  • وابستگی کاتلین آداپتور را به نسخه ۱.۹.۰ (حداقل نسخه کاتلین پشتیبانی شده توسط GMA NextGen SDK) پین کنید.

نسخه ۴.۲۰.۰.۱

  • نیاز به آداپتور برای زمینه فعالیت برای بارگیری تبلیغات بنری حذف شد.
  • به‌روزرسانی جمع‌آوری سیگنال‌های پیشنهاد قیمت به گونه‌ای که در صورت دریافت سیگنال خالی، با خطا مواجه شده و گزارش خطا دهد.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۴.۰ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • نسخه ۴.۲۰.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۲۰.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.20.0.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۳.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • نسخه ۴.۲۰.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۹.۰.۱

  • آداپتور اکنون در صورت اعمال GDPR، رضایت GDPR موجود در IABTCF_AddtlConsent را به طور خودکار به Unity Ads SDK ارسال می‌کند.
  • به‌روزرسانی شد تا هنگام نمایش تبلیغ بینابینی یونیتی، میزان نمایش تبلیغ گزارش شود.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۳.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • نسخه ۴.۱۹.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۹.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.19.0.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۲.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۹.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۸.۱.۰

  • پیاده‌سازی قدیمی API برای تبلیغات بینابینی حذف شد. آداپتور شروع به استفاده از پیاده‌سازی جدید API خواهد کرد.
  • سازگاری تأیید شده با Unity Ads SDK 4.18.1.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۲.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۸.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۸.۰.۰

  • ویژگی برای ساخت آداپتور با وابستگی به GMA Next-Gen SDK اضافه شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.18.0.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۰.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • نسخه ۴.۱۸.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۷.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.17.0.

ساخته و آزمایش شده با:

  • نسخه ۲۵.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۷.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۶.۰

  • پشتیبانی از ارسال پارامتر tagForUnderAgeOfConsent برای SDK تبلیغات موبایل گوگل به SDK تبلیغات یونیتی اضافه شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.16.6.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۹.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۶ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۵.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.16.5.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۸.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۵ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۴.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.16.4.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۴ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۳.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.16.3.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۳ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۲.۰

  • پارامتر فرمت هنگام دریافت توکن سیگنال از Unity Ads SDK اضافه شد.
  • پیاده‌سازی قدیمی API بنر حذف شد. توجه: پیاده‌سازی جدید API بنر از قبل در آداپتور وجود دارد و GMA SDK از آن استفاده خواهد کرد.
  • یک کد خطا برای شناسایی عدم موفقیت نمایش به دلیل تایم اوت اضافه شد.
  • ارجاعات سطح کلاس به اشیاء Context حذف شد تا به مشکلات نشت حافظه کمک کند.
  • سازگاری تأیید شده با Unity Ads SDK 4.16.2.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.16.1.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۰.۱

  • بررسی اندازه از آداپتور برای تبلیغات بنری RTB حذف شد.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۶.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.16.0.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۶.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۵.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.15.1.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۵.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۵.۰.۰

  • به‌روزرسانی شد تا در صورتی که context یک activity نباشد، جمع‌آوری سیگنال برای بنرهای تبلیغاتی RTB با شکست مواجه شود (زیرا Unity Ads SDK برای بارگذاری بنرهای تبلیغاتی RTB به activity context نیاز دارد). این اصلاحیه نرخ موفقیت بارگذاری تبلیغات را برای ناشران افزایش می‌دهد.
  • سازگاری تأیید شده با Unity Ads SDK 4.15.0.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۵.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۴.۲.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.14.2.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۴.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۴.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.14.1.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۴.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۴.۰.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.14.0.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۴.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۳.۲.۰

  • حداقل سطح API اندروید مورد نیاز به ۲۳ ارتقا یافت.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۴.۰.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۳.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۳.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.13.1.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۳.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۳.۰.۰

  • بررسی‌های غیرضروریِ زمینه‌ی Activity از آداپتور حذف شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.13.0.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۳.۰ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۵.۱

  • با تنظیم شناسه شیء هنگام بارگیری تبلیغات، مشکل بارگذاری بنرهای تبلیغاتی پیشنهاد قیمت برطرف شد.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۵ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۵.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.12.5.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۵ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۴.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.12.4.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۴ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۳.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.12.3.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۳ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۲.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.12.2.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۲ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۱.۰

  • سازگاری تأیید شده با Unity Ads SDK 4.12.1.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۴.۱۲.۱ کیت توسعه نرم‌افزاری تبلیغات یونیتی.

نسخه ۴.۱۲.۰.۰

  • Verified compatibility with Unity Ads SDK 4.12.0.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.0.

Version 4.11.3.0

  • Added bidding support for banner, interstitial and rewarded ad formats.
  • Verified compatibility with Unity Ads SDK 4.11.3.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.11.3.

Version 4.11.2.0

  • Verified compatibility with Unity Ads SDK 4.11.2.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.11.2.

Version 4.10.0.0

  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۳.۰.۰ به‌روزرسانی شد.
  • Verified compatibility with Unity Ads SDK 4.10.0.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.10.0.

Version 4.9.3.0

  • Verified compatibility with Unity Ads SDK 4.9.3.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.9.3.

Version 4.9.2.0

  • Verified compatibility with Unity Ads SDK 4.9.2.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.9.2.

Version 4.9.1.0

  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۳.۰ به‌روزرسانی شد.
  • Verified compatibility with Unity Ads SDK 4.9.1.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.9.1.

Version 4.8.0.0

  • Reports ad impression when Unity Ads SDK invokes its new onBannerShown() callback method.
  • Verified compatibility with Unity Ads SDK 4.8.0.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.8.0.

Version 4.7.1.0

  • Verified compatibility with Unity Ads SDK 4.7.1.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.7.1.

نسخه ۴.۷.۰.۰

  • Verified compatibility with Unity Ads SDK 4.7.0.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.7.0.

نسخه ۴.۶.۱.۱

  • آداپتور برای استفاده از کلاس VersionInfo جدید به‌روزرسانی شد.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۰.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.6.1.

نسخه ۴.۶.۱.۰

  • Verified compatibility with Unity Ads SDK 4.6.1.

ساخته و آزمایش شده با:

  • Google Mobile Ads SDK version 21.5.0
  • Unity Ads SDK version 4.6.1.

نسخه ۴.۶.۰.۰

  • Added support for forwarding COPPA information to the Unity Ads SDK.
  • Verified compatibility with Unity Ads SDK 4.6.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۵.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • Google Mobile Ads SDK version 21.5.0
  • Unity Ads SDK version 4.6.0.

نسخه ۴.۵.۰.۰

  • Verified compatibility with Unity Ads SDK 4.5.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۴.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • Google Mobile Ads SDK version 21.4.0
  • Unity Ads SDK version 4.5.0.

نسخه ۴.۴.۱.۰

  • Verified compatibility with Unity Ads SDK 4.4.1.

ساخته و آزمایش شده با:

  • Google Mobile Ads SDK version 21.2.0
  • Unity Ads SDK version 4.4.1.

نسخه ۴.۴.۰.۰

  • Verified compatibility with Unity Ads SDK 4.4.0.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۲۱.۲.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • Google Mobile Ads SDK version 21.2.0
  • Unity Ads SDK version 4.4.0.

Version 4.3.0.0

  • Verified compatibility with Unity Ads SDK 4.3.0.
  • The onAdOpened() callback is now forwarded when interstitial and rewarded ads start playing.

ساخته و آزمایش شده با:

  • Google Mobile Ads SDK version 21.1.0
  • Unity Ads SDK version 4.3.0.

Version 4.2.1.1

  • compileSdkVersion و targetSdkVersion به API 31 به‌روزرسانی شدند.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۰.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۱.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.2.1.

Version 4.2.1.0

  • Verified compatibility with Unity Ads SDK 4.2.1.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.2.1.

Version 4.1.0.0

  • Verified compatibility with Unity Ads SDK 4.1.0.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.1.0.

Version 4.0.1.0

  • Verified compatibility with Unity Ads SDK 4.0.1.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.6.0 به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.0.1.

Version 4.0.0.0

  • Verified compatibility with Unity Ads SDK 4.0.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به 20.5.0 به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.0.0.

Version 3.7.5.0

  • Verified compatibility with Unity Ads SDK 3.7.5.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.5.

Version 3.7.4.0

  • Verified compatibility with Unity Ads SDK 3.7.4.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.4.

Version 3.7.2.0

  • Verified compatibility with Unity Ads SDK 3.7.2.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.2.0 به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.2.

Version 3.7.1.0

  • Verified compatibility with Unity Ads SDK 3.7.1.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.1.0 به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۲۰.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.1.

Version 3.6.2.0

  • Verified compatibility with Unity Ads SDK 3.6.2.
  • Fixed an issue where rewarded ads were not forwarding click callbacks.
  • The UnityAds SDK has been removed from the bundled adapter build. Publishers are now required to manually include the UnityAds SDK as an additional dependency.
  • Updated the minimum required Google Mobile Ads SDK version to 19.8.0.

ساخته و آزمایش شده با:

  • Google Mobile Ads SDK version 19.8.0.
  • Unity Ads SDK version 3.6.2.

Version 3.6.0.0

  • Verified compatibility with Unity Ads SDK 3.6.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۹.۶.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.6.0.

Version 3.5.1.1

  • Fixed an issue where when trying to request for multiple interstitial and rewarded ads.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.5.1.

Version 3.5.1.0

  • Verified compatibility with Unity Ads SDK 3.5.1.
  • Fixed an issue that causes smart banner ad requests to fail.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.5.1.

Version 3.5.0.0

  • Verified compatibility with Unity Ads SDK 3.5.0.
  • Added adaptive banner support.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۵.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.5.0.

Version 3.4.8.0

  • Fixed a NullPointerException error that occurs when a banner ad is destroyed.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۳.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.8.

Version 3.4.6.1

  • Created an adapter build that does not include the Unity Ads SDK bundled in. This gives publishers an option to use the Unity Ads Services when mediating on Unity to avoid conflicting dependency issues.
    • Publishers may opt to use this by including the com.google.ads.mediation:unity-adapter-only:xyzp dependency on their app-level build.gradle file.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.6.

Version 3.4.6.0

  • Verified compatibility with Unity Ads SDK 3.4.6.
  • Adapter now forwards the onAdOpened() callback when a banner ad is clicked.

Built and tested with:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.6.

Version 3.4.2.3

  • کدهای خطای توصیفی و دلایل خرابی‌های بارگذاری/نمایش آداپتور اضافه شد.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۱.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.2.2

  • Fixed a ConcurrentModificationException crash that occurred when Unity Ads returns an error.

Built and tested with:

  • نسخه ۱۹.۰.۱ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.2.1

  • Improved forwarding of Unity's errors to recognize initialization and ad load failures earlier and reduce timeouts.
  • Updated the minimum required Google Mobile Ads SDK version to 19.0.1.

Built and tested with:

  • نسخه ۱۹.۰.۱ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.2.0

  • Verified compatibility with Unity Ads SDK 3.4.2.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۳.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۸.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.0.0

  • Verified compatibility with Unity Ads SDK 3.4.0.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۳.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۸.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.0.

Version 3.3.0.0

  • Verified compatibility with Unity Ads SDK 3.3.0.

Built and tested with:

  • نسخه ۱۸.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.3.0.

Version 3.2.0.1

  • Fixed a null pointer exception crash that occurred when calling loadAd() before calling UnityAds.initialize() .
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۲.۰ به‌روزرسانی شد.

Version 3.2.0.0

  • Fixed an issue that caused Banner Ad requests to fail.
  • Verified compatibility with Unity Ads SDK 3.2.0.
  • Migrated the adapter to AndroidX.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۸.۱.۱ به‌روزرسانی شد.

Version 3.1.0.0

  • پشتیبانی از اندازه‌های انعطاف‌پذیر بنرهای تبلیغاتی اضافه شد.
  • Adapter fails the ad request if the requested size isn't compatible with any Unity Ads banner sizes
  • Verified compatibility with Unity Ads SDK 3.1.0.

Version 3.0.1.0

  • Verified compatibility with Unity Ads SDK 3.0.1.
  • Fixed a bug that caused 'NPE' while showing an interstitial ad.

Version 3.0.0.2

  • Updated adapter to support new open-beta Rewarded API.
  • Updated the minimum required Google Mobile Ads SDK version to 17.2.0.

نسخه ۳.۰.۰.۱

  • Added support for Unity Ads Banner.

Version 3.0.0.0

  • Verified compatibility with Unity Ads SDK 3.0.0.

Version 2.3.0.0

  • Verified compatibility with Unity Ads SDK 2.3.0.

Version 2.2.1.1

  • Updated the adapter to invoke the onRewardedVideoComplete() ad event.

Version 2.2.1.0

  • Verified compatibility with Unity Ads SDK 2.2.1.

Version 2.2.0.0

  • Verified compatibility with Unity Ads SDK 2.2.0.

Version 2.1.2.0

  • Verified compatibility with Unity Ads SDK 2.1.2.

Version 2.1.1.0

  • Verified compatibility with Unity Ads SDK 2.1.1.

Version 2.1.0.0

  • Updated the adapter to make it compatible with Unity Ads SDK 2.1.0.

Version 2.0.8.0

  • Verified compatibility with Unity Ads SDK 2.0.8.

Version 2.0.7.0

  • Using Unity Ads's click reporting (AdMob and Unity Ads click statistics will match up).
  • Added onAdLeftApplication callback support.

Version 2.0.6.0

  • Verified compatibility with Unity Ads SDK 2.0.6.

Version 2.0.5.0

  • The adapters can now be added as a compile dependency by adding the following to the build.gradle file's dependencies tag: compile 'com.google.ads.mediation:unity:2.0.5.0'
  • Moved to distributing the adapter as an aar instead of a jar file (see README for additional instructions).

Version 2.0.4.0

  • Fixed a bug that caused rewarded video ads to fail to load when an interstitial ad was loaded first.

Version 2.0.2.0

  • Changed the version naming system to [Unity Ads SDK version].[adapter patch version].
  • Updated the minimum required Unity Ads SDK to v2.0.2.
  • Updated the minimum required Google Mobile Ads SDK to v9.0.0.
  • Apps are no longer required to call UnityAds.changeActivity(this).

نسخه ۱.۰.۰

  • Initial release. Supports reward-based video ads and interstitial ads.
،
پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر ، اندروید (قدیمی)

This guide shows you how to use Google Mobile Ads SDK (Legacy) to load and display ads from Unity Ads using mediation , covering bidding and waterfall integrations. It covers how to add Unity Ads to an ad unit's mediation configuration, and how to integrate the Unity Ads SDK and adapter into an Android app.

ادغام‌ها و قالب‌های تبلیغاتی پشتیبانی‌شده

The mediation adapter for Unity Ads has the following capabilities:

ادغام
مناقصه
آبشار 1
قالب‌ها
بنر
بینابینی
پاداش داده شده
بومی

پیش‌نیازها

قبل از ادامه، موارد زیر را بررسی کنید:

  • Android API level 24 or later.
  • [For bidding]: To integrate all supported ad formats in bidding, use Unity adapter 4.16.0.1 or later ( latest version recommended ).

Step 1: Set up configurations in Unity Ads UI

Sign up or log in to Unity Ads.

ایجاد یک پروژه

On the Unity Ads dashboard , navigate to Projects and click New .

Fill out the form and click Create to add your project.

Navigate to Unity Ads Monetization , then click Get started .

In the New Project modal, select I will use Mediation and Google Admob for Mediation Partner , then click Next .

Select the option for ad settings, then click Next .

Select your placement setup, then click Next .

مناقصه

آبشار

Fill out the form, then click Add project .

Take note of the Game ID .

Create ad units and placements

Navigate to Unity Ads Monetization > Placements , then select your project and click Add ad unit .

Enter an Ad unit name , then select your Platform and Ad format .

Navigate to Monetization > Placements , then click Add Ad Unit .

Enter an Ad Unit Name , then select your Platform and Ad Format .

Select Waterfall for the Setup . Under Placement , enter the Placement name , GEO Tagging and Target .

Take note of the Placement ID .

Finally, click Add ad unit to save your ad unit and placement.

Locate Unity Ads Reporting API key

مناقصه

این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.

آبشار

Navigate to the Unity Ads Monetization > API management and take note of the API Key in Monetization Stats API Access .

Then, navigate to the Unity Ads Monetization > Organization Settings and take note of the Organization core ID .

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .

To implement app-ads.txt for Unity Ads, see setting up app-ads.txt for the first time .

حالت تست را روشن کنید

Test mode can be enabled from the Unity Ads dashboard . Navigate to Unity Ads Monetization > Testing .

You can force test mode for your app by clicking the edit button beside Google Play Store , enabling Override client test mode and selecting Force test mode ON (ie use test ads) for all devices .

Alternatively, you can enable test mode for specific devices by clicking Add Test Device .

Enter your test device details, then click Save .

Step 2: Set up Unity Ads demand in Ad Manager UI

وارد حساب مدیر تبلیغات خود شوید.

Add Unity Ads in Companies

مناقصه

این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.

آبشار

به بخش مدیریت > شرکت‌ها بروید، سپس در تب «همه شرکت‌ها» روی دکمه «شرکت جدید» کلیک کنید. شبکه تبلیغاتی را انتخاب کنید.

Select Unity Ads as the Ad network , enter a unique Name and enable Mediation . Turn on Automatic data collection , and enter the API Key and Organization core ID obtained in the previous section.

نیازی به وارد کردن نام کاربری یا رمز عبور نیست. پس از اتمام، روی ذخیره کلیک کنید.

فعال کردن اشتراک‌گذاری امن سیگنال

مناقصه

به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید

مناقصه

Navigate to Inventory > Secure Signals . Under Secure signals , search for Unity Ads and turn on Enable app integration .

روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

Allow secure signal sharing for SDK Bidding

مناقصه

به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیش‌فرض ، گزینه «اجازه اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.

روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

Configure Unity Ads bidding

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

روی پیشنهاددهنده جدید کلیک کنید.

Select Unity Ads as the bidder.

برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.

Click Done .

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

پیکربندی نگاشت واحد تبلیغات

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

Select the company for Unity Ads.

به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.

Choose Specific ad unit . Select an ad unit and format, Mobile app as the Inventory type , and your Mobile application . Then, enter Game ID and Placement ID obtained in the previous section.

در نهایت، روی ذخیره کلیک کنید.

آبشار

به بخش تحویل > گروه‌های بازده بروید و روی دکمه‌ی گروه بازده جدید کلیک کنید. موجودی و برنامه‌ی خود را انتخاب کنید.

به Yield partners بروید و روی Add Mediation partner کلیک کنید.

Select the company you created for Unity Ads in the previous section. Choose Mobile SDK mediation as the Integration type , Android as the Platform , and Active as the Status .

Enter the Game ID and Placement ID obtained in the previous section, and the Default CPM value. Click Save .

Add Unity Ads to GDPR and US state regulations ad partners list

Follow the steps in European regulations settings and US state regulations settings to add Unity Ads to the European and US state regulations ad partners list in the Ad Manager UI.

Step 3: Import the Unity Ads SDK and adapter

In your app-level gradle file, add the following implementation dependencies:

کاتلین 

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.unity3d.ads:unity-ads:4.20.0")
    implementation("com.google.ads.mediation:unity:4.20.0.1")
}

گرووی 

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.unity3d.ads:unity-ads:4.20.0'
    implementation 'com.google.ads.mediation:unity:4.20.0.1'
}

ادغام دستی

  1. Download the latest Unity Ads SDK ( unity-ads.aar ) from their GitHub repository and add it to your project.

  2. Navigate to the Unity Ads adapter artifacts on Google's Maven Repository. Select the latest version, download the Unity Ads adapter's .aar file, and add it to your project.

Step 4: Implement privacy settings on Unity Ads SDK

برای رعایت سیاست رضایت کاربر Google EU ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر ذخیره‌سازی‌های محلی در صورت لزوم قانونی، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات، دریافت کنید. این سیاست منعکس‌کننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از داده‌ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره میانجیگری خود هستید.

Unity Ads Android adapter version 4.19.0.1 and later supports passing GDPR consent signals from consent management platforms that integrate with IAB's Transparency and Consent Framework (TCF) to Unity Ads SDK. For more information, see Set up a TCF or non-TCF consent configuration .

US states privacy laws

قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف می‌کند) را می‌دهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه می‌شود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، امکان فعال کردن پردازش داده‌های محدود برای سرویس تبلیغات گوگل را ارائه می‌دهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطه‌گری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطه‌گری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنمایی‌های هر یک از این شبکه‌ها پیروی کنید.

In SDK version 2.0.0, Unity Ads added an API to support privacy settings. The following sample code shows how to pass this consent information to the Unity Ads SDK. Should you choose to pass consent information to the Unity Ads SDK manually, it is recommended that this code is called prior to requesting ads through Google Mobile Ads SDK (Legacy) .

جاوا 

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

کاتلین 

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()

See Unity Ads' Consumer privacy act compliance for more details and the values that can be provided in each method.

Set age treatment

Unity Ads mediation adapter version 4.16.6.0 and later forwards the child-directed setting and users under the age of consent setting to Unity Ads.

To process these signals on a per-user basis, Unity Ads requires you to enable the Mixed Audience designation in the Unity Monetization dashboard. For more information about enabling a mixed audience designation on your project, see Setting game-level age designations .

مرحله ۵: اضافه کردن کد مورد نیاز

Load ad with Activity context

Pass Activity context when loading Banner, Interstitial and Native ad formats. Without activity context, ad load will fail.

مرحله ۶: پیاده‌سازی خود را آزمایش کنید

Enable test ads

Make sure you register your test device for Ad Manager and enable test mode in Unity Ads UI.

تأیید تبلیغات آزمایشی

To verify that you are receiving test ads from Unity Ads, enable single ad source testing in ad inspector using the Unity Ads (Bidding) and Unity Ads (Waterfall) ad source(s).

کدهای خطا

If the adapter fails to receive an ad from Unity Ads, publishers can check the underlying error from the ad response using ResponseInfo.getAdapterResponses() under the following classes:

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

Here are the codes and accompanying messages thrown by the UnityAds adapter when an ad fails to load:

کد خطا دلیل
۰-۱۰ UnityAds SDK returned an error. See code for more details.
۱۰۱ UnityAds server parameters configured in the Ad Manager UI are missing/invalid.
۱۰۲ UnityAds returned a placement with a NO_FILL state.
۱۰۳ UnityAds returned a placement with a DISABLED state.
۱۰۴ UnityAds tried to show an ad with a null context.
۱۰۵ Context used to initialize, load and/or show ads from Unity Ads is not an Activity instance.
۱۰۶ UnityAds tried to show an ad that's not ready to be shown.
۱۰۷ UnityAds is not supported on the device.
۱۰۸ UnityAds can only load 1 ad per placement at a time.
۱۰۹ UnityAds finished with an ERROR state.
۱۱۰ The requested ad size does not match a UnityAds supported banner size.
۱۱۱ UnityAds returned an initialization error.
۱۱۲ Unity Ads returned a null or empty bidding token.
۲۰۰-۲۰۴ UnityAds Banner specific error. See code for more details.

Unity Ads Android Mediation Adapter Changelog

Version 4.20.1.0 (In progress)

Version 4.20.0.2 (In progress)

  • Pin the adapter's Kotlin dependency to 1.9.0 (the min Kotlin version supported by GMA NextGen SDK).

Version 4.20.0.1

  • Removed adapter requirement of an Activity context for loading banner ads.
  • Updated bidding signal collection to fail and report an error if an empty signal is received.

Built and tested with:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۴.۰ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • Unity Ads SDK version 4.20.0.

Version 4.20.0.0

  • Verified compatibility with Unity Ads SDK 4.20.0.

Built and tested with:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۳.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • Unity Ads SDK version 4.20.0.

Version 4.19.0.1

  • Adapter now automatically forwards GDPR consent found inside IABTCF_AddtlConsent to the Unity Ads SDK if GDPR applies.
  • Updated to report ad impression when Unity's interstitial ad is displayed.

Built and tested with:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۳.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • Unity Ads SDK version 4.19.0.

Version 4.19.0.0

  • Verified compatibility with Unity Ads SDK 4.19.0.

Built and tested with:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۲.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.19.0.

Version 4.18.1.0

  • Removed old API implementation for interstitial ads. Adapter will start using the new API implementation.
  • Verified compatibility with Unity Ads SDK 4.18.1.

Built and tested with:

  • Google Mobile Ads SDK version 25.3.0.
  • نسخه ۱.۲.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.18.1.

Version 4.18.0.0

  • ویژگی برای ساخت آداپتور با وابستگی به GMA Next-Gen SDK اضافه شد.
  • Verified compatibility with Unity Ads SDK 4.18.0.

Built and tested with:

  • Google Mobile Ads SDK version 25.2.0.
  • Google Mobile Ads Next-Gen SDK version 1.0.1.
  • Unity Ads SDK version 4.18.0.

Version 4.17.0.0

  • Verified compatibility with Unity Ads SDK 4.17.0.

Built and tested with:

  • نسخه ۲۵.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.17.0.

Version 4.16.6.0

  • Added support for forwarding the tagForUnderAgeOfConsent Google Mobile Ads SDK parameter to the Unity Ads SDK.
  • Verified compatibility with Unity Ads SDK 4.16.6.

Built and tested with:

  • Google Mobile Ads SDK version 24.9.0.
  • Unity Ads SDK version 4.16.6.

Version 4.16.5.0

  • Verified compatibility with Unity Ads SDK 4.16.5.

Built and tested with:

  • Google Mobile Ads SDK version 24.8.0.
  • Unity Ads SDK version 4.16.5.

Version 4.16.4.0

  • Verified compatibility with Unity Ads SDK 4.16.4.

Built and tested with:

  • نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.16.4.

Version 4.16.3.0

  • Verified compatibility with Unity Ads SDK 4.16.3.

Built and tested with:

  • نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.16.3.

Version 4.16.2.0

  • Added format parameter when getting signal token from Unity Ads SDK.
  • Removed old banner API implementation. Note: New banner API implementation already exists in the adapter and GMA SDK will use that.
  • Added an error code to identify show failure due to timeout.
  • ارجاعات سطح کلاس به اشیاء Context حذف شد تا به مشکلات نشت حافظه کمک کند.
  • Verified compatibility with Unity Ads SDK 4.16.2.

Built and tested with:

  • Google Mobile Ads SDK version 24.6.0.
  • Unity Ads SDK version 4.16.2.

Version 4.16.1.0

  • Verified compatibility with Unity Ads SDK 4.16.1.

ساخته و آزمایش شده با:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.16.1.

Version 4.16.0.1

  • بررسی اندازه از آداپتور برای تبلیغات بنری RTB حذف شد.

Built and tested with:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.16.0.

Version 4.16.0.0

  • Verified compatibility with Unity Ads SDK 4.16.0.

Built and tested with:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.16.0.

Version 4.15.1.0

  • Verified compatibility with Unity Ads SDK 4.15.1.

Built and tested with:

  • نسخه ۲۴.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.15.1.

Version 4.15.0.0

  • Updated to fail signal collection for RTB banner ads if the context is not an activity (since Unity Ads SDK requires activity context to load RTB banner ads). This fix will increase ad load success rate for publishers.
  • Verified compatibility with Unity Ads SDK 4.15.0.

Built and tested with:

  • نسخه ۲۴.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.15.0.

Version 4.14.2.0

  • Verified compatibility with Unity Ads SDK 4.14.2.

Built and tested with:

  • نسخه ۲۴.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.14.2.

Version 4.14.1.0

  • Verified compatibility with Unity Ads SDK 4.14.1.

Built and tested with:

  • نسخه ۲۴.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.14.1.

Version 4.14.0.0

  • Verified compatibility with Unity Ads SDK 4.14.0.

Built and tested with:

  • نسخه ۲۴.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.14.0.

Version 4.13.2.0

  • حداقل سطح API اندروید مورد نیاز به ۲۳ ارتقا یافت.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۴.۰.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۴.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.13.2.

Version 4.13.1.0

  • Verified compatibility with Unity Ads SDK 4.13.1.

Built and tested with:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.13.1.

Version 4.13.0.0

  • Removed unnecessary Activity context checks from the adapter.
  • Verified compatibility with Unity Ads SDK 4.13.0.

Built and tested with:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.13.0.

Version 4.12.5.1

  • Fixed bidding banner ad load failures by setting the object ID when loading ads.

Built and tested with:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.5.

Version 4.12.5.0

  • Verified compatibility with Unity Ads SDK 4.12.5.

ساخته و آزمایش شده با:

  • Google Mobile Ads SDK version 23.5.0.
  • Unity Ads SDK version 4.12.5.

Version 4.12.4.0

  • Verified compatibility with Unity Ads SDK 4.12.4.

Built and tested with:

  • نسخه ۲۳.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.4.

Version 4.12.3.0

  • Verified compatibility with Unity Ads SDK 4.12.3.

Built and tested with:

  • نسخه ۲۳.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.3.

Version 4.12.2.0

  • Verified compatibility with Unity Ads SDK 4.12.2.

Built and tested with:

  • نسخه ۲۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.2.

Version 4.12.1.0

  • Verified compatibility with Unity Ads SDK 4.12.1.

Built and tested with:

  • نسخه ۲۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.1.

Version 4.12.0.0

  • Verified compatibility with Unity Ads SDK 4.12.0.

Built and tested with:

  • نسخه ۲۳.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.0.

Version 4.11.3.0

  • Added bidding support for banner, interstitial and rewarded ad formats.
  • Verified compatibility with Unity Ads SDK 4.11.3.

Built and tested with:

  • نسخه ۲۳.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.11.3.

Version 4.11.2.0

  • Verified compatibility with Unity Ads SDK 4.11.2.

Built and tested with:

  • نسخه ۲۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.11.2.

Version 4.10.0.0

  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۳.۰.۰ به‌روزرسانی شد.
  • Verified compatibility with Unity Ads SDK 4.10.0.

Built and tested with:

  • نسخه ۲۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.10.0.

Version 4.9.3.0

  • Verified compatibility with Unity Ads SDK 4.9.3.

Built and tested with:

  • نسخه ۲۲.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.9.3.

Version 4.9.2.0

  • Verified compatibility with Unity Ads SDK 4.9.2.

Built and tested with:

  • نسخه ۲۲.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.9.2.

Version 4.9.1.0

  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۳.۰ به‌روزرسانی شد.
  • Verified compatibility with Unity Ads SDK 4.9.1.

Built and tested with:

  • نسخه ۲۲.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.9.1.

Version 4.8.0.0

  • Reports ad impression when Unity Ads SDK invokes its new onBannerShown() callback method.
  • Verified compatibility with Unity Ads SDK 4.8.0.

Built and tested with:

  • نسخه ۲۲.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.8.0.

Version 4.7.1.0

  • Verified compatibility with Unity Ads SDK 4.7.1.

Built and tested with:

  • نسخه ۲۲.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.7.1.

نسخه ۴.۷.۰.۰

  • Verified compatibility with Unity Ads SDK 4.7.0.

Built and tested with:

  • نسخه ۲۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.7.0.

نسخه ۴.۶.۱.۱

  • آداپتور برای استفاده از کلاس VersionInfo جدید به‌روزرسانی شد.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۰.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.6.1.

نسخه ۴.۶.۱.۰

  • Verified compatibility with Unity Ads SDK 4.6.1.

Built and tested with:

  • Google Mobile Ads SDK version 21.5.0
  • Unity Ads SDK version 4.6.1.

نسخه ۴.۶.۰.۰

  • Added support for forwarding COPPA information to the Unity Ads SDK.
  • Verified compatibility with Unity Ads SDK 4.6.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۵.۰ به‌روزرسانی شد.

Built and tested with:

  • Google Mobile Ads SDK version 21.5.0
  • Unity Ads SDK version 4.6.0.

نسخه ۴.۵.۰.۰

  • Verified compatibility with Unity Ads SDK 4.5.0.
  • Updated the minimum required Google Mobile Ads SDK version to 21.4.0.

Built and tested with:

  • Google Mobile Ads SDK version 21.4.0
  • Unity Ads SDK version 4.5.0.

نسخه ۴.۴.۱.۰

  • Verified compatibility with Unity Ads SDK 4.4.1.

ساخته و آزمایش شده با:

  • Google Mobile Ads SDK version 21.2.0
  • Unity Ads SDK version 4.4.1.

نسخه ۴.۴.۰.۰

  • Verified compatibility with Unity Ads SDK 4.4.0.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۲۱.۲.۰ به‌روزرسانی شد.

Built and tested with:

  • Google Mobile Ads SDK version 21.2.0
  • Unity Ads SDK version 4.4.0.

Version 4.3.0.0

  • Verified compatibility with Unity Ads SDK 4.3.0.
  • The onAdOpened() callback is now forwarded when interstitial and rewarded ads start playing.

Built and tested with:

  • Google Mobile Ads SDK version 21.1.0
  • Unity Ads SDK version 4.3.0.

Version 4.2.1.1

  • compileSdkVersion و targetSdkVersion به API 31 به‌روزرسانی شدند.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۰.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۱.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.2.1.

Version 4.2.1.0

  • Verified compatibility with Unity Ads SDK 4.2.1.

Built and tested with:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.2.1.

Version 4.1.0.0

  • Verified compatibility with Unity Ads SDK 4.1.0.

Built and tested with:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.1.0.

Version 4.0.1.0

  • Verified compatibility with Unity Ads SDK 4.0.1.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.6.0 به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.0.1.

Version 4.0.0.0

  • Verified compatibility with Unity Ads SDK 4.0.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به 20.5.0 به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۰.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.0.0.

Version 3.7.5.0

  • Verified compatibility with Unity Ads SDK 3.7.5.

Built and tested with:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.5.

Version 3.7.4.0

  • Verified compatibility with Unity Ads SDK 3.7.4.

Built and tested with:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.4.

Version 3.7.2.0

  • Verified compatibility with Unity Ads SDK 3.7.2.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.2.0 به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.2.

Version 3.7.1.0

  • Verified compatibility with Unity Ads SDK 3.7.1.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.1.0 به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۰.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.1.

Version 3.6.2.0

  • Verified compatibility with Unity Ads SDK 3.6.2.
  • Fixed an issue where rewarded ads were not forwarding click callbacks.
  • The UnityAds SDK has been removed from the bundled adapter build. Publishers are now required to manually include the UnityAds SDK as an additional dependency.
  • Updated the minimum required Google Mobile Ads SDK version to 19.8.0.

Built and tested with:

  • Google Mobile Ads SDK version 19.8.0.
  • Unity Ads SDK version 3.6.2.

Version 3.6.0.0

  • Verified compatibility with Unity Ads SDK 3.6.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۹.۶.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۹.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.6.0.

Version 3.5.1.1

  • Fixed an issue where when trying to request for multiple interstitial and rewarded ads.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.5.1.

Version 3.5.1.0

  • Verified compatibility with Unity Ads SDK 3.5.1.
  • Fixed an issue that causes smart banner ad requests to fail.

Built and tested with:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.5.1.

Version 3.5.0.0

  • Verified compatibility with Unity Ads SDK 3.5.0.
  • Added adaptive banner support.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۵.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.5.0.

Version 3.4.8.0

  • Fixed a NullPointerException error that occurs when a banner ad is destroyed.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۳.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۹.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.8.

Version 3.4.6.1

  • Created an adapter build that does not include the Unity Ads SDK bundled in. This gives publishers an option to use the Unity Ads Services when mediating on Unity to avoid conflicting dependency issues.
    • Publishers may opt to use this by including the com.google.ads.mediation:unity-adapter-only:xyzp dependency on their app-level build.gradle file.

Built and tested with:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.6.

Version 3.4.6.0

  • Verified compatibility with Unity Ads SDK 3.4.6.
  • Adapter now forwards the onAdOpened() callback when a banner ad is clicked.

Built and tested with:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.6.

Version 3.4.2.3

  • کدهای خطای توصیفی و دلایل خرابی‌های بارگذاری/نمایش آداپتور اضافه شد.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۱.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.2.2

  • Fixed a ConcurrentModificationException crash that occurred when Unity Ads returns an error.

Built and tested with:

  • نسخه ۱۹.۰.۱ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.2.1

  • Improved forwarding of Unity's errors to recognize initialization and ad load failures earlier and reduce timeouts.
  • Updated the minimum required Google Mobile Ads SDK version to 19.0.1.

Built and tested with:

  • نسخه ۱۹.۰.۱ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.2.0

  • Verified compatibility with Unity Ads SDK 3.4.2.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۳.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۸.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.0.0

  • Verified compatibility with Unity Ads SDK 3.4.0.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۳.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۸.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.0.

Version 3.3.0.0

  • Verified compatibility with Unity Ads SDK 3.3.0.

Built and tested with:

  • نسخه ۱۸.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.3.0.

Version 3.2.0.1

  • Fixed a null pointer exception crash that occurred when calling loadAd() before calling UnityAds.initialize() .
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۲.۰ به‌روزرسانی شد.

Version 3.2.0.0

  • Fixed an issue that caused Banner Ad requests to fail.
  • Verified compatibility with Unity Ads SDK 3.2.0.
  • Migrated the adapter to AndroidX.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۸.۱.۱ به‌روزرسانی شد.

Version 3.1.0.0

  • پشتیبانی از اندازه‌های انعطاف‌پذیر بنرهای تبلیغاتی اضافه شد.
  • Adapter fails the ad request if the requested size isn't compatible with any Unity Ads banner sizes
  • Verified compatibility with Unity Ads SDK 3.1.0.

Version 3.0.1.0

  • Verified compatibility with Unity Ads SDK 3.0.1.
  • Fixed a bug that caused 'NPE' while showing an interstitial ad.

Version 3.0.0.2

  • Updated adapter to support new open-beta Rewarded API.
  • Updated the minimum required Google Mobile Ads SDK version to 17.2.0.

نسخه ۳.۰.۰.۱

  • Added support for Unity Ads Banner.

Version 3.0.0.0

  • Verified compatibility with Unity Ads SDK 3.0.0.

Version 2.3.0.0

  • Verified compatibility with Unity Ads SDK 2.3.0.

Version 2.2.1.1

  • Updated the adapter to invoke the onRewardedVideoComplete() ad event.

Version 2.2.1.0

  • Verified compatibility with Unity Ads SDK 2.2.1.

Version 2.2.0.0

  • Verified compatibility with Unity Ads SDK 2.2.0.

Version 2.1.2.0

  • Verified compatibility with Unity Ads SDK 2.1.2.

Version 2.1.1.0

  • Verified compatibility with Unity Ads SDK 2.1.1.

Version 2.1.0.0

  • Updated the adapter to make it compatible with Unity Ads SDK 2.1.0.

Version 2.0.8.0

  • Verified compatibility with Unity Ads SDK 2.0.8.

Version 2.0.7.0

  • Using Unity Ads's click reporting (AdMob and Unity Ads click statistics will match up).
  • Added onAdLeftApplication callback support.

Version 2.0.6.0

  • Verified compatibility with Unity Ads SDK 2.0.6.

Version 2.0.5.0

  • The adapters can now be added as a compile dependency by adding the following to the build.gradle file's dependencies tag: compile 'com.google.ads.mediation:unity:2.0.5.0'
  • Moved to distributing the adapter as an aar instead of a jar file (see README for additional instructions).

Version 2.0.4.0

  • Fixed a bug that caused rewarded video ads to fail to load when an interstitial ad was loaded first.

Version 2.0.2.0

  • Changed the version naming system to [Unity Ads SDK version].[adapter patch version].
  • Updated the minimum required Unity Ads SDK to v2.0.2.
  • Updated the minimum required Google Mobile Ads SDK to v9.0.0.
  • Apps are no longer required to call UnityAds.changeActivity(this).

نسخه ۱.۰.۰

  • Initial release. Supports reward-based video ads and interstitial ads.
،
پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر ، اندروید (قدیمی)

This guide shows you how to use Google Mobile Ads SDK (Legacy) to load and display ads from Unity Ads using mediation , covering bidding and waterfall integrations. It covers how to add Unity Ads to an ad unit's mediation configuration, and how to integrate the Unity Ads SDK and adapter into an Android app.

ادغام‌ها و قالب‌های تبلیغاتی پشتیبانی‌شده

The mediation adapter for Unity Ads has the following capabilities:

ادغام
مناقصه
آبشار 1
قالب‌ها
بنر
بینابینی
پاداش داده شده
بومی

پیش‌نیازها

قبل از ادامه، موارد زیر را بررسی کنید:

  • Android API level 24 or later.
  • [For bidding]: To integrate all supported ad formats in bidding, use Unity adapter 4.16.0.1 or later ( latest version recommended ).

Step 1: Set up configurations in Unity Ads UI

Sign up or log in to Unity Ads.

ایجاد یک پروژه

On the Unity Ads dashboard , navigate to Projects and click New .

Fill out the form and click Create to add your project.

Navigate to Unity Ads Monetization , then click Get started .

In the New Project modal, select I will use Mediation and Google Admob for Mediation Partner , then click Next .

Select the option for ad settings, then click Next .

Select your placement setup, then click Next .

مناقصه

آبشار

Fill out the form, then click Add project .

Take note of the Game ID .

Create ad units and placements

Navigate to Unity Ads Monetization > Placements , then select your project and click Add ad unit .

Enter an Ad unit name , then select your Platform and Ad format .

Navigate to Monetization > Placements , then click Add Ad Unit .

Enter an Ad Unit Name , then select your Platform and Ad Format .

Select Waterfall for the Setup . Under Placement , enter the Placement name , GEO Tagging and Target .

Take note of the Placement ID .

Finally, click Add ad unit to save your ad unit and placement.

Locate Unity Ads Reporting API key

مناقصه

این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.

آبشار

Navigate to the Unity Ads Monetization > API management and take note of the API Key in Monetization Stats API Access .

Then, navigate to the Unity Ads Monetization > Organization Settings and take note of the Organization core ID .

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .

To implement app-ads.txt for Unity Ads, see setting up app-ads.txt for the first time .

حالت تست را روشن کنید

Test mode can be enabled from the Unity Ads dashboard . Navigate to Unity Ads Monetization > Testing .

You can force test mode for your app by clicking the edit button beside Google Play Store , enabling Override client test mode and selecting Force test mode ON (ie use test ads) for all devices .

Alternatively, you can enable test mode for specific devices by clicking Add Test Device .

Enter your test device details, then click Save .

Step 2: Set up Unity Ads demand in Ad Manager UI

وارد حساب مدیر تبلیغات خود شوید.

Add Unity Ads in Companies

مناقصه

این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.

آبشار

به بخش مدیریت > شرکت‌ها بروید، سپس در تب «همه شرکت‌ها» روی دکمه «شرکت جدید» کلیک کنید. شبکه تبلیغاتی را انتخاب کنید.

Select Unity Ads as the Ad network , enter a unique Name and enable Mediation . Turn on Automatic data collection , and enter the API Key and Organization core ID obtained in the previous section.

نیازی به وارد کردن نام کاربری یا رمز عبور نیست. پس از اتمام، روی ذخیره کلیک کنید.

فعال کردن اشتراک‌گذاری امن سیگنال

مناقصه

به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید

مناقصه

Navigate to Inventory > Secure Signals . Under Secure signals , search for Unity Ads and turn on Enable app integration .

روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

Allow secure signal sharing for SDK Bidding

مناقصه

به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیش‌فرض ، گزینه «اجازه اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.

روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

Configure Unity Ads bidding

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

روی پیشنهاددهنده جدید کلیک کنید.

Select Unity Ads as the bidder.

برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.

Click Done .

آبشار

این مرحله برای ادغام‌های آبشاری لازم نیست.

پیکربندی نگاشت واحد تبلیغات

مناقصه

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

Select the company for Unity Ads.

به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.

Choose Specific ad unit . Select an ad unit and format, Mobile app as the Inventory type , and your Mobile application . Then, enter Game ID and Placement ID obtained in the previous section.

در نهایت، روی ذخیره کلیک کنید.

آبشار

به بخش تحویل > گروه‌های بازده بروید و روی دکمه‌ی گروه بازده جدید کلیک کنید. موجودی و برنامه‌ی خود را انتخاب کنید.

به Yield partners بروید و روی Add Mediation partner کلیک کنید.

Select the company you created for Unity Ads in the previous section. Choose Mobile SDK mediation as the Integration type , Android as the Platform , and Active as the Status .

Enter the Game ID and Placement ID obtained in the previous section, and the Default CPM value. Click Save .

Add Unity Ads to GDPR and US state regulations ad partners list

Follow the steps in European regulations settings and US state regulations settings to add Unity Ads to the European and US state regulations ad partners list in the Ad Manager UI.

Step 3: Import the Unity Ads SDK and adapter

In your app-level gradle file, add the following implementation dependencies:

کاتلین 

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.unity3d.ads:unity-ads:4.20.0")
    implementation("com.google.ads.mediation:unity:4.20.0.1")
}

گرووی 

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.unity3d.ads:unity-ads:4.20.0'
    implementation 'com.google.ads.mediation:unity:4.20.0.1'
}

ادغام دستی

  1. Download the latest Unity Ads SDK ( unity-ads.aar ) from their GitHub repository and add it to your project.

  2. Navigate to the Unity Ads adapter artifacts on Google's Maven Repository. Select the latest version, download the Unity Ads adapter's .aar file, and add it to your project.

Step 4: Implement privacy settings on Unity Ads SDK

برای رعایت سیاست رضایت کاربر Google EU ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر ذخیره‌سازی‌های محلی در صورت لزوم قانونی، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات، دریافت کنید. این سیاست منعکس‌کننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از داده‌ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره میانجیگری خود هستید.

Unity Ads Android adapter version 4.19.0.1 and later supports passing GDPR consent signals from consent management platforms that integrate with IAB's Transparency and Consent Framework (TCF) to Unity Ads SDK. For more information, see Set up a TCF or non-TCF consent configuration .

US states privacy laws

قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف می‌کند) را می‌دهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه می‌شود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، امکان فعال کردن پردازش داده‌های محدود برای سرویس تبلیغات گوگل را ارائه می‌دهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطه‌گری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطه‌گری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنمایی‌های هر یک از این شبکه‌ها پیروی کنید.

In SDK version 2.0.0, Unity Ads added an API to support privacy settings. The following sample code shows how to pass this consent information to the Unity Ads SDK. Should you choose to pass consent information to the Unity Ads SDK manually, it is recommended that this code is called prior to requesting ads through Google Mobile Ads SDK (Legacy) .

جاوا 

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

کاتلین 

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()

See Unity Ads' Consumer privacy act compliance for more details and the values that can be provided in each method.

Set age treatment

Unity Ads mediation adapter version 4.16.6.0 and later forwards the child-directed setting and users under the age of consent setting to Unity Ads.

To process these signals on a per-user basis, Unity Ads requires you to enable the Mixed Audience designation in the Unity Monetization dashboard. For more information about enabling a mixed audience designation on your project, see Setting game-level age designations .

مرحله ۵: اضافه کردن کد مورد نیاز

Load ad with Activity context

Pass Activity context when loading Banner, Interstitial and Native ad formats. Without activity context, ad load will fail.

مرحله ۶: پیاده‌سازی خود را آزمایش کنید

Enable test ads

Make sure you register your test device for Ad Manager and enable test mode in Unity Ads UI.

تأیید تبلیغات آزمایشی

To verify that you are receiving test ads from Unity Ads, enable single ad source testing in ad inspector using the Unity Ads (Bidding) and Unity Ads (Waterfall) ad source(s).

کدهای خطا

If the adapter fails to receive an ad from Unity Ads, publishers can check the underlying error from the ad response using ResponseInfo.getAdapterResponses() under the following classes:

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

Here are the codes and accompanying messages thrown by the UnityAds adapter when an ad fails to load:

کد خطا دلیل
۰-۱۰ UnityAds SDK returned an error. See code for more details.
۱۰۱ UnityAds server parameters configured in the Ad Manager UI are missing/invalid.
۱۰۲ UnityAds returned a placement with a NO_FILL state.
۱۰۳ UnityAds returned a placement with a DISABLED state.
۱۰۴ UnityAds tried to show an ad with a null context.
۱۰۵ Context used to initialize, load and/or show ads from Unity Ads is not an Activity instance.
۱۰۶ UnityAds tried to show an ad that's not ready to be shown.
۱۰۷ UnityAds is not supported on the device.
۱۰۸ UnityAds can only load 1 ad per placement at a time.
۱۰۹ UnityAds finished with an ERROR state.
۱۱۰ The requested ad size does not match a UnityAds supported banner size.
۱۱۱ UnityAds returned an initialization error.
۱۱۲ Unity Ads returned a null or empty bidding token.
۲۰۰-۲۰۴ UnityAds Banner specific error. See code for more details.

Unity Ads Android Mediation Adapter Changelog

Version 4.20.1.0 (In progress)

Version 4.20.0.2 (In progress)

  • Pin the adapter's Kotlin dependency to 1.9.0 (the min Kotlin version supported by GMA NextGen SDK).

Version 4.20.0.1

  • Removed adapter requirement of an Activity context for loading banner ads.
  • Updated bidding signal collection to fail and report an error if an empty signal is received.

Built and tested with:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۴.۰ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • Unity Ads SDK version 4.20.0.

Version 4.20.0.0

  • Verified compatibility with Unity Ads SDK 4.20.0.

Built and tested with:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۳.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • Unity Ads SDK version 4.20.0.

Version 4.19.0.1

  • Adapter now automatically forwards GDPR consent found inside IABTCF_AddtlConsent to the Unity Ads SDK if GDPR applies.
  • Updated to report ad impression when Unity's interstitial ad is displayed.

Built and tested with:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۳.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایل گوگل.
  • Unity Ads SDK version 4.19.0.

Version 4.19.0.0

  • Verified compatibility with Unity Ads SDK 4.19.0.

Built and tested with:

  • نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • نسخه ۱.۲.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.19.0.

Version 4.18.1.0

  • Removed old API implementation for interstitial ads. Adapter will start using the new API implementation.
  • Verified compatibility with Unity Ads SDK 4.18.1.

Built and tested with:

  • Google Mobile Ads SDK version 25.3.0.
  • نسخه ۱.۲.۱ کیت توسعه نرم‌افزاری نسل بعدی تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.18.1.

Version 4.18.0.0

  • ویژگی برای ساخت آداپتور با وابستگی به GMA Next-Gen SDK اضافه شد.
  • Verified compatibility with Unity Ads SDK 4.18.0.

Built and tested with:

  • Google Mobile Ads SDK version 25.2.0.
  • Google Mobile Ads Next-Gen SDK version 1.0.1.
  • Unity Ads SDK version 4.18.0.

Version 4.17.0.0

  • Verified compatibility with Unity Ads SDK 4.17.0.

Built and tested with:

  • نسخه ۲۵.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.17.0.

Version 4.16.6.0

  • Added support for forwarding the tagForUnderAgeOfConsent Google Mobile Ads SDK parameter to the Unity Ads SDK.
  • Verified compatibility with Unity Ads SDK 4.16.6.

Built and tested with:

  • Google Mobile Ads SDK version 24.9.0.
  • Unity Ads SDK version 4.16.6.

Version 4.16.5.0

  • Verified compatibility with Unity Ads SDK 4.16.5.

ساخته و آزمایش شده با:

  • Google Mobile Ads SDK version 24.8.0.
  • Unity Ads SDK version 4.16.5.

Version 4.16.4.0

  • Verified compatibility with Unity Ads SDK 4.16.4.

Built and tested with:

  • نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.16.4.

Version 4.16.3.0

  • Verified compatibility with Unity Ads SDK 4.16.3.

Built and tested with:

  • نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.16.3.

Version 4.16.2.0

  • Added format parameter when getting signal token from Unity Ads SDK.
  • Removed old banner API implementation. Note: New banner API implementation already exists in the adapter and GMA SDK will use that.
  • Added an error code to identify show failure due to timeout.
  • ارجاعات سطح کلاس به اشیاء Context حذف شد تا به مشکلات نشت حافظه کمک کند.
  • Verified compatibility with Unity Ads SDK 4.16.2.

Built and tested with:

  • Google Mobile Ads SDK version 24.6.0.
  • Unity Ads SDK version 4.16.2.

Version 4.16.1.0

  • Verified compatibility with Unity Ads SDK 4.16.1.

Built and tested with:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.16.1.

Version 4.16.0.1

  • بررسی اندازه از آداپتور برای تبلیغات بنری RTB حذف شد.

Built and tested with:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.16.0.

Version 4.16.0.0

  • Verified compatibility with Unity Ads SDK 4.16.0.

Built and tested with:

  • نسخه ۲۴.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.16.0.

Version 4.15.1.0

  • Verified compatibility with Unity Ads SDK 4.15.1.

Built and tested with:

  • نسخه ۲۴.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.15.1.

Version 4.15.0.0

  • Updated to fail signal collection for RTB banner ads if the context is not an activity (since Unity Ads SDK requires activity context to load RTB banner ads). This fix will increase ad load success rate for publishers.
  • Verified compatibility with Unity Ads SDK 4.15.0.

Built and tested with:

  • نسخه ۲۴.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.15.0.

Version 4.14.2.0

  • Verified compatibility with Unity Ads SDK 4.14.2.

Built and tested with:

  • نسخه ۲۴.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.14.2.

Version 4.14.1.0

  • Verified compatibility with Unity Ads SDK 4.14.1.

Built and tested with:

  • نسخه ۲۴.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.14.1.

Version 4.14.0.0

  • Verified compatibility with Unity Ads SDK 4.14.0.

Built and tested with:

  • نسخه ۲۴.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.14.0.

Version 4.13.2.0

  • حداقل سطح API اندروید مورد نیاز به ۲۳ ارتقا یافت.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۴.۰.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۴.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.13.2.

Version 4.13.1.0

  • Verified compatibility with Unity Ads SDK 4.13.1.

Built and tested with:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.13.1.

Version 4.13.0.0

  • Removed unnecessary Activity context checks from the adapter.
  • Verified compatibility with Unity Ads SDK 4.13.0.

Built and tested with:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.13.0.

Version 4.12.5.1

  • Fixed bidding banner ad load failures by setting the object ID when loading ads.

Built and tested with:

  • نسخه ۲۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.5.

Version 4.12.5.0

  • Verified compatibility with Unity Ads SDK 4.12.5.

Built and tested with:

  • Google Mobile Ads SDK version 23.5.0.
  • Unity Ads SDK version 4.12.5.

Version 4.12.4.0

  • Verified compatibility with Unity Ads SDK 4.12.4.

Built and tested with:

  • نسخه ۲۳.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.4.

Version 4.12.3.0

  • Verified compatibility with Unity Ads SDK 4.12.3.

Built and tested with:

  • نسخه ۲۳.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.3.

Version 4.12.2.0

  • Verified compatibility with Unity Ads SDK 4.12.2.

Built and tested with:

  • نسخه ۲۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.2.

Version 4.12.1.0

  • Verified compatibility with Unity Ads SDK 4.12.1.

Built and tested with:

  • نسخه ۲۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.1.

Version 4.12.0.0

  • Verified compatibility with Unity Ads SDK 4.12.0.

Built and tested with:

  • نسخه ۲۳.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.12.0.

Version 4.11.3.0

  • Added bidding support for banner, interstitial and rewarded ad formats.
  • Verified compatibility with Unity Ads SDK 4.11.3.

ساخته و آزمایش شده با:

  • نسخه ۲۳.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.11.3.

Version 4.11.2.0

  • Verified compatibility with Unity Ads SDK 4.11.2.

Built and tested with:

  • نسخه ۲۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.11.2.

Version 4.10.0.0

  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۳.۰.۰ به‌روزرسانی شد.
  • Verified compatibility with Unity Ads SDK 4.10.0.

Built and tested with:

  • نسخه ۲۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.10.0.

Version 4.9.3.0

  • Verified compatibility with Unity Ads SDK 4.9.3.

Built and tested with:

  • نسخه ۲۲.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.9.3.

Version 4.9.2.0

  • Verified compatibility with Unity Ads SDK 4.9.2.

Built and tested with:

  • نسخه ۲۲.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.9.2.

Version 4.9.1.0

  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۳.۰ به‌روزرسانی شد.
  • Verified compatibility with Unity Ads SDK 4.9.1.

Built and tested with:

  • نسخه ۲۲.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.9.1.

Version 4.8.0.0

  • Reports ad impression when Unity Ads SDK invokes its new onBannerShown() callback method.
  • Verified compatibility with Unity Ads SDK 4.8.0.

Built and tested with:

  • نسخه ۲۲.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.8.0.

Version 4.7.1.0

  • Verified compatibility with Unity Ads SDK 4.7.1.

Built and tested with:

  • نسخه ۲۲.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.7.1.

نسخه ۴.۷.۰.۰

  • Verified compatibility with Unity Ads SDK 4.7.0.

Built and tested with:

  • نسخه ۲۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.7.0.

نسخه ۴.۶.۱.۱

  • آداپتور برای استفاده از کلاس VersionInfo جدید به‌روزرسانی شد.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۰.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۲.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.6.1.

نسخه ۴.۶.۱.۰

  • Verified compatibility with Unity Ads SDK 4.6.1.

Built and tested with:

  • Google Mobile Ads SDK version 21.5.0
  • Unity Ads SDK version 4.6.1.

نسخه ۴.۶.۰.۰

  • Added support for forwarding COPPA information to the Unity Ads SDK.
  • Verified compatibility with Unity Ads SDK 4.6.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۵.۰ به‌روزرسانی شد.

Built and tested with:

  • Google Mobile Ads SDK version 21.5.0
  • Unity Ads SDK version 4.6.0.

نسخه ۴.۵.۰.۰

  • Verified compatibility with Unity Ads SDK 4.5.0.
  • Updated the minimum required Google Mobile Ads SDK version to 21.4.0.

ساخته و آزمایش شده با:

  • Google Mobile Ads SDK version 21.4.0
  • Unity Ads SDK version 4.5.0.

نسخه ۴.۴.۱.۰

  • Verified compatibility with Unity Ads SDK 4.4.1.

Built and tested with:

  • Google Mobile Ads SDK version 21.2.0
  • Unity Ads SDK version 4.4.1.

نسخه ۴.۴.۰.۰

  • Verified compatibility with Unity Ads SDK 4.4.0.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۲۱.۲.۰ به‌روزرسانی شد.

Built and tested with:

  • Google Mobile Ads SDK version 21.2.0
  • Unity Ads SDK version 4.4.0.

Version 4.3.0.0

  • Verified compatibility with Unity Ads SDK 4.3.0.
  • The onAdOpened() callback is now forwarded when interstitial and rewarded ads start playing.

Built and tested with:

  • Google Mobile Ads SDK version 21.1.0
  • Unity Ads SDK version 4.3.0.

Version 4.2.1.1

  • compileSdkVersion و targetSdkVersion به API 31 به‌روزرسانی شدند.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۱.۰.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۱.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.2.1.

Version 4.2.1.0

  • Verified compatibility with Unity Ads SDK 4.2.1.

Built and tested with:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.2.1.

Version 4.1.0.0

  • Verified compatibility with Unity Ads SDK 4.1.0.

Built and tested with:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.1.0.

Version 4.0.1.0

  • Verified compatibility with Unity Ads SDK 4.0.1.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.6.0 به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۰.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.0.1.

Version 4.0.0.0

  • Verified compatibility with Unity Ads SDK 4.0.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به 20.5.0 به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۰.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 4.0.0.

Version 3.7.5.0

  • Verified compatibility with Unity Ads SDK 3.7.5.

Built and tested with:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.5.

Version 3.7.4.0

  • Verified compatibility with Unity Ads SDK 3.7.4.

Built and tested with:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.4.

Version 3.7.2.0

  • Verified compatibility with Unity Ads SDK 3.7.2.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.2.0 به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۰.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.2.

Version 3.7.1.0

  • Verified compatibility with Unity Ads SDK 3.7.1.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به 20.1.0 به‌روزرسانی شد.

Built and tested with:

  • نسخه ۲۰.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.7.1.

Version 3.6.2.0

  • Verified compatibility with Unity Ads SDK 3.6.2.
  • Fixed an issue where rewarded ads were not forwarding click callbacks.
  • The UnityAds SDK has been removed from the bundled adapter build. Publishers are now required to manually include the UnityAds SDK as an additional dependency.
  • Updated the minimum required Google Mobile Ads SDK version to 19.8.0.

Built and tested with:

  • Google Mobile Ads SDK version 19.8.0.
  • Unity Ads SDK version 3.6.2.

Version 3.6.0.0

  • Verified compatibility with Unity Ads SDK 3.6.0.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۹.۶.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۹.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.6.0.

Version 3.5.1.1

  • Fixed an issue where when trying to request for multiple interstitial and rewarded ads.

Built and tested with:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.5.1.

Version 3.5.1.0

  • Verified compatibility with Unity Ads SDK 3.5.1.
  • Fixed an issue that causes smart banner ad requests to fail.

Built and tested with:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.5.1.

Version 3.5.0.0

  • Verified compatibility with Unity Ads SDK 3.5.0.
  • Added adaptive banner support.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۵.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۹.۵.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.5.0.

Version 3.4.8.0

  • Fixed a NullPointerException error that occurs when a banner ad is destroyed.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۳.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۹.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.8.

Version 3.4.6.1

  • Created an adapter build that does not include the Unity Ads SDK bundled in. This gives publishers an option to use the Unity Ads Services when mediating on Unity to avoid conflicting dependency issues.
    • Publishers may opt to use this by including the com.google.ads.mediation:unity-adapter-only:xyzp dependency on their app-level build.gradle file.

Built and tested with:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.6.

Version 3.4.6.0

  • Verified compatibility with Unity Ads SDK 3.4.6.
  • Adapter now forwards the onAdOpened() callback when a banner ad is clicked.

Built and tested with:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.6.

Version 3.4.2.3

  • کدهای خطای توصیفی و دلایل خرابی‌های بارگذاری/نمایش آداپتور اضافه شد.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۹.۱.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

  • نسخه ۱۹.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.2.2

  • Fixed a ConcurrentModificationException crash that occurred when Unity Ads returns an error.

Built and tested with:

  • نسخه ۱۹.۰.۱ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.2.1

  • Improved forwarding of Unity's errors to recognize initialization and ad load failures earlier and reduce timeouts.
  • Updated the minimum required Google Mobile Ads SDK version to 19.0.1.

Built and tested with:

  • نسخه ۱۹.۰.۱ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.2.0

  • Verified compatibility with Unity Ads SDK 3.4.2.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۳.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۸.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.2.

Version 3.4.0.0

  • Verified compatibility with Unity Ads SDK 3.4.0.
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۳.۰ به‌روزرسانی شد.

Built and tested with:

  • نسخه ۱۸.۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.4.0.

Version 3.3.0.0

  • Verified compatibility with Unity Ads SDK 3.3.0.

Built and tested with:

  • نسخه ۱۸.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
  • Unity Ads SDK version 3.3.0.

Version 3.2.0.1

  • Fixed a null pointer exception crash that occurred when calling loadAd() before calling UnityAds.initialize() .
  • حداقل نسخه SDK مورد نیاز برای تبلیغات موبایلی گوگل به ۱۸.۲.۰ به‌روزرسانی شد.

Version 3.2.0.0

  • Fixed an issue that caused Banner Ad requests to fail.
  • Verified compatibility with Unity Ads SDK 3.2.0.
  • Migrated the adapter to AndroidX.
  • حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۱۸.۱.۱ به‌روزرسانی شد.

Version 3.1.0.0

  • پشتیبانی از اندازه‌های انعطاف‌پذیر بنرهای تبلیغاتی اضافه شد.
  • Adapter fails the ad request if the requested size isn't compatible with any Unity Ads banner sizes
  • Verified compatibility with Unity Ads SDK 3.1.0.

Version 3.0.1.0

  • Verified compatibility with Unity Ads SDK 3.0.1.
  • Fixed a bug that caused 'NPE' while showing an interstitial ad.

Version 3.0.0.2

  • Updated adapter to support new open-beta Rewarded API.
  • Updated the minimum required Google Mobile Ads SDK version to 17.2.0.

نسخه ۳.۰.۰.۱

  • Added support for Unity Ads Banner.

Version 3.0.0.0

  • Verified compatibility with Unity Ads SDK 3.0.0.

Version 2.3.0.0

  • Verified compatibility with Unity Ads SDK 2.3.0.

Version 2.2.1.1

  • Updated the adapter to invoke the onRewardedVideoComplete() ad event.

Version 2.2.1.0

  • Verified compatibility with Unity Ads SDK 2.2.1.

Version 2.2.0.0

  • Verified compatibility with Unity Ads SDK 2.2.0.

Version 2.1.2.0

  • Verified compatibility with Unity Ads SDK 2.1.2.

Version 2.1.1.0

  • Verified compatibility with Unity Ads SDK 2.1.1.

Version 2.1.0.0

  • Updated the adapter to make it compatible with Unity Ads SDK 2.1.0.

Version 2.0.8.0

  • Verified compatibility with Unity Ads SDK 2.0.8.

Version 2.0.7.0

  • Using Unity Ads's click reporting (AdMob and Unity Ads click statistics will match up).
  • Added onAdLeftApplication callback support.

Version 2.0.6.0

  • Verified compatibility with Unity Ads SDK 2.0.6.

Version 2.0.5.0

  • The adapters can now be added as a compile dependency by adding the following to the build.gradle file's dependencies tag: compile 'com.google.ads.mediation:unity:2.0.5.0'
  • Moved to distributing the adapter as an aar instead of a jar file (see README for additional instructions).

Version 2.0.4.0

  • Fixed a bug that caused rewarded video ads to fail to load when an interstitial ad was loaded first.

Version 2.0.2.0

  • Changed the version naming system to [Unity Ads SDK version].[adapter patch version].
  • Updated the minimum required Unity Ads SDK to v2.0.2.
  • Updated the minimum required Google Mobile Ads SDK to v9.0.0.
  • Apps are no longer required to call UnityAds.changeActivity(this).

نسخه ۱.۰.۰

  • Initial release. Supports reward-based video ads and interstitial ads.