البدء

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

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

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

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

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

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

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

OpenUPM-CLI

إذا كان واجهة برمجة التطبيقات OpenUPM مثبّتة، يمكنك تثبيت قاعدة بيانات المسجّلين في 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 Mobile Ads for 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 من جيت هب.
2. يجب استيراد ملف .unitypackage من خلال تحديد خيار قائمة Unity. مواد العرض > استيراد الحزمة > حزمة مخصصة واستيراد جميع العناصر.

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

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

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

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

Android

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

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

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

iOS

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

بانر

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

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

إعلان بيني

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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