إعدادات عامة

اختيار النظام الأساسي: Android iOS Unity Android (قديم)

توفّر فئة MobileAds إعدادات عامة لـ Google Mobile Ads Unity Plugin.

رفع أحداث الإعلانات في سلسلة التعليمات الرئيسية في Unity

Google Mobile Ads Unity Plugin raises events on a different thread than the Unity main thread. إذا كنت تنفّذ أحداث الإعلانات وتتفاعل مع عناصر Unity، عليك مزامنة أحداث Google Mobile Ads Unity Plugin مع سلسلة التعليمات الرئيسية في Unity.

يمكنك مزامنة أحداث الإعلانات مع سلسلة التعليمات الرئيسية في Unity إما يدويًا أو تلقائيًا من خلال السماح لـ "Google Mobile Ads Unity Plugin" بمعالجة المزامنة.

الإجراء المقترَح: مزامنة أحداث الإعلانات يدويًا

لمزامنة أحداث الإعلانات يدويًا، استخدِم طريقة ExecuteInUpdate في سلسلة التعليمات الرئيسية. يجب استخدام طريقة ExecuteInUpdate عند التفاعل مع عناصر UnityEngine، وعندما تكون السمة RaiseAdEventsOnUnityMainThread غير مفعَّلة.

يسجّل المثال التالي سلسلة محادثات في الخلفية وينفّذ إجراءً للتفاعل مع عناصر 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" يتيح لإعلانات الفيديو مراعاة إعدادات مستوى الصوت في التطبيق. يضمن ذلك عرض إعلانات الفيديو للمستخدمين بمستوى الصوت المتوقّع.

يتم تحديد مستوى صوت الجهاز من خلال أزرار التحكّم بمستوى الصوت أو شريط تمرير مستوى الصوت على مستوى نظام التشغيل، ويحدّد مستوى الصوت لمخرجات الصوت في الجهاز. ومع ذلك، يمكن للتطبيقات ضبط مستويات الصوت بشكل مستقل مقارنةً بمستوى صوت الجهاز لتخصيص تجربة الصوت.

يمكنك إبلاغ "Google Mobile Ads Unity Plugin" بمستوى صوت التطبيق النسبي من خلال استدعاء طريقة SetApplicationVolume() قبل تحميل الإعلان. تتراوح القيم الصالحة لمستوى صوت الإعلان بين 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 على صفر لتفعيل الإعلانات المحدودة :

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

إزالة البيانات غير الضرورية في Android

يتيح لك خيار النشر في Unity تفعيل تصغير رمز Java. إذا فعّلت ميزة إزالة البيانات غير الضرورية، عليك أيضًا إنشاء ملف proguard مخصّص للاحتفاظ بالفئات التي تشير إليها حزمة تطوير البرامج (SDK).

  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

استخدِم طريقة DisableSDKCrashReporting لإيقاف تقارير الأعطال على أجهزة iOS:

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

الحصول على إصدار المكوّن الإضافي Unity

للحصول على إصدار حزمة تطوير البرامج (SDK) لمنصة Unity، نفِّذ ما يلي:

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

الحصول على إصدار النظام الأساسي

تعتمد حزمة Google Mobile Ads Unity Plugin لمنصة Unity على حزم تطوير البرامج (SDK) لنظامَي التشغيل Android وiOS. لمعرفة إصدار حزمة تطوير البرامج (SDK) للنظام الأساسي، نفِّذ ما يلي:

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