إنّ دمج 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
يجب تضمين رقم تعريف تطبيق "مدير إعلانات Google" في ملف AndroidManifest.xml.
وسيؤدي عدم إجراء ذلك إلى تعطُّل التطبيق عند تشغيله.
أضِف رقم تعريف تطبيق "مدير إعلانات Google"، كما هو
محدّد في واجهة الويب الخاصة بـ "مدير إعلانات Google"،
إلى ملف 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 البرمجي.
iOS
تعديل Info.plist
في ملف ios/Runner/Info.plist الخاص بتطبيقك، أضِف مفتاح GADApplicationIdentifier
بقيمة سلسلة تمثّل رقم تعريف تطبيق "مدير إعلانات Google"، كما هو
محدّد في واجهة الويب الخاصة بـ "مدير إعلانات Google":
<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، يمكنك تنفيذ إعلان. يوفّر "مدير إعلانات Google" عددًا من أشكال الإعلانات المختلفة، لذا يمكنك اختيار الشكل الذي يناسب تجربة المستخدم في تطبيقك على أفضل نحو.
بانر
إعلانات مستطيلة تظهر في أعلى شاشة الجهاز أو أسفلها. تبقى "إعلانات البانر" معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن إعادة تحميلها تلقائيًا بعد فترة زمنية محدّدة. إذا كنت تستخدم الإعلانات على الأجهزة الجوّالة لأول مرة، فهذه الإعلانات هي نقطة بداية رائعة.
إعلان بيني
إعلانات بملء الشاشة تغطي واجهة التطبيق إلى أن يغلقها المستخدم. من الأفضل استخدامها في نقاط التوقف الطبيعية في مسار تنفيذ التطبيق، مثلاً بين مستويَين في لعبة أو بعد إكمال مهمة مباشرةً.
مدمج مع المحتوى
إعلانات قابلة للتخصيص تتطابق مع شكل تطبيقك وأسلوبه. يمكنك تحديد كيفية وضعها ومكانها، بحيث يصبح التنسيق أكثر اتساقًا مع تصميم تطبيقك.
تمت المكافأة
إعلانات تمنح مكافآت للمستخدمين مقابل مشاهدة فيديوهات قصيرة والتفاعل مع "إعلانات تشغيل إصدار بسيط من اللعبة" والاستطلاعات. وهذه الإعلانات مناسبة لتحقيق الربح من المستخدمين الذين يشغّلون الألعاب المجانية.