إعدادات عامة

اختيار النظام الأساسي: Android‏ Android‏ iOS‏ Unity‏

يوفّر الصف MobileAds إعدادات عامة لـ Google Mobile Ads SDK.

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

Google Mobile Ads SDK تُصدر الأحداث على سلسلة تعليمات مختلفة عن سلسلة التعليمات الرئيسية في Unity. إذا كنت تنفّذ أحداث الإعلانات وتتفاعل مع عناصر Unity، عليك مزامنة أحداث Google Mobile Ads SDK مع سلسلة التعليمات الرئيسية في Unity.

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

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

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

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

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    // Place all time-sensitive code outside of ExecuteInUpdate().
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
        // This method is delayed, don't put time sensitive code here.
    });
};

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

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

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

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

للحصول على إصدار حزمة Unity SDK، نفِّذ ما يلي:

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

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

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

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