البدء

اختيار النظام الأساسي: Android iOS Unity Flutter

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

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

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

• استخدام الإصدار 2019.4 أو إصدار أحدث من Unity Editor
• للنشر على iOS
  • الإصدار 16.0 من Xcode أو إصدار أحدث
  • استهداف الإصدار 12.0 من نظام التشغيل iOS أو الإصدارات الأحدث
  • CocoaPods
• للنشر على Android
  • المستوى 23 من واجهة برمجة تطبيقات Android أو مستوى أعلى
  • استهداف المستوى 34 من واجهة برمجة التطبيقات 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

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

1. نزِّل أحدث إصدار من .unitypackage من GitHub.
2. استورِد ملف .unitypackage من خلال اختيار خيار قائمة Unity Assets > Import package > Custom Package واستيراد جميع العناصر.

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

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

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

اتّبِع الخطوات التالية للتأكّد من أنّ مشروعك يتضمّن جميع التبعيات:

Android

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

• Custom Main Gradle Template
• نموذج خصائص Gradle المخصّصة

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

iOS

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

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

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

في "محرّر Unity"، اختَر مواد العرض > Google Mobile Ads > الإعدادات من القائمة.

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

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

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

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

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

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
GoogleMobileAdsController.cs

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

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

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

بانر

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

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

إعلان بيني

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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