البدء

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

بانر

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

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

إعلان بيني

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

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

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

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

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

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

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

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