إنّ دمج Google Mobile Ads Flutter Plugin في تطبيق Flutter هو الخطوة الأولى نحو عرض الإعلانات وتحقيق الإيرادات. بعد دمج Google Mobile Ads Flutter Plugin، يمكنك تنفيذ شكل إعلان واحد أو أكثر من أشكال الإعلانات المتاحة.
المتطلبات الأساسية
- Flutter 3.38.1 أو إصدار أحدث
- Android
- أحدث إصدار من "استوديو Android"
- iOS
- أحدث إصدار من Xcode مع تفعيل أدوات سطر الأوامر
استيراد Google Mobile Ads Flutter Plugin
- يمكنك تضمين Google Mobile Ads Flutter Plugin في مشروع Flutter.
الإعداد الخاص بالنظام الأساسي
Android
تعديل AndroidManifest.xml
يجب تضمين معرّف تطبيق "مدير الإعلانات" في ملف AndroidManifest.xml.
وسيؤدي عدم إجراء ذلك إلى تعطُّل التطبيق عند تشغيله.
أضِف معرّف تطبيق "مدير الإعلانات"، كما
هو محدّد في واجهة الويب الخاصة بـ "مدير الإعلانات"،
إلى ملف android/app/src/main/AndroidManifest.xml الخاص بالتطبيق من خلال إضافة علامة
<meta-data> بالاسم com.google.android.gms.ads.APPLICATION_ID.
بالنسبة إلى android:value، أدخِل معرّف تطبيقك الخاص بين علامتَي اقتباس كما هو موضّح أدناه:
<manifest>
<application>
<!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
<meta-data
android:name="com.google.android.gms.ads.APPLICATION_ID"
android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
<application>
<manifest>
استخدِم value نفسها عند إعداد المكوّن الإضافي في رمز Dart البرمجي.
لمزيد من المعلومات عن إعداد AndroidManifest.xml وإعداد
معرّف التطبيق، يُرجى الاطّلاع على
دليل Android.
iOS
تعديل Info.plist
في ملف ios/Runner/Info.plist الخاص بتطبيقك، أضِف مفتاح GADApplicationIdentifier
بقيمة سلسلة تمثّل معرّف تطبيق "مدير الإعلانات"، كما هو
محدّد في واجهة الويب الخاصة بـ "مدير الإعلانات":
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>
يجب تمرير القيمة نفسها عند إعداد المكوّن الإضافي في رمز Dart البرمجي.
لمزيد من المعلومات عن إعداد Info.plist وإعداد معرّف التطبيق، يُرجى الاطّلاع على دليل
iOS.
إعداد Google Mobile Ads Flutter Plugin
قبل تحميل الإعلانات، يجب أن يُعدّ تطبيقك Google Mobile Ads Flutter Plugin من خلال استدعاء
MobileAds.instance.initialize()
الذي يُعدّ Google Mobile Ads Flutter Plugin ويعرض Future يكتمل بعد اكتمال الإعداد أو بعد انتهاء مهلة مدتها 30 ثانية. استدعِ initialize() في أقرب وقت ممكن.
// Initialize the Mobile Ads SDK.
MobileAds.instance.initialize();
اختيار شكل الإعلان
بعد استيراد Google Mobile Ads Flutter Plugin، يمكنك تنفيذ إعلان. يوفّر "مدير الإعلانات" عددًا من أشكال الإعلانات المختلفة، ما يتيح لك اختيار الشكل الذي يناسب تجربة المستخدم في تطبيقك على أفضل نحو.
بانر
إعلانات مستطيلة تظهر في أعلى شاشة الجهاز أو أسفلها. تبقى إعلانات البانر معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن إعادة تحميلها تلقائيًا بعد فترة زمنية محدّدة. إذا كنت تستخدم الإعلانات على الأجهزة الجوّالة لأول مرة، فإنّ "إعلانات البانر" هي نقطة بداية رائعة.
إعلان بيني
إعلانات بملء الشاشة تغطي واجهة التطبيق إلى أن يغلقها المستخدم. من الأفضل استخدامها في نقاط التوقف الطبيعية في مسار تنفيذ التطبيق، مثلاً بين مستويَين في لعبة أو بعد إكمال مهمة مباشرةً.
مدمج مع المحتوى
إعلانات قابلة للتخصيص تتطابق مع شكل تطبيقك وأسلوبه. يمكنك تحديد كيفية وضعها ومكانها، بحيث يصبح التنسيق أكثر اتساقًا مع تصميم تطبيقك.
تمت المكافأة
إعلانات تمنح مكافآت للمستخدمين مقابل مشاهدة فيديوهات قصيرة والتفاعل مع "إعلانات تشغيل إصدار بسيط من اللعبة" والاستطلاعات. وهذه الإعلانات مناسبة لتحقيق الربح من المستخدمين الذين يشغّلون الألعاب المجانية.