هذا الدليل مخصَّص للناشرين الذين يريدون تحقيق الربح من تطبيق 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 لإعلانات الأجهزة الجوّالة
- ضمِّن حزمة SDK لإعلانات Google على الأجهزة الجوّالة لبرنامج 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
وإعداد رقم تعريف التطبيق.
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
رسالة تنتهي عند اكتمال الإعداد أو بعد مهلة مدتها 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 عددًا من أشكال الإعلانات المختلفة، حتى يمكنك اختيار الشكل الذي يناسب تجربة مستخدم تطبيقك.
بانر
إعلانات مستطيلة تظهر في أعلى شاشة الجهاز أو أسفلها تبقى إعلانات البانر على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن إعادة تحميلها تلقائيًا بعد فترة زمنية معيّنة. إذا كنت حديث العهد بإعلانات الجوّال، فإنها مكان رائع للبدء.
إعلان بيني
إعلانات ملء الشاشة التي تغطي واجهة أحد التطبيقات إلى أن يغلقها المستخدم من الأفضل استخدامها عند فترات التوقف الطبيعية أثناء تنفيذ التطبيق، كما هو الحال بين مستويات اللعبة أو بعد إكمال مهمة مباشرةً.
مدمجة مع المحتوى
إعلانات قابلة للتخصيص تتطابق مع شكل تطبيقك ومضمونه. يمكنك تحديد طريقة وضعها ومكان وضعها، بحيث يكون التصميم أكثر اتساقًا مع تصميم تطبيقك.
تم منح المكافأة
هي إعلانات تمنح المستخدمين مكافآت مقابل مشاهدة مقاطع فيديو قصيرة والتفاعل مع إعلانات تشغيل إصدار بسيط من اللعبة واستطلاعات الرأي. وهذه الإعلانات مناسبة لتحقيق الربح من مستخدمي الألعاب المجانية.