ادغام تبلیغات Unity با واسطه

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Unity Ads با استفاده از AdMob Mediation استفاده کنید که ادغام‌های آبشار را پوشش می‌دهد. نحوه افزودن Unity Ads به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Unity Ads SDK و آداپتور در یک برنامه Android را پوشش می دهد.

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

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

یکپارچه سازی
مناقصه 1
آبشار
فرمت ها
بنر
بینابینی
پاداش داده شد
بومی

1 ادغام مناقصه در نسخه بتا باز است.

الزامات

  • Android API سطح 21 یا بالاتر
  • [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی شده در مناقصه، از Unity adapter 4.13.0.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )

  • جدیدترین SDK تبلیغات موبایل گوگل

  • راهنمای شروع میانجیگری را کامل کنید

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

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

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

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

فرم را پر کنید و روی Create کلیک کنید تا پروژه خود را اضافه کنید.

به Unity Ads Monetization بروید، سپس روی شروع به کار کلیک کنید.

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

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

تنظیم مکان خود را انتخاب کنید، سپس روی Next کلیک کنید.

مناقصه آبشار

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

به شناسه بازی توجه کنید.

واحدها و مکان های تبلیغاتی ایجاد کنید

به Unity Ads Monetization > Placements بروید، سپس پروژه خود را انتخاب کنید و روی Add unit ad کلیک کنید.

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

مناقصه آبشار

Bidding را برای راه اندازی انتخاب کنید. در قسمت Placement ، نام مکان را وارد کنید.

شناسه مکان را یادداشت کنید.

برای راه اندازی، آبشار را انتخاب کنید. در قسمت Placement ، نام مکان ، GEO Tagging و Target را وارد کنید.

شناسه مکان را یادداشت کنید.

در نهایت، روی افزودن واحد تبلیغات کلیک کنید تا واحد تبلیغات و مکان شما ذخیره شود.

کلید API گزارش Unity Ads را پیدا کنید

مناقصه آبشار

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

به Unity Ads Monetization > مدیریت API بروید و کلید API را در دسترسی به API Stats در کسب درآمد یادداشت کنید.

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

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

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

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

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

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

مرحله 2: درخواست Unity Ads را در رابط کاربری AdMob تنظیم کنید

تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید

باید Unity Ads را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.

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

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

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

به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کرده‌اید مشاهده کنید:

Unity Ads را به عنوان منبع تبلیغاتی اضافه کنید

مناقصه آبشار
در زیر کارت مناقصه در بخش منابع آگهی ، افزودن منبع آگهی را انتخاب کنید. سپس Unity Ads را انتخاب کنید.

روی نحوه امضای قرارداد مشارکت و راه اندازی یک مشارکت در مناقصه با Unity Ads کلیک کنید.



روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.



اگر قبلاً نقشه‌ای برای Unity Ads دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.



سپس شناسه بازی و شناسه مکان به دست آمده در قسمت قبل را وارد کنید. سپس روی Done کلیک کنید.




در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید. سپس Unity Ads را انتخاب کنید.

Unity Ads را انتخاب کرده و سوئیچ Optimize را فعال کنید. برای تنظیم بهینه‌سازی منبع آگهی برای Unity Ads، کلید API و شناسه هسته سازمان را که در بخش قبل به دست آمده‌اند وارد کنید. سپس یک مقدار eCPM را برای Unity Ads وارد کنید و روی Continue کلیک کنید.



اگر قبلاً نقشه‌ای برای Unity Ads دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.

سپس شناسه بازی و شناسه مکان به دست آمده در قسمت قبل را وارد کنید. سپس روی Done کلیک کنید.


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

برای افزودن Unity Ads به فهرست شرکای آگهی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

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

در فایل build.gradle.kts در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه های Unity Ads SDK و آداپتور استفاده کنید:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.0.0")
    implementation("com.unity3d.ads:unity-ads:4.13.1")
    implementation("com.google.ads.mediation:unity:4.13.1.0")
}

ادغام دستی

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

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

مرحله 4: تنظیمات حریم خصوصی را در Unity Ads SDK اجرا کنید

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

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

جاوا کاتلین 
import com.unity3d.ads.metadata.MetaData;
// ...

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();

import com.unity3d.ads.metadata.MetaData
// ...

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()

برای جزئیات بیشتر و مقادیری که می‌توان در هر روش ارائه کرد، به APIهای رضایت حریم خصوصی و داده‌های Unity Ads و پیروی از راهنمای GDPR مراجعه کنید.

قوانین حفظ حریم خصوصی ایالات متحده

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

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

جاوا کاتلین 
import com.unity3d.ads.metadata.MetaData;
// ...

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

import com.unity3d.ads.metadata.MetaData
// ...

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

برای جزئیات بیشتر و مقادیری که می‌توان در هر روش ارائه کرد ، APIهای رضایت حریم خصوصی و داده‌های Unity Ads و پیروی از راهنماهای CCPA را ببینید.

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

هیچ کد اضافی برای ادغام Unity Ads مورد نیاز نیست.

مرحله 6: اجرای خود را آزمایش کنید

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

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

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

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

کدهای خطا

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

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

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

کد خطا دلیل
0-10 UnityAds SDK یک خطا برگرداند. برای جزئیات بیشتر به کد مراجعه کنید.
101 پارامترهای سرور UnityAds پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است.
102 UnityAds یک مکان با حالت NO_FILL برگرداند.
103 UnityAds یک مکان را با وضعیت DISABLED برگرداند.
104 UnityAds سعی کرد تبلیغی را با زمینه پوچ نشان دهد.
105 زمینه مورد استفاده برای مقداردهی اولیه، بارگیری و/یا نمایش تبلیغات از Unity Ads یک نمونه Activity نیست.
106 UnityAds سعی کرد تبلیغی را نشان دهد که برای نمایش آماده نیست.
107 UnityAds در دستگاه پشتیبانی نمی شود.
108 UnityAds می تواند تنها 1 تبلیغ را در هر مکان بارگیری کند.
109 UnityAds با یک وضعیت ERROR به پایان رسید.
200-204 خطای خاص بنر UnityAds. برای جزئیات بیشتر به کد مراجعه کنید.

Unity Ads Android Mediation Adapter Changelog

نسخه بعدی

  • minSdk به 23 به روز شد
  • اکنون تبلیغات پاداش‌دهی شده بدون پارامتر، onUserEarnedReward فراخوانی می‌کند.

نسخه 4.13.1.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.6.0.
  • Unity Ads SDK نسخه 4.13.1.

نسخه 4.13.0.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.6.0.
  • Unity Ads SDK نسخه 4.13.0.

نسخه 4.12.5.1

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.6.0.
  • Unity Ads SDK نسخه 4.12.5.

نسخه 4.12.5.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.5.0.
  • Unity Ads SDK نسخه 4.12.5.

نسخه 4.12.4.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.3.0.
  • Unity Ads SDK نسخه 4.12.4.

نسخه 4.12.3.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.3.0.
  • Unity Ads SDK نسخه 4.12.3.

نسخه 4.12.2.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.2.0.
  • Unity Ads SDK نسخه 4.12.2.

نسخه 4.12.1.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.2.0.
  • Unity Ads SDK نسخه 4.12.1.

نسخه 4.12.0.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.1.0.
  • Unity Ads SDK نسخه 4.12.0.

نسخه 4.11.3.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.1.0.
  • Unity Ads SDK نسخه 4.11.3.

نسخه 4.11.2.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.0.0.
  • Unity Ads SDK نسخه 4.11.2.

نسخه 4.10.0.0

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 23.0.0 به روز شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.10.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.0.0.
  • Unity Ads SDK نسخه 4.10.0.

نسخه 4.9.3.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.6.0.
  • Unity Ads SDK نسخه 4.9.3.

نسخه 4.9.2.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.3.0.
  • Unity Ads SDK نسخه 4.9.2.

نسخه 4.9.1.0

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.3.0 به روز شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.9.1.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.3.0.
  • Unity Ads SDK نسخه 4.9.1.

نسخه 4.8.0.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.2.0.
  • Unity Ads SDK نسخه 4.8.0.

نسخه 4.7.1.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.1.0.
  • Unity Ads SDK نسخه 4.7.1.

نسخه 4.7.0.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.0.0.
  • Unity Ads SDK نسخه 4.7.0.

نسخه 4.6.1.1

  • آداپتور به‌روزرسانی شده برای استفاده از کلاس جدید VersionInfo .
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.0.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.0.0.
  • Unity Ads SDK نسخه 4.6.1.

نسخه 4.6.1.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.5.0
  • Unity Ads SDK نسخه 4.6.1.

نسخه 4.6.0.0

  • پشتیبانی برای ارسال اطلاعات COPPA به Unity Ads SDK اضافه شد.
  • سازگاری تأیید شده با Unity Ads SDK 4.6.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 21.5.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.5.0
  • Unity Ads SDK نسخه 4.6.0.

نسخه 4.5.0.0

  • سازگاری تأیید شده با Unity Ads SDK 4.5.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.4.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.4.0
  • Unity Ads SDK نسخه 4.5.0.

نسخه 4.4.1.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.2.0
  • Unity Ads SDK نسخه 4.4.1.

نسخه 4.4.0.0

  • سازگاری تأیید شده با Unity Ads SDK 4.4.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 21.2.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.2.0
  • Unity Ads SDK نسخه 4.4.0.

نسخه 4.3.0.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.1.0
  • Unity Ads SDK نسخه 4.3.0.

نسخه 4.2.1.1

  • compileSdkVersion و targetSdkVersion به API 31 به روز کرد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.0.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 21.0.0.
  • Unity Ads SDK نسخه 4.2.1.

نسخه 4.2.1.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.6.0.
  • Unity Ads SDK نسخه 4.2.1.

نسخه 4.1.0.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.6.0.
  • Unity Ads SDK نسخه 4.1.0.

نسخه 4.0.1.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.6.0.
  • Unity Ads SDK نسخه 4.0.1.

نسخه 4.0.0.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.5.0.
  • Unity Ads SDK نسخه 4.0.0.

نسخه 3.7.5.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.2.0.
  • Unity Ads SDK نسخه 3.7.5.

نسخه 3.7.4.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.2.0.
  • Unity Ads SDK نسخه 3.7.4.

نسخه 3.7.2.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.2.0.
  • Unity Ads SDK نسخه 3.7.2.

نسخه 3.7.1.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 20.1.0.
  • Unity Ads SDK نسخه 3.7.1.

نسخه 3.6.2.0

  • سازگاری تأیید شده با Unity Ads SDK 3.6.2.
  • مشکلی که در آن آگهی‌های دارای پاداش، تماس‌های برگشتی کلیکی را ارسال نمی‌کردند، برطرف شد.
  • UnityAds SDK از ساخت آداپتور همراه حذف شده است. اکنون ناشران باید به صورت دستی UnityAds SDK را به عنوان یک وابستگی اضافی اضافه کنند.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.8.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.8.0.
  • Unity Ads SDK نسخه 3.6.2.

نسخه 3.6.0.0

  • سازگاری تأیید شده با Unity Ads SDK 3.6.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.6.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.6.0.
  • Unity Ads SDK نسخه 3.6.0.

نسخه 3.5.1.1

  • مشکلی را برطرف کرد که در آن هنگام تلاش برای درخواست چندین آگهی بینابینی و پاداش.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.5.0.
  • Unity Ads SDK نسخه 3.5.1.

نسخه 3.5.1.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.5.0.
  • Unity Ads SDK نسخه 3.5.1.

نسخه 3.5.0.0

  • سازگاری تأیید شده با Unity Ads SDK 3.5.0.
  • پشتیبانی از بنر تطبیقی ​​اضافه شد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.5.0 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.5.0.
  • Unity Ads SDK نسخه 3.5.0.

نسخه 3.4.8.0

  • رفع خطای NullPointerException که هنگام از بین رفتن بنر تبلیغاتی رخ می دهد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.3.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.3.0.
  • Unity Ads SDK نسخه 3.4.8.

نسخه 3.4.6.1

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.1.0.
  • Unity Ads SDK نسخه 3.4.6.

نسخه 3.4.6.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.1.0.
  • Unity Ads SDK نسخه 3.4.6.

نسخه 3.4.2.3

  • کدهای خطای توصیفی و دلایل خرابی بارگذاری/نمایش آداپتور اضافه شد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.1.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.1.0.
  • Unity Ads SDK نسخه 3.4.2.

نسخه 3.4.2.2

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.0.1.
  • Unity Ads SDK نسخه 3.4.2.

نسخه 3.4.2.1

  • ارسال بهتر خطاهای Unity برای شناسایی زودتر خرابی های اولیه و بارگذاری آگهی و کاهش وقفه های زمانی.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.0.1 به روز کرد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 19.0.1.
  • Unity Ads SDK نسخه 3.4.2.

نسخه 3.4.2.0

  • سازگاری تأیید شده با Unity Ads SDK 3.4.2.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.3.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 18.3.0.
  • Unity Ads SDK نسخه 3.4.2.

نسخه 3.4.0.0

  • سازگاری تأیید شده با Unity Ads SDK 3.4.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.3.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 18.3.0.
  • Unity Ads SDK نسخه 3.4.0.

نسخه 3.3.0.0

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 18.2.0.
  • Unity Ads SDK نسخه 3.3.0.

نسخه 3.2.0.1

  • یک خرابی استثنای اشاره گر تهی را که هنگام فراخوانی loadAd() قبل از فراخوانی UnityAds.initialize() رخ داده بود، برطرف کرد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.2.0 به روز شد.

نسخه 3.2.0.0

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

نسخه 3.1.0.0

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

نسخه 3.0.1.0

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

نسخه 3.0.0.2

  • آداپتور به‌روزرسانی شده برای پشتیبانی از API پاداش‌دهی بتا باز جدید.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 17.2.0 به روز شد.

نسخه 3.0.0.1

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

نسخه 3.0.0.0

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

نسخه 2.3.0.0

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

نسخه 2.2.1.1

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

نسخه 2.2.1.0

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

نسخه 2.2.0.0

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

نسخه 2.1.2.0

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

نسخه 2.1.1.0

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

نسخه 2.1.0.0

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

نسخه 2.0.8.0

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

نسخه 2.0.7.0

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

نسخه 2.0.6.0

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

نسخه 2.0.5.0

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

نسخه 2.0.4.0

  • رفع اشکالی که باعث می‌شد تبلیغات ویدیویی پاداش‌دهی شده در ابتدا بارگیری نشود.

نسخه 2.0.2.0

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

نسخه 1.0.0

  • انتشار اولیه از تبلیغات ویدیویی مبتنی بر پاداش و تبلیغات بینابینی پشتیبانی می کند.
،

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Unity Ads با استفاده از AdMob Mediation استفاده کنید که ادغام‌های آبشار را پوشش می‌دهد. نحوه افزودن Unity Ads به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Unity Ads SDK و آداپتور در یک برنامه Android را پوشش می دهد.

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

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

یکپارچه سازی
مناقصه 1
آبشار
فرمت ها
بنر
بینابینی
پاداش داده شد
بومی

1 ادغام مناقصه در نسخه بتا باز است.

الزامات

  • Android API سطح 21 یا بالاتر
  • [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی شده در مناقصه، از Unity adapter 4.13.0.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )

  • جدیدترین SDK تبلیغات موبایل گوگل

  • راهنمای شروع میانجیگری را کامل کنید

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

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

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

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

فرم را پر کنید و روی Create کلیک کنید تا پروژه خود را اضافه کنید.

به Unity Ads Monetization بروید، سپس روی شروع به کار کلیک کنید.

در مدال پروژه جدید ، I will use Mediation و Google Admob for Mediation Partner را انتخاب کنید، سپس روی Next کلیک کنید.

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

تنظیم مکان خود را انتخاب کنید، سپس روی Next کلیک کنید.

مناقصه آبشار

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

به شناسه بازی توجه کنید.

واحدها و مکان های تبلیغاتی ایجاد کنید

به Unity Ads Monetization > Placements بروید، سپس پروژه خود را انتخاب کنید و روی Add unit ad کلیک کنید.

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

مناقصه آبشار

Bidding را برای راه اندازی انتخاب کنید. در قسمت Placement ، نام مکان را وارد کنید.

شناسه مکان را یادداشت کنید.

برای راه اندازی، آبشار را انتخاب کنید. در قسمت Placement ، نام مکان ، GEO Tagging و Target را وارد کنید.

شناسه مکان را یادداشت کنید.

در نهایت، روی افزودن واحد تبلیغات کلیک کنید تا واحد تبلیغات و مکان شما ذخیره شود.

کلید API گزارش Unity Ads را پیدا کنید

مناقصه آبشار

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

به Unity Ads Monetization > مدیریت API بروید و کلید API را در دسترسی به API Stats در کسب درآمد یادداشت کنید.

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

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

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

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

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

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

مرحله 2: درخواست Unity Ads را در رابط کاربری AdMob تنظیم کنید

تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید

باید Unity Ads را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.

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

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

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

به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کرده‌اید مشاهده کنید:

Unity Ads را به عنوان منبع تبلیغاتی اضافه کنید

مناقصه آبشار
در زیر کارت مناقصه در بخش منابع آگهی ، افزودن منبع آگهی را انتخاب کنید. سپس Unity Ads را انتخاب کنید.

روی نحوه امضای قرارداد مشارکت و راه اندازی یک مشارکت در مناقصه با Unity Ads کلیک کنید.



روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.



اگر قبلاً نقشه‌ای برای Unity Ads دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.



سپس شناسه بازی و شناسه مکان به دست آمده در قسمت قبل را وارد کنید. سپس روی Done کلیک کنید.




در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید. سپس Unity Ads را انتخاب کنید.

Unity Ads را انتخاب کرده و سوئیچ Optimize را فعال کنید. برای تنظیم بهینه‌سازی منبع آگهی برای Unity Ads، کلید API و شناسه هسته سازمان را که در بخش قبل به دست آمده‌اند وارد کنید. سپس یک مقدار eCPM را برای Unity Ads وارد کنید و روی Continue کلیک کنید.



اگر قبلاً نقشه‌ای برای Unity Ads دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.

سپس شناسه بازی و شناسه مکان به دست آمده در قسمت قبل را وارد کنید. سپس روی Done کلیک کنید.


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

برای افزودن Unity Ads به فهرست شرکای آگهی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

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

در فایل build.gradle.kts در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه های Unity Ads SDK و آداپتور استفاده کنید:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.0.0")
    implementation("com.unity3d.ads:unity-ads:4.13.1")
    implementation("com.google.ads.mediation:unity:4.13.1.0")
}

ادغام دستی

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

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

مرحله 4: تنظیمات حریم خصوصی را در Unity Ads SDK اجرا کنید

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

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

جاوا کاتلین 
import com.unity3d.ads.metadata.MetaData;
// ...

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();

import com.unity3d.ads.metadata.MetaData
// ...

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()

برای جزئیات بیشتر و مقادیری که می‌توان در هر روش ارائه کرد، به APIهای رضایت حریم خصوصی و داده‌های Unity Ads و پیروی از راهنمای GDPR مراجعه کنید.

قوانین حفظ حریم خصوصی ایالات متحده

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

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

جاوا کاتلین 
import com.unity3d.ads.metadata.MetaData;
// ...

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

import com.unity3d.ads.metadata.MetaData
// ...

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

برای جزئیات بیشتر و مقادیری که می‌توان در هر روش ارائه کرد ، APIهای رضایت حریم خصوصی و داده‌های Unity Ads و پیروی از راهنماهای CCPA را ببینید.

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

هیچ کد اضافی برای ادغام Unity Ads مورد نیاز نیست.

مرحله 6: اجرای خود را آزمایش کنید

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

اطمینان حاصل کنید که دستگاه تست خود را برای ADMOB ثبت کرده و حالت تست را در UI Unity ADS فعال کنید .

تبلیغات آزمون را تأیید کنید

برای تأیید اینکه شما از تبلیغات وحدت تبلیغات آزمون دریافت می کنید ، آزمایش منبع تبلیغاتی تک را در بازرس AD با استفاده از تبلیغات وحدت (مناقصه) و تبلیغات وحدت (آبشار) منبع تبلیغات (های) فعال کنید.

کدهای خطا

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

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

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

کد خطا دلیل
0-10 UnityAds SDK خطایی را برگرداند. برای اطلاعات بیشتر به کد مراجعه کنید.
101 پارامترهای سرور UnityAds پیکربندی شده در UI ADMOB از دست رفته/نامعتبر هستند.
102 UnityAds یک مکان را با حالت NO_FILL برگرداند.
103 UnityAds با یک حالت معلول قرار گرفت.
104 UnityAds سعی کرد یک تبلیغ را با زمینه تهی نشان دهد.
105 زمینه مورد استفاده برای اولیه سازی ، بارگیری و/یا نمایش تبلیغات از تبلیغات وحدت یک نمونه فعالیت نیست.
106 UnityAds سعی کرد تبلیغی را نشان دهد که آماده نمایش نیست.
107 UnityAds در دستگاه پشتیبانی نمی شود.
108 UnityAds فقط می تواند 1 AD در هر مکان را به طور همزمان بارگیری کند.
109 UnityAds با حالت خطا به پایان رسید.
200-204 خطای خاص بنر UnityAds. برای اطلاعات بیشتر به کد مراجعه کنید.

آداپتورهای آندروید آداپتور Anity Adp

نسخه بعدی

  • به روز شده minSdk به 23
  • تبلیغات پاداش اکنون بدون پارامترها با استفاده از onUserEarnedReward تماس می گیرد.

نسخه 4.13.1.0

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

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

  • Google Mobile Ads SDK نسخه 23.6.0.
  • Unity Ads SDK نسخه 4.13.1.

نسخه 4.13.0.0

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

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

  • Google Mobile Ads SDK نسخه 23.6.0.
  • Unity Ads SDK نسخه 4.13.0.

نسخه 4.12.5.1

  • با تنظیم شناسه شی در هنگام بارگذاری تبلیغات ، بنر تبلیغاتی رفع شده را ثابت می کند.

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

  • Google Mobile Ads SDK نسخه 23.6.0.
  • Unity Ads SDK نسخه 4.12.5.

نسخه 4.12.5.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 4.12.5.

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

  • Google Mobile Ads SDK نسخه 23.5.0.
  • Unity Ads SDK نسخه 4.12.5.

نسخه 4.12.4.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 4.12.4.

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

  • Google Mobile Ads SDK نسخه 23.3.0.
  • Unity Ads SDK نسخه 4.12.4.

نسخه 4.12.3.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 4.12.3.

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

  • Google Mobile Ads SDK نسخه 23.3.0.
  • Unity Ads SDK نسخه 4.12.3.

نسخه 4.12.2.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.12.2.

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

  • Google Mobile Ads SDK نسخه 23.2.0.
  • Unity Ads SDK نسخه 4.12.2.

نسخه 4.12.1.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 4.12.1.

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

  • Google Mobile Ads SDK نسخه 23.2.0.
  • Unity Ads SDK نسخه 4.12.1.

نسخه 4.12.0.0

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

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

  • Google Mobile Ads SDK نسخه 23.1.0.
  • Unity Ads SDK نسخه 4.12.0.

نسخه 4.11.3.0

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

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

  • Google Mobile Ads SDK نسخه 23.1.0.
  • Unity Ads SDK نسخه 4.11.3.

نسخه 4.11.2.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.11.2.

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

  • Google Mobile Ads SDK نسخه 23.0.0.
  • Unity Ads SDK نسخه 4.11.2.

نسخه 4.10.0.0

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 23.0.0 به روز کرد.
  • سازگاری تأیید شده با Anity Ads SDK 4.10.0.

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

  • Google Mobile Ads SDK نسخه 23.0.0.
  • Unity Ads SDK نسخه 4.10.0.

نسخه 4.9.3.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.9.3.

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

  • Google Mobile Ads SDK نسخه 22.6.0.
  • Unity Ads SDK نسخه 4.9.3.

نسخه 4.9.2.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.9.2.

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

  • Google Mobile Ads SDK نسخه 22.3.0.
  • Unity Ads SDK نسخه 4.9.2.

نسخه 4.9.1.0

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 22.3.0 به روز کرد.
  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.9.1.

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

  • Google Mobile Ads SDK نسخه 22.3.0.
  • Unity Ads SDK نسخه 4.9.1.

نسخه 4.8.0.0

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

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

  • Google Mobile Ads SDK نسخه 22.2.0.
  • Unity Ads SDK نسخه 4.8.0.

نسخه 4.7.1.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.7.1.

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

  • Google Mobile Ads SDK نسخه 22.1.0.
  • Unity Ads SDK نسخه 4.7.1.

نسخه 4.7.0.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.7.0.

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

  • Google Mobile Ads SDK نسخه 22.0.0.
  • Unity Ads SDK نسخه 4.7.0.

نسخه 4.6.1.1

  • آداپتور به روز شده برای استفاده از کلاس جدید VersionInfo .
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 22.0.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 22.0.0.
  • Unity Ads SDK نسخه 4.6.1.

نسخه 4.6.1.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.6.1.

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

  • Google Mobile Ads SDK نسخه 21.5.0
  • Unity Ads SDK نسخه 4.6.1.

نسخه 4.6.0.0

  • پشتیبانی برای ارسال اطلاعات COPPA به Ads Ads SDK اضافه شد.
  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.6.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را تا 21.5.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 21.5.0
  • Unity Ads SDK نسخه 4.6.0.

نسخه 4.5.0.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 4.5.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را تا 21.4.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 21.4.0
  • Unity Ads SDK نسخه 4.5.0.

نسخه 4.4.1.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.4.1.

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

  • Google Mobile Ads SDK نسخه 21.2.0
  • Unity Ads SDK نسخه 4.4.1.

نسخه 4.4.0.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.4.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.2.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 21.2.0
  • Unity Ads SDK نسخه 4.4.0.

نسخه 4.3.0.0

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

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

  • Google Mobile Ads SDK نسخه 21.1.0
  • Unity Ads SDK نسخه 4.3.0.

نسخه 4.2.1.1

  • به روز شده compileSdkVersion و targetSdkVersion به API 31.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.0.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 21.0.0.
  • Unity Ads SDK نسخه 4.2.1.

نسخه 4.2.1.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.2.1.

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

  • Google Mobile Ads SDK نسخه 20.6.0.
  • Unity Ads SDK نسخه 4.2.1.

نسخه 4.1.0.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 4.1.0.

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

  • Google Mobile Ads SDK نسخه 20.6.0.
  • Unity Ads SDK نسخه 4.1.0.

نسخه 4.0.1.0

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

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

  • Google Mobile Ads SDK نسخه 20.6.0.
  • Unity Ads SDK نسخه 4.0.1.

نسخه 4.0.0.0

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

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

  • Google Mobile Ads SDK نسخه 20.5.0.
  • Unity Ads SDK نسخه 4.0.0.

نسخه 3.7.5.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 3.7.5.

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

  • Google Mobile Ads SDK نسخه 20.2.0.
  • Unity Ads SDK نسخه 3.7.5.

نسخه 3.7.4.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 3.7.4.

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

  • Google Mobile Ads SDK نسخه 20.2.0.
  • Unity Ads SDK نسخه 3.7.4.

نسخه 3.7.2.0

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

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

  • Google Mobile Ads SDK نسخه 20.2.0.
  • Unity Ads SDK نسخه 3.7.2.

نسخه 3.7.1.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 3.7.1.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را تا 20.1.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 20.1.0.
  • Unity Ads SDK نسخه 3.7.1.

نسخه 3.6.2.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 3.6.2.
  • مسئله ای را برطرف کرد که در آن تبلیغات پاداش داده شده در حال ارسال تماس با کلیک نیست.
  • UnityAds SDK از ساخت آداپتور بسته بندی شده حذف شده است. اکنون ناشران موظفند SDK UnityAds را به عنوان یک وابستگی اضافی در نظر بگیرند.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.8.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 19.8.0.
  • Unity Ads SDK نسخه 3.6.2.

نسخه 3.6.0.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 3.6.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.6.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 19.6.0.
  • Unity Ads SDK نسخه 3.6.0.

نسخه 3.5.1.1

  • مسئله ای را برطرف کرد که هنگام تلاش برای درخواست تبلیغات چند منظوره و پاداش.

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

  • Google Mobile Ads SDK نسخه 19.5.0.
  • Unity Ads SDK نسخه 3.5.1.

نسخه 3.5.1.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 3.5.1.
  • مسئله ای را برطرف کرد که باعث عدم موفقیت درخواست های تبلیغاتی بنر می شود.

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

  • Google Mobile Ads SDK نسخه 19.5.0.
  • Unity Ads SDK نسخه 3.5.1.

نسخه 3.5.0.0

  • سازگاری تأیید شده با Anity Ads SDK 3.5.0.
  • پشتیبانی بنر تطبیقی ​​اضافه شده است.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.5.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 19.5.0.
  • Unity Ads SDK نسخه 3.5.0.

نسخه 3.4.8.0

  • رفع یک خطای NullPointerException که هنگام از بین رفتن یک پرچم از بین می رود ، رفع می شود.
  • حداقل نسخه Google Mobile Ads SDK را به 19.3.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 19.3.0.
  • Unity Ads SDK نسخه 3.4.8.

نسخه 3.4.6.1

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

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

  • Google Mobile Ads SDK نسخه 19.1.0.
  • Unity Ads SDK نسخه 3.4.6.

نسخه 3.4.6.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 3.4.6.
  • آداپتور اکنون هنگام کلیک بر روی تبلیغات بنر ، پاسخ به onAdOpened() را به جلو می برد.

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

  • Google Mobile Ads SDK نسخه 19.1.0.
  • Unity Ads SDK نسخه 3.4.6.

نسخه 3.4.2.3

  • کدهای خطای توصیفی و دلایل خرابی بار/نمایش آداپتور اضافه شده است.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.1.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 19.1.0.
  • Unity Ads SDK نسخه 3.4.2.

نسخه 3.4.2.2

  • رفع یک تصادف ConcurrentModificationException ، هنگامی که Unity Ads خطایی را برمی گرداند ، رخ داد.

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

  • Google Mobile Ads SDK نسخه 19.0.1.
  • Unity Ads SDK نسخه 3.4.2.

نسخه 3.4.2.1

  • بهبود پیشروی خطاهای وحدت برای تشخیص اولیه سازی و خرابی بار AD زودتر و کاهش زمان های مختلف.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.0.1 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 19.0.1.
  • Unity Ads SDK نسخه 3.4.2.

نسخه 3.4.2.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 3.4.2.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 18.3.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 18.3.0.
  • Unity Ads SDK نسخه 3.4.2.

نسخه 3.4.0.0

  • سازگاری تأیید شده با Anity Ads SDK 3.4.0.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 18.3.0 به روز کرد.

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

  • Google Mobile Ads SDK نسخه 18.3.0.
  • Unity Ads SDK نسخه 3.4.0.

نسخه 3.3.0.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 3.3.0.

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

  • Google Mobile Ads SDK نسخه 18.2.0.
  • Unity Ads SDK نسخه 3.3.0.

نسخه 3.2.0.1

  • قبل از تماس با UnityAds.initialize() یک تصادف استثناء اشاره گر را که هنگام فراخوانی loadAd() رخ داده است ، برطرف کرد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 18.2.0 به روز کرد.

نسخه 3.2.0.0

  • مسئله ای را برطرف کرد که باعث عدم موفقیت درخواست های بنر شد.
  • سازگاری تأیید شده با آگهی های وحدت SDK 3.2.0.
  • آداپتور را به Androidx منتقل کرد.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 18.1.1 به روز کرد.

نسخه 3.1.0.0

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

نسخه 3.0.1.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 3.0.1.
  • رفع اشکالی که باعث ایجاد "NPE" در هنگام نشان دادن یک تبلیغ بینابینی شد.

نسخه 3.0.0.2

  • آداپتور به روز شده برای پشتیبانی از API با پاداش جدید با بتا باز.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 17.2.0 به روز کرد.

نسخه 3.0.0.1

  • پشتیبانی از پرچم تبلیغات وحدت.

نسخه 3.0.0.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 3.0.0.

نسخه 2.3.0.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 2.3.0.

نسخه 2.2.1.1

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

نسخه 2.2.1.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 2.2.1.

نسخه 2.2.0.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 2.2.0.

نسخه 2.1.2.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 2.1.2.

نسخه 2.1.1.0

  • سازگاری تأیید شده با آگهی های وحدت SDK 2.1.1.

نسخه 2.1.0.0

  • آداپتور را به روز کرد تا آن را با Anity Ads SDK 2.1.0 سازگار کند.

نسخه 2.0.8.0

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

نسخه 2.0.7.0

  • با استفاده از گزارش کلیک ADS Unity (Admob و Ads Ads کلیک کنید ، با آمار کلیک کنید).
  • پشتیبانی از پاسخ به تماس با OnAdleftApplication اضافه شده است.

نسخه 2.0.6.0

  • سازگاری تأیید شده با تبلیغات وحدت SDK 2.0.6.

نسخه 2.0.5.0

  • آداپتورها اکنون می توانند با افزودن موارد زیر به برچسب وابستگی پرونده Build.gradle به عنوان یک وابستگی کامپایل اضافه شوند: compile 'com.google.ads.mediation:unity:2.0.5.0'
  • به جای فایل شیشه ای به توزیع آداپتور به عنوان AAR منتقل شد (برای دستورالعمل های اضافی به README مراجعه کنید).

نسخه 2.0.4.0

  • رفع اشکالی که باعث شد تبلیغات ویدیویی پاداش در هنگام بارگذاری یک آگهی بینابینی در ابتدا بارگیری شود.

نسخه 2.0.2.0

  • سیستم نامگذاری نسخه را به [نسخه Unity Ads SDK نسخه] تغییر داد. [نسخه Adapter Patch].
  • حداقل تبلیغات وحدت مورد نیاز SDK را به v2.0.2 به روز کرد.
  • حداقل تبلیغات مورد نیاز Google Mobile SDK را به V9.0.0 به روز کرد.
  • برنامه ها دیگر نیازی به تماس با UnityAds.ChangeActivity (این) ندارند.

نسخه 1.0.0

  • انتشار اولیه از تبلیغات ویدیویی مبتنی بر پاداش و تبلیغات بینابینی پشتیبانی می کند.