هذا الدليل مخصّص للناشرين الذين يريدون تحقيق الربح من تطبيق Flutter.
يُعدّ دمج حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في تطبيق Flutter، وهو ما يمكنك تنفيذه هنا، الخطوة الأولى نحو عرض إعلانات AdMob وتحقيق الأرباح. وبعد اكتمال عملية الدمج، يمكنك اختيار أحد أشكال الإعلانات للحصول على خطوات تنفيذ مفصّلة.
تتيح حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لنظام Flutter حاليًا تحميل وعرض إعلانات البانر والإعلانات البينية (بملء الشاشة) والإعلانات المدمجة مع المحتوى والإعلانات التي تضم مكافآت.
المتطلبات الأساسية
- Flutter 1.22.0 أو إصدار أحدث
- على Android
- الإصدار 3.2 من "استوديو Android" أو إصدار أحدث
- استهداف المستوى 20 أو أعلى من واجهة برمجة التطبيقات لنظام التشغيل Android
- ضبط
compileSdkVersion
على 28 أو أعلى
- iOS
- أحدث إصدار من Xcode مع أدوات سطر الأوامر المفعَّلة
- إجراء مقترَح: إنشاء حساب AdMob وتسجيل تطبيق Android و/أو iOS
استيراد حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة
- أدرِج مكوّن "Google Mobile Ads SDK" لتطبيق Flutter في مشروع 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
، أدخِل رقم تعريف تطبيق AdMob بين علامتَي اقتباس على النحو الموضّح:
<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
وإعداد ملف تعريف IDE
للتطبيق.
iOS
تعديل ملف Info.plist
في ملف ios/Runner/Info.plist
لتطبيقك، أضِف مفتاح GADApplicationIdentifier
مع قيمة سلسلة لمعرّف تطبيق AdMob، كما هو محدّد في واجهة ويب AdMob:
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>
يجب ضبط القيمة نفسها عند بدء تشغيل المكوّن الإضافي في رمز Dart.
اطّلِع على دليل iOS للحصول على مزيد من
المعلومات عن ضبط Info.plist
وإعداد رقم تعريف تطبيقك.
إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات للأجهزة الجوّالة
قبل تحميل الإعلانات، اطلب من تطبيقك إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة من خلال استدعاء MobileAds.instance.initialize()
التي تهيئ حزمة SDK وتُرجع Future
التي تنتهي بعد اكتمال الإعداد أو بعد مهلة Future
تبلغ 30 ثانية. يجب إجراء ذلك مرة واحدة فقط، ويُفضَّل قبل تشغيل التطبيق مباشرةً.
import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:flutter/material.dart';
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize();
runApp(MyApp());
}
class MyApp extends StatefulWidget {
@override
MyAppState createState() => MyAppState();
}
class MyAppState extends State<MyApp> {
@override
void initState() {
super.initState();
// Load ads.
}
}
اختيار شكل الإعلان
ستكون جاهزًا لتنفيذ أي إعلان بعد استيراد حزمة SDK لعرض الإعلانات على الأجهزة الجوّالة. تقدّم AdMob عددًا من أشكال الإعلانات المختلفة، بحيث يمكنك اختيار الشكل الذي يليكم بأفضل شكل مع تجربة المستخدم في تطبيقك.
بانر
إعلانات مستطيلة تظهر في أعلى أو أسفل شاشة الجهاز تبقى إعلانات البانر معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن إعادة تحميلها تلقائيًا بعد فترة زمنية معيّنة. إذا كنت مبتدئًا في مجال الإعلانات على الأجهزة المتحرّكة، يمكنك البدء باستخدام هذه الإعلانات.
إعلان بيني
الإعلانات التي تظهر بملء الشاشة وتغطي واجهة التطبيق إلى أن يغلقها المستخدم ومن الأفضل استخدامها في فواصل عرض طبيعية خلال مسار تنفيذ التطبيق، مثلاً بين مستويات لعبة أو بعد إكمال مهمة مباشرةً.
مدمجة مع المحتوى
إعلانات قابلة للتخصيص تتوافق مع شكل تطبيقك وأسلوبه. ويمكنك اختيار كيفية وضعها ومكانها، بحيث يصبح التنسيق أكثر اتساقًا مع تصميم تطبيقك.
تم منح المكافأة
هي إعلانات تكافئ المستخدمين على مشاهدة فيديوهات قصيرة وتفاعلهم مع الاستطلاعات وإعلانات تشغيل إصدار بسيط من اللعبة. وهذه الإعلانات مناسبة لتحقيق الربح من المستخدمين الذين يشغّلون الألعاب المجانية.