هذا الدليل مخصّص للناشرين الذين يريدون تحقيق الربح من تطبيق Flutter.
يُعدّ دمج حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في تطبيق Flutter، وهو ما يمكنك تنفيذه هنا، الخطوة الأولى نحو عرض إعلانات "مدير إعلانات Google" وتحقيق الأرباح. بعد اكتمال عملية الدمج، يمكنك اختيار شكل إعلان للحصول على خطوات تنفيذ مفصلة.
في الوقت الحالي، تتيح حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في Flutter تحميل وعرض إعلانات البانر والإعلانات البينية (ملء الشاشة) والإعلانات المدمجة مع المحتوى والإعلانات التي تضم مكافأة.
المتطلبات الأساسية
- Flutter 1.22.0 أو إصدار أحدث
- Android
- الإصدار 3.2 من "استوديو Android" أو إصدار أحدث
- استهداف المستوى 20 أو أعلى من واجهة برمجة التطبيقات لنظام التشغيل Android
- اضبط السمة
compileSdkVersion
على 28 أو أعلى.
- أجهزة iOS
- أحدث إصدار من Xcode مع أدوات سطر الأوامر المفعَّلة
استيراد حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة
- أدرِج مكوّن "Google Mobile Ads SDK" لتطبيق Flutter في مشروع Flutter .
الإعداد الخاص بالنظام الأساسي
Android
تعديل ملف AndroidManifest.xml
يجب تضمين معرّف تطبيق "مدير إعلانات Google" في 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
يحتوي على قيمة سلسلة لمعرّف
تطبيقك على "مدير إعلانات Google" (يتم تحديده في
واجهة مستخدم "مدير إعلانات Google"):
<key>GADApplicationIdentifier</key> <string>ca-app-pub-################~##########</string>
يجب ضبط القيمة نفسها عند بدء تشغيل المكوّن الإضافي في ملف Dart الترميز.
اطّلِع على دليل iOS
لمزيد من المعلومات عن ضبط Info.plist
وإعداد
رقم تعريف تطبيقك.
إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة
قبل تحميل الإعلانات، اطلب من تطبيقك إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة من خلال استدعاء MobileAds.instance.initialize()
، ما يؤدي إلى إعداد حزمة SDK وإرجاع Future
الذي ينتهي بعد اكتمال عملية الإعداد (أو بعد Future
ثانية). يجب إجراء ذلك مرة واحدة فقط، ومن الأفضل أن يتم ذلك قبل تشغيل التطبيق مباشرةً.
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 لعرض الإعلانات على الأجهزة الجوّالة، وأصبحت مستعدًا لعرض إعلان. يوفّر "مدير الإعلانات" عددًا من أشكال الإعلانات المختلفة، بحيث يمكنك اختيار الشكل الذي يليه بأفضل شكل تجربة المستخدم في تطبيقك.
بانر
إعلانات مستطيلة تظهر في أعلى أو أسفل شاشة الجهاز تبقى إعلانات البانر معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن إعادة تحميلها تلقائيًا بعد فترة زمنية معيّنة. إذا كنت مبتدئًا في مجال الإعلانات على الأجهزة المتحرّكة، يمكنك البدء باستخدام هذه الإعلانات.
إعلان بيني
الإعلانات التي تظهر بملء الشاشة وتغطي واجهة التطبيق إلى أن يغلقها المستخدم ومن الأفضل استخدامها في فواصل عرض طبيعية خلال مسار تنفيذ التطبيق، مثلاً بين مستويات لعبة أو بعد إكمال مهمة مباشرةً.
مدمجة مع المحتوى
إعلانات قابلة للتخصيص تتوافق مع شكل تطبيقك وأسلوبه. ويمكنك اختيار كيفية وضعها ومكانها، بحيث يصبح التنسيق أكثر اتساقًا مع تصميم تطبيقك.
تم منح المكافأة
هي إعلانات تكافئ المستخدمين على مشاهدة فيديوهات قصيرة وتفاعلهم مع الاستطلاعات وإعلانات تشغيل إصدار بسيط من اللعبة. وهذه الإعلانات مناسبة لتحقيق الربح من المستخدمين الذين يشغّلون الألعاب المجانية.