إعدادات عامة

توفّر فئة MobileAds إعدادات عامة لـ .

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

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

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

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

لمزامنة أحداث الإعلانات يدويًا، استخدِم طريقة 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.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 (مستوى الصوت الحالي للجهاز). في ما يلي مثال على كيفية إبلاغ حزمة تطوير البرامج (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 *; }

إيقاف ميزة إعداد تقارير الأعطال

يجمع تقارير الأعطال لأغراض تصحيح الأخطاء والتحليل. لإيقاف إعداد تقارير الأعطال، يُرجى الاطّلاع على الأقسام التالية لنظامَي التشغيل 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

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

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

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

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

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