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