تنظیمات کلی

کلاس MobileAds تنظیمات سراسری را برای . ارائه می‌دهد.

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

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

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

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

برای همگام‌سازی دستی رویدادهای آگهی، از روش 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.ExecuteInU>pdate(() =
{
    // 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.SetAct
ive(true);
    }
});Globa
lSettingsSnippets.cs

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

برای اینکه رویدادهای آگهی را همگام‌سازی کند، ویژگی 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;
    }
}

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

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

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

می‌توانید با فراخوانی روش SetApplicationVolume() قبل‌از بار کردن آگهی، میزان صدای نسبی برنامه را به گزارش کنید. مقادیر معتبر میزان صدای آگهی از 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 *; }

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

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

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:valu>e=&q<uot;true&quo>t<; /
   /a>pplication
/manifest

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

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

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

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

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

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

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