يُعدّ دمج حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في تطبيق Flutter الخطوة الأولى نحو عرض الإعلانات وتحقيق الإيرادات. بعد دمج حزمة تطوير البرامج (SDK)، يمكنك المتابعة لتنفيذ شكل واحد أو أكثر من أشكال الإعلانات المتوافقة.
المتطلبات الأساسية
- الإصدار 3.27.0 من Flutter أو إصدار أحدث
- Android
- أحدث إصدار من "استوديو Android"
- iOS
- أحدث إصدار من Xcode مع تفعيل أدوات سطر الأوامر
استيراد حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة
- ضمِّن مكوّن Google Mobile Ads SDK الإضافي لتطبيق 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 Ad Manager 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 الذي ينتهي بعد اكتمال عملية الإعداد أو بعد انتهاء المهلة البالغة 30 ثانية. يجب الاتصال بالرقم initialize()
في أقرب وقت ممكن.
// Initialize the Mobile Ads SDK.
MobileAds.instance.initialize();
اختيار شكل إعلان
بعد استيراد "حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة"، ستكون مستعدًا لعرض إعلان. يوفّر "مدير إعلانات Google" عددًا من أشكال الإعلانات المختلفة، ما يتيح لك اختيار الشكل الأنسب لتجربة المستخدم في تطبيقك.
بانر
إعلانات مستطيلة تظهر في أعلى شاشة الجهاز أو أسفلها تبقى إعلانات البانر معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن إعادة تحميلها تلقائيًا بعد فترة زمنية محدّدة. إذا كنت جديدًا في مجال الإعلانات على الأجهزة الجوّالة، ستكون هذه الإعلانات خيارًا رائعًا للبدء.
إعلان بيني
إعلانات بملء الشاشة تغطي واجهة التطبيق إلى أن يغلقها المستخدم ويُفضّل استخدامها عند التوقف مؤقتًا بشكل طبيعي أثناء تنفيذ التطبيق، مثلاً بين مستويات اللعبة أو بعد إكمال مهمة مباشرةً.
مدمجة مع المحتوى
إعلانات قابلة للتخصيص تتوافق مع شكل تطبيقك وأسلوبه، وتتيح لك تحديد كيفية وضعها ومكانها، بحيث يصبح التنسيق أكثر اتساقًا مع تصميم تطبيقك.
تم منح المكافأة
هي إعلانات تكافئ المستخدمين على مشاهدة فيديوهات قصيرة وتفاعلهم مع "إعلانات تشغيل إصدار بسيط من اللعبة" ومع الاستطلاعات. وهذه الإعلانات مناسبة لتحقيق الربح من المستخدمين الذين يشغّلون الألعاب المجانية.