البدء

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

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

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

  • يجب استخدام Unity 2019.4 أو إصدار أحدث
  • للنشر على نظام التشغيل iOS:
    • Xcode 14.1 أو إصدار أحدث
    • استهداف الإصدار 11.0 من نظام التشغيل iOS أو الإصدارات الأحدث
    • CocoaPods
  • للنشر على Android:
    • الحدّ الأدنى لمستوى واجهة برمجة تطبيقات Android هو 21 أو أعلى.
    • المستوى 31 من واجهة برمجة تطبيقات Android المستهدَف أو أعلى

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

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

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

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

استيراد المكوّن الإضافي لوحدة Unity الإعلانية على الأجهزة الجوّالة

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

تضمين التبعيات الخارجية

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

اتبع هذه الخطوات للتأكد من أن مشروعك يتضمن جميع التبعيات:

Android

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

  • نموذج نصب تذكاري رئيسي مخصّص
  • نموذج خصائص Gradle المخصّصة

في محرِّر Unity، انقر على Assets > External تبعency Manager > Android troubleshooterr لكي يتمكّن مكتبة Unity الخارجية من أداة "إدارة التبعيات الخارجية" من نسخ التبعيات التي تمّ الإعلان عنها إلى دليل Assets/Plugins/Android في تطبيق Unity.

iOS

لا يلزم اتخاذ خطوات إضافية لتضمين حزمة SDK لإعلانات Google على الأجهزة الجوّالة في مشروع Unity.

  • عند استخدام Unity 5.6 أو إصدار أحدث، يتم إنشاء xcworkspace التي تتضمن مكتبات التبعية المطلوبة. استخدم xcworkspace التي تم إنشاؤها بدلاً من مشروع Xcode القياسي.
  • عند استخدام الإصدارات السابقة من Unity، يتم تضمين التبعيات داخل مشروع Xcode القياسي.

ضبط رقم تعريف AdMob التطبيق

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

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

إعداد حزمة تطوير البرامج (SDK)

قبل تحميل الإعلانات، اجعل تطبيقك يهيئ حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة من خلال الاتصال بـ 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) لإعلانات Google على الأجهزة الجوّالة مضمّنة الآن في تطبيق Unity عند النشر على نظام التشغيل Android أو iOS الأساسي. أنت الآن جاهز لتنفيذ إعلان. تقدم AdMob عددًا من أشكال الإعلانات المختلفة، لذلك يمكنك اختيار الشكل الذي يحقق أفضل تجربة للمستخدم.

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

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

إعلان بيني

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

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

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

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

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

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

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

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

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

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

على عكس الإعلانات التي تضم مكافأة، لا يُطلب من المستخدمين الموافقة لعرض الإعلان البيني الذي يضم مكافأة.

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

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

فتح التطبيق

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

تنفيذ الإعلانات على شاشة فتح التطبيق