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

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

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

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

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

• استخدِم الإصدار 2019.4 أو إصدارًا أحدث من Unity Editor.
  • ننصح باستخدام الإصدار 2022.2 أو إصدار أحدث.
• للنشر على أجهزة iOS
  • ‫Xcode 16.0 أو إصدار أحدث
  • استهداف الإصدار 13.0 من نظام التشغيل iOS أو الإصدارات الأحدث
  • CocoaPods
• للنشر على Android
  • المستوى 24 من واجهة برمجة تطبيقات 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 تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحزم (Package Manager).

2. أضِف OpenUPM كسجلّ نطاق إلى نافذة "مدير الحزم" باتّباع الخطوات التالية:

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

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

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 Assets > Import package > Custom Package واستيراد جميع العناصر.

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

في "محرّر Unity"، اختَر مواد العرض (Assets) > "إعلانات Google على الأجهزة الجوّالة" (Google Mobile Ads) > الإعدادات (Settings) من القائمة.

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

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

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

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

تحذير: يمكن تحميل الإعلانات مسبقًا من خلال حِزم تطوير البرامج (SDK) الخاصة بـ Google Mobile Ads Unity Plugin أو شريك التوسّط عند طلب 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 عددًا من أشكال الإعلانات المختلفة، ما يتيح لك اختيار الشكل الذي يقدّم أفضل تجربة للمستخدم.

بانر

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

استخدام "إعلانات البانر"

إعلان بيني

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

استخدام الإعلانات البينية

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

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

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

تمت المكافأة

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

عرض الإعلانات مقابل مكافآت

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

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

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

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

استخدام "الإعلانات البينية مقابل مكافأة"

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

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

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