البدء

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

إن دمج المكوّن الإضافي Google Mobile Ads Unity في أحد التطبيقات، والذي ستفعله هنا، هو الخطوة الأولى نحو عرض إعلانات AdMob وتحقيق الأرباح. وبعد اكتمال الدمج، يمكنك اختيار شكل إعلان (مثل إعلان فيديو مدمج مع المحتوى أو إعلان بمكافأة) للحصول على خطوات تنفيذ تفصيلية.

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

• استخدام إصدار Unity 2019 أو إصدار أحدث
• للنشر على iOS
  • الإصدار Xcode 13.2.1 أو إصدار أحدث
  • CocoaPods
• للنشر على Android
  • "خدمات Google Play" الإصدار 18.1.0 أو إصدار أحدث
  • استهداف المستوى 16 من واجهة برمجة تطبيقات Android أو مستوى أعلى
• ننصحك بـ: إنشاء حساب AdMob وتسجيل تطبيق Android و/أو iOS

تنزيل المكوّن الإضافي Unity Ads Unity

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

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

تنزيل المكون عرض المصدر

استيراد المكوّن الإضافي Unity لإعلانات الجوّال

افتح مشروعك في محرر Unity. حدد مواد العرض > استيراد الحزمة > الحزمة المخصصة وابحث عن ملف GoogleMobileAdsPlugin.unitypackage الذي نزلته.

تأكد من تحديد جميع الملفات وانقر على استيراد.

تضمين حزمة SDK لإعلانات الأجهزة الجوّالة

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

اتّبع الخطوات الواردة أدناه لضمان احتواء مشروعك على حزمة SDK لإعلانات الأجهزة الجوّالة.

Android

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

ملاحظة: يتم إدراج تبعيات المكوّن الإضافي Google Mobile Ads Unity في Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml

iOS

لا يلزم اتخاذ أي خطوات إضافية لتضمين حزمة SDK لإعلانات الجوّال في مشروع Unity.

ملاحظة: يتم تحديد تبعيات iOS باستخدام CocoaPods. يتم تشغيل CocoaPods كخطوة عملية ما بعد الإنشاء.

• عند استخدام Unity 5.6 والإصدارات الأحدث، يتم إنشاء xcworkspace يتضمن مكتبات التبعية المطلوبة. استخدم xcworkspace الذي تم إنشاؤه بدلاً من مشروع Xcode القياسي.
• عند استخدام الإصدارات القديمة من Unity، يتم تضمين التبعيات في مشروع Xcode القياسي.

تعيين رقم تعريف تطبيق AdMob

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

أدخل رقم تعريف تطبيق AdMob وAndroid في كل حقل.

تهيئة حزمة SDK لإعلانات الجوّال

قبل تحميل الإعلانات، يجب إعداد حزمة SDK لإعلانات الأجهزة الجوّالة من خلال الاتصال. MobileAds.Initialize() يجب تنفيذ هذا الإجراء مرة واحدة فقط، ويُفضَّل عند تشغيل التطبيق.

تحذير: قد يتم تحميل الإعلانات مسبقًا بواسطة حزمة SDK لإعلانات الأجهزة الجوّالة أو حزم SDK لشركاء التوسّط عند الاتصال بـ MobileAds.initialize(). إذا كنت بحاجة إلى الحصول على موافقة من المستخدمين في المنطقة الاقتصادية الأوروبية (EEA)، يمكنك ضبط أي علامات خاصة بالطلب (مثل tagForChildDirectedTreatment أو tag_for_under_age_of_consent)، أو اتّخاذ إجراء آخر قبل تحميل الإعلانات، تأكَّد من إجراء ذلك قبل إعداد حزمة SDK لإعلانات الأجهزة الجوّالة.

في ما يلي مثال على كيفية استدعاء Initialize() في طريقة Start() من نص برمجي تم إرفاقه GameObject:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

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

اختيار شكل الإعلان

يتم الآن تضمين حزمة SDK لإعلانات الجوّال في تطبيق Unity عند النشر على النظام الأساسي Android أو iOS. أنت الآن مستعد لتنفيذ إعلان. يقدم AdMob عددًا من أشكال الإعلانات المختلفة، لذا يمكنك اختيار الشكل الذي يناسب احتياجات المستخدم.

"بانر"

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

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

إعلان بيني

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

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

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

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

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

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

إعلانات الفيديو بمكافأة هي إعلانات فيديو بملء الشاشة يتوفّر للمستخدمين خيار مشاهدتها بالكامل مقابل مكافآت داخل التطبيق.

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

طلب تفويض شفافية تتبُّع التطبيقات

لعرض طلب تفويض شفافية تتبُّع التطبيقات (ATT) للوصول إلى معرّف المعلِنين (IDFA)، استخدِم حزمة دعم الإعلانات على نظام التشغيل iOS 14 في Unity.

مفتاح التطبيق نفسه

المتطلبات الأساسية: الإصدار 6.1.0 من المكوِّن الإضافي Unity من "إعلانات Google للأجهزة الجوّالة" أو إصدار أحدث

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

يتم تمكين مفتاح التطبيق نفسه بشكل افتراضي، ولكن يمكنك تعطيله باستخدام واجهة برمجة التطبيقات التالية:

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }