البدء

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

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

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

إعلان بيني

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

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

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

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

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

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

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

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