تنظیمات کلی

پلاتفرم را انتخاب کنید: Android iOS Unity Android (قدیمی)

کلاس MobileAds تنظیمات سراسری برای Google Mobile Ads Unity Plugin ارائه می‌دهد.

رویدادهای آگهی را در رشته اصلی Unity ایجاد کنید

Google Mobile Ads Unity Plugin رویدادها را در رشته‌ای متفاوت از رشته اصلی Unity ایجاد می‌کند. اگر رویدادهای آگهی را پیاده‌سازی می‌کنید و با اشیاء Unity تعامل دارید، باید رویدادهای Google Mobile Ads Unity Plugin را با رشته اصلی Unity همگام‌سازی کنید.

رویدادهای آگهی را با رشته اصلی Unity به‌صورت دستی یا خودکار همگام‌سازی کنید و اجازه دهید Google Mobile Ads Unity Plugin همگام‌سازی را مدیریت کند.

توصیه‌شده: همگام‌سازی دستی رویدادهای آگهی

برای همگام‌سازی دستی رویدادهای آگهی، از روش ExecuteInUpdate در رشته اصلی استفاده کنید. هنگام تعامل با اشیای UnityEngine و زمانی که ویژگی RaiseAdEventsOnUnityMainThread غیرفعال است، باید از روش ExecuteInUpdate استفاده کنید.

مثال زیر رشته پس‌زمینه‌ای را ثبت می‌کند و کنشی را برای تعامل با اشیاء UnityEngine اجرا می‌کند:

// Google Mobile Ads events are raised off the Unity main thread.

// This log is executed off the Unity main thread.
// Write all time-sensitive code before ExecuteInUpdate().
Debug.Log("Executing off the Unity main thread.");

// Use ExecuteInUpdate to run code on the main thread, allowing you to
// interact with Unity UI and GameObjects.
// Changed to fully-qualified name to resolve CS0103
GoogleMobileAds.Common.MobileAdsEventExecutor.ExecuteInUpdate(() =>
{
    // This callback may be delayed on Android until the user returns to the app.
    Debug.Log("Executing on the Unity main thread.");

    // Place all code that interacts with Unity UI and GameObjects inside this callback.
    if (_myGameObject != null)
    {
        _myGameObject.SetActive(true);
    }
});

خودکارسازی همگام‌سازی در رویدادهای آگهی

برای اینکه Google Mobile Ads Unity Plugin رویدادهای آگهی را همگام‌سازی کند، ویژگی MobileAds.RaiseAdEventsOnUnityMainThread را روی true تنظیم کنید:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

کنترل میزان صدای آگهی ویدیویی

اگر برنامه‌تان کنترل‌های میزان صدای خودش را دارد، مثلاً میزان صدای موسیقی یا جلوه صوتی سفارشی، شفاف‌سازی میزان صدای برنامه برای Google Mobile Ads Unity Plugin به آگهی‌های ویدیویی امکان می‌دهد تنظیمات میزان صدای برنامه را رعایت کنند. این کار تضمین می‌کند که کاربران آگهی‌های ویدیویی را با میزان صدای موردانتظار دریافت کنند.

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

می‌توانید با فراخوانی روش SetApplicationVolume() قبل‌از بار کردن آگهی، میزان صدای نسبی برنامه را به Google Mobile Ads Unity Plugin گزارش کنید. مقادیر معتبر میزان صدای آگهی از 0.0 (بی‌صدا) تا 1.0 (میزان صدای فعلی دستگاه) است. در اینجا نمونه‌ای از نحوه گزارش کردن میزان صدای نسبی برنامه به کیت توسعه نرم‌افزار آورده شده است:

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);

برای اطلاع دادن به کیت توسعه نرم‌افزار (SDK) درباره بی‌صدا شدن صدای برنامه، روش SetApplicationMuted() را قبل‌از بار کردن آگهی فراخوانی کنید:

// Set app to be muted.
MobileAds.SetApplicationMuted(true);

به‌طور پیش‌فرض، میزان صدای برنامه روی 1 (میزان صدای فعلی دستگاه) تنظیم شده است و برنامه بی‌صدا نیست.

اگر برنامه‌تان الزامات خاصی دارد، می‌توانید کلید اختیاری ApplicationPreferences gad_has_consent_for_cookies را روی صفر تنظیم کنید تا آگهی‌های محدود فعال شود:

// Enable limited ads
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

کوچک‌سازی Android

این گزینه انتشار Unity به شما امکان می‌دهد کوچک‌سازی کد جاوا را فعال کنید. اگر کوچک‌سازی را فعال کنید، باید فایل proguard سفارشی نیز ایجاد کنید تا کلاس‌های ارجاع‌شده توسط کیت توسعه نرم‌افزار را حفظ کنید.

  1. فعال کردن فایل Proguard سفارشی

    به تنظیمات پروژه > پخش‌کننده > Android > تنظیمات انتشار > ساخت بروید، و این موارد را انتخاب کنید:

    • فایل Proguard سفارشی

  2. /Assets/Plugins/Android/proguard-user.txt را باز کنید و موارد زیر را اضافه کنید:

-keep class com.google.** { public *; }

غیرفعال کردن گزارش خرابی

Google Mobile Ads Unity Plugin گزارش‌های خرابی را برای اهداف اشکال‌زدایی و تجزیه‌وتحلیل جمع‌آوری می‌کند. برای غیرفعال کردن گزارش خرابی، بخش‌های زیر را برای Android و iOS ببینید.

Android

برچسب <meta-data> را با DISABLE_CRASH_REPORTING تنظیم‌شده روی true در فایل AndroidManifest.xml برنامه‌تان اضافه کنید:

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

iOS

برای غیرفعال کردن گزارش‌های خرابی در iOS، روش DisableSDKCrashReporting را فراخوانی کنید:

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}

دریافت نسخه افزایه Unity

برای دریافت نسخه Unity SDK، دستور زیر را اجرا کنید:

// Get the Unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

دریافت نسخه پلاتفرم

Google Mobile Ads Unity Plugin برای Unity به کیت‌های توسعه نرم‌افزار پلاتفرم Android و iOS وابسته است. برای دریافت نسخه کیت توسعه نرم‌افزار پلاتفرم، دستور زیر را اجرا کنید:

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());