البدء

هذا الدليل مخصَّص للناشرين الذين يريدون تحقيق الربح من تطبيق 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 رسالة تنتهي عند اكتمال الإعداد أو بعد مهلة مدتها 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 عددًا من أشكال الإعلانات المختلفة، حتى يمكنك اختيار الشكل الذي يناسب تجربة مستخدم تطبيقك.

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

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

إعلان بيني

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

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

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

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

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

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

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

تنفيذ إعلان يضم مكافأة