هذا الدليل مخصّص للناشرين الذين يريدون تحقيق الربح من تطبيق Flutter.
إنّ دمج حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في تطبيق Flutter، وهو ما يمكنك تنفيذه هنا، هو الخطوة الأولى نحو عرض إعلانات "مدير الإعلانات" وتحقيق الأرباح. وبعد اكتمال الدمج، يمكنك اختيار شكل الإعلان للاطّلاع على خطوات التنفيذ التفصيلية.
تتيح حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لنظام Flutter حاليًا إمكانية تحميل وعرض إعلانات البانر والإعلانات البينية (ملء الشاشة) والإعلانات المدمجة مع المحتوى والإعلانات التي تضم مكافأة.
المتطلبات الأساسية
- Flutter 1.22.0 أو إصدار أحدث
- على Android
- الإصدار 3.2 من "استوديو Android" أو إصدار أحدث
- المستوى 20 أو أعلى لواجهة برمجة تطبيقات Android المستهدَفة
- يجب ضبط
compileSdkVersion
على 28 أو أعلى.
- iOS
- أحدث إصدار من Xcode مع أدوات سطر أوامر مفعّلة
استيراد "حزمة تطوير البرامج (SDK) لعرض إعلانات الأجهزة الجوّالة"
- ضمِّن المكوّن الإضافي حزمة Flutter لإعلانات Google على الأجهزة الجوّالة في مشروع Flutter.
الإعداد الخاص بالنظام الأساسي
Android
تحديث AndroidManifest.xml
يجب تضمين رقم تعريف تطبيق "مدير الإعلانات" في AndroidManifest.xml
.
يؤدي عدم الالتزام بذلك إلى تعطُّل عند تشغيل التطبيق.
أضِف رقم تعريف تطبيق "مدير الإعلانات" (المحدّد في واجهة مستخدم
"مدير الإعلانات") إلى ملف 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 لإعلانات الأجهزة الجوّالة" الآن، وأنت جاهز لتنفيذ أحد الإعلانات. يقدّم "مدير الإعلانات" عددًا من أشكال الإعلانات المختلفة، ما يتيح لك اختيار الشكل الذي يناسب تجربة المستخدم في تطبيقك على أفضل وجه.
بانر
إعلانات مستطيلة تظهر في أعلى شاشة الجهاز أو أسفلها. تبقى إعلانات البانر على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن إعادة تحميلها تلقائيًا بعد فترة زمنية معيّنة. إذا كنت جديدًا في مجال الإعلانات على الأجهزة الجوّالة، فهي مكان رائع للبدء.
إعلان بيني
إعلانات بملء الشاشة تغطي واجهة أحد التطبيقات إلى أن يغلقها المستخدم ومن الأفضل استخدامها في حالات الإيقاف المؤقت الطبيعية أثناء تنفيذ التطبيق، مثلاً بين مستويات اللعبة أو بعد إكمال مهمة ما مباشرةً.
مدمجة مع المحتوى
إعلانات قابلة للتخصيص تُطابق شكل تطبيقك ومضمونه. عليك تحديد كيفية وضعها ومكانها لكي يكون التنسيق أكثر اتساقًا مع تصميم تطبيقك.
تم منح المكافأة
إعلانات تكافئ المستخدمين على مشاهدة فيديوهات قصيرة والتفاعل مع إعلانات تشغيل إصدار بسيط من اللعبة واستطلاعات الرأي وهذه الإعلانات مناسبة لتحقيق الربح من مستخدمي التشغيل المجاني.