إنّ دمج 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
يجب تضمين معرّف تطبيق AdMob في ملف AndroidManifest.xml.
وسيؤدي عدم إجراء ذلك إلى تعطُّل التطبيق عند تشغيله.
أضِف معرّف تطبيق AdMob، كما
هو محدّد في واجهة ويب AdMob،
إلى ملف android/app/src/main/AndroidManifest.xml الخاص بالتطبيق من خلال إضافة علامة
<meta-data> بالاسم com.google.android.gms.ads.APPLICATION_ID.
بالنسبة إلى android:value، أدخِل معرّف تطبيقك الخاص بين علامتَي اقتباس كما هو موضّح أدناه:
<manifest>
<application>
<!-- Sample AdMob 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 البرمجي.
راجِع دليل Android لمزيد من المعلومات عن إعداد AndroidManifest.xml وإعداد معرّف التطبيق.
iOS
تعديل Info.plist
في ملف ios/Runner/Info.plist الخاص بتطبيقك، أضِف مفتاح GADApplicationIdentifier بقيمة سلسلة تمثّل معرّف تطبيق يستخدم AdMob، كما هو محدّد في واجهة ويب AdMob:
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>
عليك تمرير القيمة نفسها عند إعداد المكوّن الإضافي في رمز Dart البرمجي.
راجِع الـ
دليل الخاص بنظام iOS
لمزيد من المعلومات عن إعداد Info.plist وإعداد معرّف التطبيق.
إعداد 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، يمكنك تنفيذ إعلان. تقدّم AdMob عددًا من أشكال الإعلانات المختلفة، ما يتيح لك اختيار الشكل الذي يناسب تجربة المستخدم في تطبيقك على أفضل نحو.
بانر
إعلانات مستطيلة تظهر في أعلى شاشة الجهاز أو أسفلها. تبقى "إعلانات البانر" معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن إعادة تحميلها تلقائيًا بعد فترة زمنية محدّدة. إذا كنت تستخدم الإعلانات على الأجهزة الجوّالة لأول مرة، فهذه الإعلانات هي نقطة بداية رائعة.
إعلان بيني
إعلانات بملء الشاشة تغطي واجهة التطبيق إلى أن يغلقها المستخدم. من الأفضل استخدامها في نقاط التوقف الطبيعية في مسار تنفيذ التطبيق، مثلاً بين مستويَين في لعبة أو بعد إكمال مهمة مباشرةً.
مدمج مع المحتوى
إعلانات قابلة للتخصيص تتطابق مع شكل تطبيقك وأسلوبه. يمكنك تحديد كيفية وضعها ومكانها، بحيث يصبح التنسيق أكثر اتساقًا مع تصميم تطبيقك.
تمت المكافأة
إعلانات تمنح مكافآت للمستخدمين مقابل مشاهدة فيديوهات قصيرة والتفاعل مع "إعلانات تشغيل إصدار بسيط من اللعبة" والاستطلاعات. وهذه الإعلانات مناسبة لتحقيق الربح من المستخدمين الذين يشغّلون الألعاب المجانية.