البدء

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

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

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

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

• ننصحك بـ: أنشئ حسابًا على AdMob وسجِّل تطبيقًا على Android أو iOS

يتم ضبط مستوى واجهة برمجة تطبيقات Android في إعدادات المشروع > المشغّل > Android > إعدادات أخرى > إعدادات أخرى.

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

واجهة OpenUPM-CLI

إذا كان لديك OpenUPM CLI مثبّتًا، يمكنك تثبيت قاعدة بيانات المسجّلين OpenUPM باستخدام الأمر التالي:

openupm add com.google.ads.mobile

إزالة .unitypackage مادة عرض للمكوّن الإضافي

إذا أردت الانتقال من استخدام .unitypackage إلى استخدام OpenUPM، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم. أزِل الأدلة التالية التي تم استيرادها من .unitypackage:

• مواد العرض/مدير التبعية الخارجية
• مواد العرض/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. افتح إعدادات مدير الحزم من خلال تحديد خيار قائمة Unity تعديل > إعدادات المشروع > مدير الحزم.

2. إضافة OpenUPM كسجلّ نطاق إلى نافذة "إدارة الحزم":

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. افتح قائمة مدير الحزمة من خلال تحديد خيار قائمة Unity Window > Package Manager.

4. اضبط القائمة المنسدلة لنطاق المدير على اختيار سجلاتي.

   

5. اختَر حزمة Google Mobile Ads for Unity من قائمة الحزم واضغط على تثبيت.

إزالة .unitypackage مادة عرض للمكوّن الإضافي

إذا أردت الانتقال من استخدام .unitypackage إلى استخدام OpenUPM، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم. أزِل الأدلة التالية التي تم استيرادها من .unitypackage:

• مواد العرض/مدير التبعية الخارجية
• مواد العرض/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

الاستيراد من GitHub

1. يمكنك تنزيل أحدث إصدار من .unitypackage من GitHub.
2. استورِد ملف .unitypackage من خلال تحديد خيار قائمة Unity مواد العرض > استيراد حزمة > حزمة مخصّصة واستيراد كل العناصر.

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

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

ملاحظة مُهمّة: استخدِم أحدث إصدار من "SDK لإعلانات Google على الأجهزة الجوّالة" حتى تتوفّر لك جميع ميزات الامتثال للخصوصية.

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

Android

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

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

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

iOS

يستخدم Unity for iOS CocoaPods لتحديد الموارد التابعة وإدارتها. يمكنك الرجوع إلى مستندات CocoaPods للاطّلاع على المتطلبات المحدّدة أو خطوات تحديد المشاكل وحلّها المتعلّقة بتبعيات نظام التشغيل iOS.

يتم إدراج تبعيات مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة في Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

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

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

أدخِل بيانات نظام التشغيل Android وiOS رقم تعريف تطبيق AdMob في كل حقل.

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

قبل تحميل الإعلانات، اطلب من تطبيقك إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة من خلال طلب الرقم MobileAds.Initialize(). يجب القيام بذلك مرة واحدة فقط، من الناحية المثالية عند إطلاق التطبيق.

تحذير: يمكن تحميل الإعلانات مسبقًا عن طريق "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" أو حِزم تطوير البرامج (SDK) الخاصة بشركاء التوسّط عند طلب الإضافة MobileAds.Initialize(). إذا أردت الحصول على موافقة من المستخدمين في المنطقة الاقتصادية الأوروبية، اضبط أي علامات محدّدة للطلب، مثل tagForChildDirectedTreatment أو tag_for_under_age_of_consent، أو عليك اتّخاذ إجراء قبل تحميل الإعلانات. تأكَّد من إجراء ذلك قبل إعداد "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة".

إليك مثال على كيفية استدعاء 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 عددًا من أشكال الإعلانات المختلفة، لذلك يمكنك اختيار الشكل الذي يوفّر أفضل تجربة للمستخدم.

بانر

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

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

إعلان بيني

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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