البدء

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

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

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

إعلان بيني

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

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

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

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

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

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

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

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