البدء

هذا الدليل مُعد للناشرين الذين يريدون تحقيق الدخل من تطبيق Unity.

إن دمج المكوّن الإضافي Google Mobile Ads Unity في أحد التطبيقات، والذي ستفعله هنا، هو الخطوة الأولى نحو عرض إعلانات AdMob وتحقيق الأرباح. وبعد اكتمال الدمج، يمكنك اختيار شكل إعلان (مثل إعلان فيديو مدمج مع المحتوى أو إعلان بمكافأة) للحصول على خطوات تنفيذ تفصيلية.

المتطلبات الأساسية

• استخدام إصدار Unity 2019 أو إصدار أحدث
• للنشر على iOS
  • الإصدار Xcode 13.2.1 أو إصدار أحدث
  • الإصدار 10.0 من نظام التشغيل iOS أو إصدار أحدث
  • CocoaPods
• للنشر على Android
  • "خدمات Google Play" الإصدار 18.1.0 أو إصدار أحدث
  • استهداف المستوى 16 من واجهة برمجة تطبيقات Android أو مستوى أعلى
• ننصحك بـ: إنشاء حساب AdMob وتسجيل تطبيق Android و/أو iOS

تنزيل المكوّن الإضافي Unity Ads Unity

يتيح المكوّن الإضافي Unity لإعلانات Google على الجوّال لمطوّري برامج Unity إمكانية عرض إعلانات Google للجوّال بسهولة على تطبيقات Android وiOS دون الحاجة إلى كتابة شفرة جافا أو الهدف-C. ويوفّر المكوّن الإضافي واجهة C# لطلب الإعلانات التي تستخدمها النصوص البرمجية C# في مشروع Unity.

استخدم الروابط أدناه لتنزيل حزمة Unity للمكون الإضافي أو لإلقاء نظرة على الشفرة على GitHub.

تنزيل المكون عرض المصدر

استيراد المكوّن الإضافي Unity لإعلانات الجوّال

افتح مشروعك في محرر Unity. حدد مواد العرض > استيراد الحزمة > الحزمة المخصصة وابحث عن ملف GoogleMobileAdsPlugin.unitypackage الذي نزلته.

تأكد من تحديد جميع الملفات وانقر على استيراد.

تضمين حزمة SDK لإعلانات الأجهزة الجوّالة

يتم توزيع المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة مع مكتبة محلل خدمات Unity Play. تم تصميم هذه المكتبة للاستخدام بواسطة أي من مكونات Unity الإضافية التي تتطلب الوصول إلى مكتبات خاصة بنظام Android (مثل AARs) أو iOS CocoaPods. وتوفّر هذه المكوّنات الإضافية لـ Unity إمكانية الإعلان عن التبعيات، والتي يتم حلها بعد ذلك ونسخها تلقائيًا في مشروع Unity.

اتّبع الخطوات الواردة أدناه لضمان احتواء مشروعك على حزمة SDK لإعلانات الأجهزة الجوّالة.

تعيين رقم تعريف تطبيق AdMob

في محرر Unity، حدد مواد العرض > إعلانات Google للجوّال > الإعدادات من القائمة.

أدخل رقم تعريف تطبيق AdMob وAndroid في كل حقل.

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

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

تهيئة حزمة SDK لإعلانات الجوّال

قبل تحميل الإعلانات، يجب إعداد حزمة SDK لإعلانات الأجهزة الجوّالة من خلال الاتصال على MobileAds.Initialize(). يجب تنفيذ هذا الإجراء مرة واحدة فقط، ويُفضَّل عند تشغيل التطبيق.

في ما يلي مثال على كيفية استدعاء Initialize() في طريقة Start() من نص برمجي تم إرفاقه GameObject:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

إذا كنت تستخدم التوسط، انتظر حتى يحدث معاودة الاتصال قبل تحميل الإعلانات، حيث سيضمن ذلك تهيئة جميع محولات التوسط.

اختيار شكل الإعلان

يتم الآن تضمين حزمة SDK لإعلانات الجوّال في تطبيق Unity عند النشر على النظام الأساسي Android أو iOS. أنت الآن مستعد لتنفيذ إعلان. يقدم AdMob عددًا من أشكال الإعلانات المختلفة، لذا يمكنك اختيار الشكل الذي يناسب احتياجات المستخدم.

"بانر"

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

تنفيذ إعلان بانر

إعلان بيني

الإعلانات البينية هي إعلانات بملء الشاشة تغطي واجهة أحد التطبيقات إلى أن يغلقها المستخدم. ومن الأفضل استخدامها في فترات الإيقاف المؤقت الطبيعية في تدفق تنفيذ التطبيق، على سبيل المثال بين مستويات اللعبة أو بعد إكمال مهمة مباشرةً.

تنفيذ إعلان بيني

مدمجة مع المحتوى

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

تنفيذ الإعلانات المدمجة مع المحتوى

تم منح المكافأة

إعلانات الفيديو بمكافأة هي إعلانات فيديو بملء الشاشة يتوفّر للمستخدمين خيار مشاهدتها بالكامل مقابل مكافآت داخل التطبيق.

تنفيذ الإعلانات بمكافأة

طلب تفويض شفافية تتبُّع التطبيقات

لعرض طلب تفويض شفافية تتبُّع التطبيقات (ATT) للوصول إلى معرّف المعلِنين (IDFA)، استخدِم حزمة دعم الإعلانات على نظام التشغيل iOS 14 في Unity.

مفتاح التطبيق نفسه

المتطلبات الأساسية: الإصدار 6.1.0 من المكوِّن الإضافي Unity من "إعلانات Google للأجهزة الجوّالة" أو إصدار أحدث

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

يتم تمكين مفتاح التطبيق نفسه بشكل افتراضي، ولكن يمكنك تعطيله باستخدام واجهة برمجة التطبيقات التالية:

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }