هذا الدليل مخصَّص للناشرين الذين يريدون تحقيق الربح من تطبيق Flutter.
إنّ دمج حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في تطبيق Flutter، وهو ما ستنفّذه هنا، هو الخطوة الأولى لعرض إعلانات "مدير الإعلانات" وتحقيق الأرباح. وبعد اكتمال عملية الدمج، يمكنك اختيار أحد أشكال الإعلانات للحصول على خطوات تنفيذ تفصيلية.
في الوقت الحالي، تتيح حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في Flutter تحميل وعرض "إعلانات البانر" و"الإعلانات البينية (في وضع ملء الشاشة)" و"الإعلانات المدمجة مع المحتوى" و"الإعلانات التي تضم مكافأة".
المتطلّبات الأساسية
- Flutter 1.22.0 أو إصدار أحدث
- على Android
- الإصدار 3.2 من "استوديو Android" أو إصدار أحدث
- استهداف المستوى 20 أو أعلى لواجهة برمجة تطبيقات Android
- اضبط السمة
compileSdkVersion
على 28 أو أعلى.
- iOS
- أحدث إصدار من Xcode مع أدوات سطر أوامر مفعّلة
استيراد حزمة SDK لإعلانات الأجهزة الجوّالة
- ضمِّن حزمة SDK لإعلانات Google على الأجهزة الجوّالة لبرنامج Flutter الإضافي في مشروع Flutter
الإعداد الخاص بالنظام الأساسي
Android
تحديث ملف AndroidManifest.xml
يجب تضمين رقم تعريف تطبيق "مدير الإعلانات" في AndroidManifest.xml
.
ويؤدي عدم الالتزام بذلك إلى حدوث عطل عند تشغيل التطبيق.
أضِف رقم تعريف تطبيق "مدير إعلانات Google" (الذي يتم تحديده في واجهة مستخدم "مدير الإعلانات") إلى ملف android/app/src/main/AndroidManifest.xml
الخاص بالتطبيق من خلال إضافة علامة <meta-data>
بالاسم
com.google.android.gms.ads.APPLICATION_ID
. يمكنك العثور على رقم تعريف التطبيق
في واجهة مستخدم "مدير الإعلانات" بالنسبة إلى android:value
، أدخِل رقم تعريف تطبيق "مدير الإعلانات"
بين علامتَي اقتباس كما هو موضّح:
<manifest> <application> <!-- Sample 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
مع قيمة سلسلة لرقم تعريف تطبيق "مدير الإعلانات" (الذي يتم تحديده في
واجهة مستخدم "مدير الإعلانات"):
<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 لإعلانات الأجهزة الجوّالة، وأنت الآن جاهز لتنفيذ أي إعلان. يوفّر "مدير الإعلانات" عددًا من أشكال الإعلانات المختلفة، ما يتيح لك اختيار الشكل الذي يناسب تجربة المستخدم في تطبيقك على أفضل نحو.
بانر
إعلانات مستطيلة تظهر في أعلى شاشة الجهاز أو أسفلها تبقى إعلانات البانر على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن إعادة تحميلها تلقائيًا بعد فترة زمنية معيّنة. إذا كنت حديث العهد بإعلانات الجوّال، فإنها مكان رائع للبدء.
إعلان بيني
إعلانات ملء الشاشة التي تغطي واجهة أحد التطبيقات إلى أن يغلقها المستخدم من الأفضل استخدامها عند فترات التوقف الطبيعية أثناء تنفيذ التطبيق، كما هو الحال بين مستويات اللعبة أو بعد إكمال مهمة مباشرةً.
مدمجة مع المحتوى
إعلانات قابلة للتخصيص تتطابق مع شكل تطبيقك ومضمونه. يمكنك تحديد طريقة وضعها ومكان وضعها، بحيث يكون التصميم أكثر اتساقًا مع تصميم تطبيقك.
تم منح المكافأة
هي إعلانات تمنح المستخدمين مكافآت مقابل مشاهدة مقاطع فيديو قصيرة والتفاعل مع إعلانات تشغيل إصدار بسيط من اللعبة واستطلاعات الرأي. وهذه الإعلانات مناسبة لتحقيق الربح من مستخدمي الألعاب المجانية.