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