إعدادات عمومية

تقدّم فئة MobileAds إعدادات عامة لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

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

تُنشئ حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" أحداثًا في سلسلة مهام مختلفة عن السلسلة الرئيسية لـ Unity. في حال تنفيذ أحداث الإعلانات والتفاعل مع عناصر Unity، يجب مزامنة أحداث حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة مع سلسلة المهام الرئيسية في Unity.

إذا أردت أن تتعامل حزمة SDK لعرض الإعلانات على الأجهزة الجوّالة مع هذه المشكلة المتعلّقة بالسلسلة، اضبط MobileAds.RaiseAdEventsOnUnityMainThread على true. يفرض ذلك على IDE 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 إلى أن يعود المستخدم إلى التطبيق.

التحكّم في مستوى صوت إعلانات الفيديو

إذا كان تطبيقك يتضمّن عناصر تحكّم في مستوى الصوت، مثل مستويات مخصّصة للموسيقى أو المؤثرات الصوتية، يؤدي الإفصاح عن مستوى صوت التطبيق لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى السماح لإعلانات الفيديو بمراعاة إعدادات مستوى الصوت في التطبيق. ويضمن ذلك عرض إعلانات الفيديو للمستخدمين بمستوى الصوت المتوقّع.

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

يمكنك الإبلاغ عن حجم التطبيق النسبي لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة من خلال استدعاء 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 على صفر لتفعيل الإعلانات المحدودة (LTD):

// Enable limited ads (LTD)
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 *; }

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

تجمع حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" تقارير الأعطال لأغراض تتعلّق بالتحليل وتحديد الأخطاء وإصلاحها. يمكنك إيقاف ميزة الإبلاغ عن الأعطال هذه باستخدام الرمز التالي. توضّح الأقسام التالية كيفية إيقاف ميزة الإبلاغ عن الأعطال على 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();
}