البدء

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

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

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

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

يتم ضبط مستوى واجهة برمجة التطبيقات لنظام التشغيل 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 من GitHub.
2. استورِد ملف .unitypackage من خلال اختيار خيار قائمة Unity التالي: مواد العرض > استيراد حزمة > حزمة مخصّصة واستيراد جميع العناصر.

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

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

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

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

Android

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

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

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

iOS

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

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

ضبط Ad Manager رقم تعريف التطبيق

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

أدخِل على نظامَي التشغيل Android وiOS رقم تعريف تطبيق "مدير إعلانات Google" في كل حقل.

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

بانر

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

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

إعلان بيني

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

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

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

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

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

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

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

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