تنظیمات جهانی

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

رویدادهای تبلیغاتی را در موضوع اصلی Unity افزایش دهید

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

اگر می‌خواهید SDK Ads Mobile این نگرانی را برای شما حل کند، MobileAds.RaiseAdEventsOnUnityMainThread را روی true تنظیم کنید. این کار SDK را مجبور می‌کند تا همه رویدادها و تماس‌ها را در رشته اصلی Unity افزایش دهد.

...
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;
    }
}

توجه: یک عارضه جانبی افزایش رویدادها در رشته اصلی Unity به این معنی است که رویدادهای خاصی مانند OnAdFullScreenContentOpened تا زمانی که کاربر به برنامه بازگردد، بالا نمی رود.

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

اگر برنامه شما دارای کنترل‌های میزان صدای خاص خود است، مانند موسیقی سفارشی یا حجم جلوه‌های صوتی، افشای حجم برنامه در Google Mobile Ads SDK به تبلیغات ویدیویی امکان می‌دهد به تنظیمات حجم برنامه احترام بگذارند. این تضمین می کند که کاربران تبلیغات ویدیویی را با حجم صوتی مورد انتظار دریافت کنند.

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

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

// 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 را برای فعال کردن تبلیغات محدود (LTD) روی صفر تنظیم کنید:

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

کوچک سازی اندروید

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

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

   به Project Settings > Player > Android > Publishing Settings > Build بروید و انتخاب کنید:

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

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

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