البدء

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

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

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

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

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

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

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

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

استيراد المكوّن الإضافي لـ Mobile Ads Unity

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

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

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

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

Android

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

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

في محرِّر Unity، اختَر مواد العرض > مدير التبعية الخارجية > أداة حلّ Android > حل لكي تتمكّن مكتبة Unity External Credential Manager من نسخ التبعيات المعلَن عنها إلى دليل 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 عددًا من أشكال الإعلانات المختلفة، بحيث يمكنك اختيار الشكل الذي يحقق أفضل تجربة للمستخدم.

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

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

إعلان بيني

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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