تتيح "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" في Unity لمطوّري Unity عرض إعلانات Google على الأجهزة الجوّالة في تطبيقات Android وiOS بدون الحاجة إلى كتابة رمز Java أو Objective-C. توفّر حزمة تطوير البرامج (SDK) واجهة C# لطلب الإعلانات تستخدمها نصوص C# البرمجية في مشروع Unity.
هذا الدليل مخصّص للناشرين الذين يريدون تحقيق الربح من تطبيق Unity.
المتطلبات الأساسية
- استخدام Unity Editor 2019.4 أو إصدار أحدث
- للنشر على iOS:
- Xcode 16.0 أو إصدار أحدث
- استهداف iOS 13.0 أو إصدار أحدث
- CocoaPods
- للنشر على Android:
- المستوى 23 من واجهة برمجة التطبيقات (API) في Android أو مستوى أعلى
- استهداف المستوى 35 من واجهة برمجة التطبيقات (API) في Android أو مستوى أعلى
يتم ضبط مستوى واجهة برمجة التطبيقات (API) في Android في إعدادات المشروع (Project Settings) > مشغّل الوسائط (Player) > Android > إعدادات أخرى (Other Settings) > إعدادات أخرى (Other Settings).
استيراد "حزمة تطوير البرامج (SDK) لإعلانات 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
- افتح إعدادات مدير الحزم من خلال النقر على خيار قائمة Unity تعديل (Edit) > إعدادات المشروع (Project Settings) > مدير الحزم (Package Manager).
أضِف OpenUPM كسجلّ ضمن نطاق إلى نافذة "مدير الحزم":
Name: OpenUPM URL: https://package.openupm.com Scopes: com.googleافتح قائمة مدير الحزم من خلال النقر على خيار قائمة Unity نافذة (Window) > مدير الحزم (Package Manager).
اضبط القائمة المنسدلة لنطاق المدير على سجلّاتي (My Registries).
اختَر حزمة حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة في Unity من قائمة الحزم، ثم انقر على تثبيت (Install).
إزالة مواد عرض المكوّن الإضافي .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
- نزِّل أحدث
.unitypackageإصدار من GitHub. - استورِد ملف
.unitypackageمن خلال النقر على خيار قائمة Unity مواد العرض (Assets) > استيراد حزمة (Import package) > حزمة مخصّصة (Custom Package) واستيراد جميع العناصر.
ضبط معرّف تطبيقك على AdMob
في محرر Unity، انقر على مواد العرض (Assets) > إعلانات Google على الأجهزة الجوّالة (Google Mobile Ads) > الإعدادات (Settings) من القائمة.
أدخِل معرّف تطبيقك على AdMob لنظامَي Android وiOS في كل حقل.
إعداد حزمة تطوير البرامج (SDK)
قبل تحميل الإعلانات، اطلب من تطبيقك إعداد Google Mobile Ads Unity Plugin من خلال
استدعاء MobileAds.Initialize(). يجب إجراء ذلك مرة واحدة فقط، ويُفضّل أن يكون ذلك عند فتح التطبيق.
في ما يلي مثال على كيفية استدعاء 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
});
إذا كنت تستخدم التوسّط، انتظِر إلى أن يتم تنفيذ معاودة الاتصال قبل تحميل الإعلانات للتأكّد من إعداد جميع محوّلات التوسّط.
اختيار شكل الإعلان
تمت الآن إضافة Google Mobile Ads Unity Plugin إلى تطبيق Unity عند النشر على منصة Android أو iOS. أنت الآن مستعد لعرض إعلان. تقدّم AdMob عددًا من أشكال الإعلانات المختلفة، لذا يمكنك اختيار الشكل الذي يوفّر أفضل تجربة للمستخدم.
بانر
تعرض الوحدات الإعلانية لإعلانات بانر إعلانات مستطيلة تشغل جزءًا من تصميم التطبيق. ويمكن تحديثها تلقائيًا بعد فترة زمنية معيّنة. وهذا يعني أنّ المستخدِمين سيشاهدون إعلانًا جديدًا على فترات زمنية منتظمة، حتى إذا ظلّوا على الشاشة نفسها في تطبيقك. ويُعدّ هذا الشكل أبسط أشكال الإعلانات التي يمكن تنفيذها.
إعلان بيني
تعرض وحدات الإعلانات البينية إعلانات بملء الصفحة داخل تطبيقك. ويمكنك عرض هذه الإعلانات في لحظات التنقّل أو الفواصل التي تحدث بشكلٍ تلقائي في واجهة تطبيقك، على سبيل المثال، بعد اكتمال مستوىً معيّن في لعبة على الأجهزة الجوّالة.
مدمج مع المحتوى
"الإعلانات المدمجة مع المحتوى" هي إعلانات يمكنك تخصيص طريقة عرض مواد العرض فيها، مثل العناوين الرئيسية وعبارات الحث على اتخاذ إجراء في تطبيقاتك. من خلال تصميم الإعلان بنفسك، يمكنك إنشاء عروض إعلانية طبيعية وغير متداخلة يمكن أن تساهم في توفير تجربة مستخدم غنية.
عرض "الإعلانات المدمجة مع المحتوى"
تمت المكافأة
تتيح وحدات "الإعلانات مقابل مكافأة" للمستخدمين تشغيل الألعاب أو المشاركة في استطلاعات أو مشاهدة فيديوهات للحصول على مكافآت داخل التطبيق، مثل الحصول على عملات معدنية أو محاولات إضافية أو نقاط. يمكنك ضبط مكافآت مختلفة لوحدات إعلانية مختلفة، وتحديد قيم المكافأة والعناصر التي حصل عليها المستخدم.
إعلان بيني مقابل مكافأة
"الإعلان البيني مقابل مكافأة" هو نوع جديد من أشكال الإعلانات المحفَّزة التي تتيح لك تقديم مكافآت، مثل العملات المعدنية أو محاولات إضافية للإعلانات التي تظهر تلقائيًا أثناء عمليات النقل العادية للتطبيقات.
على عكس الإعلانات مقابل مكافأة، لا يُطلب من المستخدمين الموافقة على عرض إعلان بيني بمكافأة.
وبدلاً من رسالة طلب الموافقة داخل "الإعلانات مقابل مكافأة"، تتطلّب "الإعلانات البينية مقابل مكافأة" شاشة تمهيدية تُعلن عن المكافأة وتمنح المستخدمين فرصة للإيقاف إذا أرادوا إجراء ذلك.
عرض "الإعلانات البينية مقابل مكافأة"
إعلان على شاشة فتح التطبيق
"إعلان على شاشة فتح التطبيق" هو شكل إعلان يظهر عندما يفتح المستخدمون تطبيقك أو يعودون إليه مرة أخرى. يظهر الإعلان على شاشة التحميل.
عرض "الإعلانات على شاشة فتح التطبيق"