البدء

يتيح مكوّن 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 > إعدادات أخرى > إعدادات أخرى

استيراد المكوّن الإضافي لإعلانات Mobile Ads for 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. مواد العرض > استيراد الحزمة > حزمة مخصصة واستيراد جميع العناصر.

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

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

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

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

Android

انتقِل إلى Project Settings (إعدادات المشروع) > اللاعب > Android > إعدادات النشر > إنشاء وحدد:

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

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

iOS

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

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

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

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

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

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

قبل تحميل الإعلانات، يجب أن يُعِدّ تطبيقك حزمة SDK لإعلانات Google على الأجهزة الجوّالة عن طريق يَتِمُّ الْآنَ الِاتِّصَالْ بِـ MobileAds.Initialize(). يجب القيام بذلك مرة واحدة فقط، من الناحية المثالية في إطلاق التطبيق.

تحذير: يمكن تحميل الإعلانات مسبقًا من خلال "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" أو شريك التوسّط. حِزم تطوير البرامج (SDK) عند الاتصال بالرقم MobileAds.Initialize(). إذا كنت بحاجة إلى الحصول على موافقة من للمستخدمين في المنطقة الاقتصادية الأوروبية، يجب وضع أي علامات خاصة بالطلب، مثل كـ 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 تقدم عددًا من أشكال الإعلانات المختلفة، لذا يمكنك اختيار الشكل الذي للحصول على أفضل تجربة للمستخدم.

بانر

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

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

إعلان بيني

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

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

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

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

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

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

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

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