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

کلاس 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;
    }
}

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

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

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

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

اندروید

تگ <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 SDK، موارد زیر را اجرا کنید:

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

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

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

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