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