إعداد إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity

اختيار النظام الأساسي: Android iOS Unity Flutter Android (إصدار قديم)

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

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

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

• استخدِم Unity Editor 2019.4 أو إصدارًا أحدث.
  • ننصح باستخدام الإصدار 2022.2 أو إصدار أحدث.
• للنشر على iOS:
  • ‫Xcode 16.0 أو إصدار أحدث
  • استهداف iOS 13.0 أو إصدار أحدث
  • CocoaPods
• للنشر على Android:
  • المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
  • استهداف المستوى 35 من واجهة برمجة التطبيقات Android أو مستوى أعلى

• ننصح بما يلي: إنشاء حساب على AdMob وتسجيل تطبيق Android أو iOS

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

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

OpenUPM-CLI

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

openupm add com.google.ads.mobile

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

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

• ‫Assets/ExternalDependencyManager
• ‫Assets/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 النافذة > مدير الحزم.

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

   

5. اختَر حزمة إعلانات Google على الأجهزة الجوّالة لـ Unity من قائمة الحزم وانقر على تثبيت.

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

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

• ‫Assets/ExternalDependencyManager
• ‫Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. احصل على علامة إصدار أحدث إصدار. العلامة التي يتم عرضها، باستثناء البادئة v، هي الإصدار Google Mobile Ads Unity Plugin.

   • ‫macOS وLinux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • ‫Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. عدِّل ملف Packages/manifest.json لإضافة سجلّ OpenUPM ضمن نطاق والاعتمادية باستخدام الإصدار الذي تم الحصول عليه من الأمر السابق:

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.5.0"
     }
   }
   

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

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

• ‫Assets/ExternalDependencyManager
• ‫Assets/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 مواد العرض > استيراد حزمة > حزمة مخصّصة واستيراد جميع العناصر.

ضبط معرّف تطبيقك على AdMob

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

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

Google Mobile Ads Unity Plugin يحفظ هذه الإعدادات كنص في ملف الإعداد Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset.

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

قبل تحميل الإعلانات، اطلب من تطبيقك إعداد Google Mobile Ads Unity Plugin من خلال استدعاء MobileAds.Initialize(). يجب إجراء ذلك مرة واحدة فقط، ويُفضّل أن يكون ذلك عند فتح التطبيق.

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

في ما يلي مثال على كيفية استدعاء MobileAds.Initialize():

MobileAds.Initialize((InitializationStatus initstatus) => { if (initstatus == null) { Debug.LogError("Google Mobile Ads initialization failed."); return; } Debug.Log("Google Mobile Ads initialization complete."); MobileAdsEventExecutor.ExecuteInUpdate(() => { // Interact with UnityEngine objects on the main thread here. }); });

GoogleMobileAdsController.cs

التفاعل مع عناصر Unity على سلسلة التعليمات الرئيسية

Google Mobile Ads Unity Plugin يرفع أحداث الإعلانات على سلسلة تعليمات في الخلفية. إذا كانت معاودة الاتصال بالإعلانات تتفاعل مع عناصر Unity، مثل UnityEngine، عليك جدولة هذا العمل بشكلٍ صريح على سلسلة التعليمات الرئيسية في Unity باستخدام طريقة MobileAdsEventExecutor.ExecuteInUpdate. للاطّلاع على تفاصيل التنفيذ، يُرجى مراجعة مقالة رفع أحداث الإعلانات على سلسلة التعليمات الرئيسية في Unity.

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

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

بانر

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

عرض "إعلانات بانر"

إعلان بيني

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

عرض الإعلانات البينية

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

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

عرض "إعلانات مدمجة مع المحتوى"

تمت المكافأة

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

عرض "الإعلانات مقابل مكافأة"

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

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

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

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

عرض "الإعلانات البينية مقابل مكافأة"

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

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

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