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