البدء

هذا الدليل مخصّص للناشرين الذين يريدون تحقيق الربح من تطبيق Flutter.

يُعدّ دمج حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في تطبيق Flutter، وهو ما يمكنك تنفيذه هنا، الخطوة الأولى نحو عرض إعلانات AdMob وتحقيق الأرباح. بعد اكتمال عملية الدمج، يمكنك اختيار شكل إعلان للحصول على خطوات تنفيذ تفصيلية.

تتيح حاليًا حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لنظام Flutter تحميل وعرض إعلانات البانر والإعلانات البينية (بملء الشاشة) والإعلانات المدمجة مع المحتوى والإعلانات التي تضم مكافآت.

المتطلبات الأساسية

استيراد حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة

الإعدادات الخاصة بالمنصة

Android

تعديل ملف AndroidManifest.xml

يجب تضمين معرّف تطبيق AdMob في AndroidManifest.xml. يؤدي عدم إجراء ذلك إلى تعطُّل التطبيق عند تشغيله.

أضِف رقم تعريف تطبيق AdMob، كما هو محدّد في واجهة الويب في AdMob، إلى ملف android/app/src/main/AndroidManifest.xml الخاص بالتطبيق من خلال إضافة علامة <meta-data> بالاسم com.google.android.gms.ads.APPLICATION_ID. بالنسبة إلى android:value، أدخِل رقم تعريف تطبيقك على AdMob بين علامتَي اقتباس كما هو موضّح:

<manifest>
    <application>
        <!-- Sample AdMob 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. بقيمة سلسلة لمعرّف تطبيق AdMob، كما هو محدّد في موقع AdMob على الويب واجهة:

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>

يجب عليك تمرير القيمة نفسها عند تهيئة المكون الإضافي في تعليمة Dart الخاصة بك.

يمكنك الاطّلاع على دليل iOS للحصول على مزيد من المعلومات. معلومات عن ضبط "Info.plist" وإعداد رقم تعريف تطبيقك.

إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات للأجهزة الجوّالة

قبل تحميل الإعلانات، اطلب من تطبيقك إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة من خلال استدعاء MobileAds.instance.initialize() التي تهيئ حزمة SDK وتُرجع Future التي تنتهي بعد اكتمال الإعداد أو بعد مهلة 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) لعرض الإعلانات على الأجهزة الجوّالة، تكون مستعدًا لعرض إعلان. AdMob يقدم عددًا من أشكال الإعلانات المختلفة، حتى يمكنك اختيار الشكل الأفضل يناسب تجربة المستخدم في تطبيقك.

إعلانات مستطيلة تظهر في أعلى أو أسفل شاشة الجهاز بانر تظل الإعلانات معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكنهم تحديث تلقائيًا بعد فترة زمنية معينة. إذا كنت مبتدئًا في مجال الإعلانات على الأجهزة المتحرّكة، يمكنك البدء باستخدام هذه الإعلانات.

تنفيذ إعلان بانر

إعلان بيني

الإعلانات التي تظهر بملء الشاشة وتغطي واجهة التطبيق إلى أن يغلقها المستخدم يتم استخدامها بشكل أفضل في فترات التوقف الطبيعية الطبيعية أثناء تنفيذ التطبيق، مثل بين مستويات اللعبة أو بعد إكمال مهمة مباشرةً.

تنفيذ إعلان بيني

مدمجة مع المحتوى

إعلانات قابلة للتخصيص تتوافق مع شكل تطبيقك وأسلوبه. ويمكنك اختيار كيفية وضعها ومكانها، بحيث يصبح التنسيق أكثر اتساقًا مع تصميم تطبيقك.

تنفيذ إعلان مدمج مع المحتوى

تم منح المكافأة

إعلانات تمنح المستخدمين مكافآت مقابل مشاهدة فيديوهات قصيرة والتفاعل مع محتوى قابل للتشغيل الإعلانات والاستطلاعات وهذه الإعلانات مناسبة لتحقيق الربح من المستخدمين الذين يشغّلون الألعاب المجانية.

عرض إعلان مقابل مكافأة