البدء

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

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

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

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

  • ‫Flutter 1.22.0 أو إصدار أحدث
  • Android
    • الإصدار 3.2 من "استوديو Android" أو إصدار أحدث
    • استهداف المستوى 20 من واجهة برمجة التطبيقات لنظام التشغيل Android أو الإصدارات الأحدث
    • ضبط compileSdkVersion على 28 أو أعلى
  • iOS

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

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

Android

تعديل ملف AndroidManifest.xml

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

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

<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" (يتم تحديده في واجهة مستخدم "مدير إعلانات Google"):

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

يجب ضبط القيمة نفسها عند بدء تشغيل المكوّن الإضافي في ملف Dart الترميز.

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

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

قبل تحميل الإعلانات، اطلب من تطبيقك إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة من خلال استدعاء MobileAds.instance.initialize()، ما يؤدي إلى إعداد حزمة SDK وإرجاع Future التي تنتهي بعد اكتمال عملية الإعداد (أو بعد Future ثانية). يجب إجراء ذلك مرة واحدة فقط، ويُفضَّل قبل تشغيل التطبيق مباشرةً.

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

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

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

إعلان بيني

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

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

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

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

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

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

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

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