البدء

يتيح مكوّن 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

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

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

OpenUPM-CLI

إذا كان لديك OpenUPM CLI يمكنك تثبيت سِجلّ OpenUPM باستخدام ما يلي :

openupm add com.google.ads.mobile

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

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

  • Assets/ExternalDependencyManager
  • مواد العرض/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 Mobile Ads for Unity من قائمة الحزم ثم اضغط على تثبيت

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

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

  • Assets/ExternalDependencyManager
  • مواد العرض/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 من جيت هب.
  2. يجب استيراد ملف .unitypackage من خلال تحديد خيار قائمة Unity. مواد العرض > استيراد الحزمة > حزمة مخصصة واستيراد جميع العناصر.

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

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

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

Android

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

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

في محرِّر Unity، اختَر مواد العرض >. مدير التبعية الخارجية > جهاز Android المحلل > إرسال طلب للحصول على مكتبة مدير التبعية الخارجية في Unity نسخ التبعيات المعلَن عنها إلى الدليل 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(). يجب القيام بذلك مرة واحدة فقط، من الناحية المثالية في إطلاق التطبيق.

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

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

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

إعلان بيني

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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