البدء

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

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

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

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

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

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

الإعداد الخاص بالنظام الأساسي

Android

تحديث ملف AndroidManifest.xml

يجب تضمين رقم تعريف تطبيق "مدير الإعلانات" في AndroidManifest.xml. ويؤدي عدم الالتزام بذلك إلى حدوث عطل عند تشغيل التطبيق.

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

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

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

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

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

إعلان بيني

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

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

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

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

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

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

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

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