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

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

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

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

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

مزامنة أحداث الإعلانات يدويًا

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

يسجّل المثال التالي سلسلة محادثات في الخلفية وينفّذ إجراءً للتفاعل مع عناصر UnityEngine:

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
    });
};

أتمتة المزامنة عند وقوع أحداث إعلانية

لكي تتمكّن حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من مزامنة أحداث الإعلانات، اضبط السمة 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;
    }
}

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

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

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

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

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

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

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

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

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

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