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

توفّر الفئة MobileAds إعدادات عامة لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.

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

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

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

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

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

تحذير: يؤدي كتم صوت تطبيقك إلى تقليل أهلية إعلانات الفيديو وقد يؤدي إلى تقليل أرباح الإعلانات في تطبيقك. يجب ألّا تستخدم هذه الطريقة إلّا إذا كان تطبيقك يوفّر للمستخدم عنصر تحكّم مخصّص في كتم الصوت، ونعكس قرار المستخدم بالتجاهل بشكلٍ صحيح في التطبيق.

الموافقة على استخدام ملفات تعريف الارتباط

إذا كان لتطبيقك متطلبات خاصة، يمكنك ضبط مفتاح gad_has_consent_for_cookies الاختياري ApplicationPreferences على صفر لتفعيل إعلانات محدودة (LTD):

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

تصغير حجم البيانات على Android

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

1. تفعيل ملف Proguard المخصّص

   انتقِل إلى إعدادات المشروع > المشغّل > Android > إعدادات النشر > الإصدار، واختَر:

   • ملف Proguard المخصّص

2. افتح /Assets/Plugins/Android/proguard-user.txt وأضِف ما يلي:

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