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