إعداد Google Mobile Ads Flutter Plugin

اختيار النظام الأساسي: Android iOS Unity Flutter Android (الإصدار القديم)

لعرض الإعلانات وتحقيق الأرباح، عليك دمج Google Mobile Ads Flutter Plugin في تطبيق Flutter. ولتجهيز مشروعك، عليك استيراد Google Mobile Ads Flutter Plugin وتهيئة إعداداته قبل طلب عرض الإعلانات.

يتناول هذا الدليل عملية استيراد Google Mobile Ads Flutter Plugin وتهيئته واختيار شكل إعلان.

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

قبل المتابعة، يجب توفّر ما يلي:

  • الإصدار 3.38.1 أو الإصدارات الأحدث من Flutter
  • بالنسبة إلى Android، يجب استخدام أحدث إصدار من "استوديو Android".
  • بالنسبة إلى نظام التشغيل iOS، يجب استخدام أحدث إصدار من Xcode مع تفعيل أدوات سطر الأوامر. لمعرفة التفاصيل، يُرجى الاطّلاع على تثبيت Flutter.
  • معرّف تطبيق يستخدم AdMob لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة البحث عن رقم تعريف تطبيق أو رقم تعريف وحدة إعلانية ونسخهما.

استيراد Google Mobile Ads Flutter Plugin

لاستيراد Google Mobile Ads Flutter Plugin في مشروع Flutter، اطّلِع على google_mobile_ads.

إعداد تطبيقك

بعد استيراد Google Mobile Ads Flutter Plugin، اختَر إحدى المنصات التالية لإعداد تطبيقك:

Android

  1. في "استوديو Android"، انتقِل إلى ملف android/app/src/main/AndroidManifest.xml.

  2. في ملف AndroidManifest.xml، أضِف علامة <meta-data> إلى العلامة <application> مع السمات التالية:

    <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>

    يجب أن تتضمّن هذه السمات القيم التالية:

    • android:name: com.google.android.gms.ads.APPLICATION_ID.
    • android:value: معرّف تطبيقك على AdMob

    للحصول على تفاصيل حول إعداد ملف AndroidManifest.xml، يُرجى الاطّلاع على إعداد Google Mobile Ads SDK (Legacy).

iOS

  1. في Xcode، انتقِل إلى ملف ios/Runner/Info.plist.

  2. في ملف Info.plist، أضِف مفتاحًا GADApplicationIdentifier يتضمّن رقم تعريف تطبيقك على AdMob كسلسلة.

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

    لمعرفة تفاصيل حول إعداد ملف Info.plist، يُرجى الاطّلاع على تعديل ملف Info.plist.

إعداد Google Mobile Ads Flutter Plugin

قبل تحميل الإعلانات، عليك ضبط Google Mobile Ads Flutter Plugin على القيمة الأولية من خلال استدعاء MobileAds.instance.initialize().

تعرض هذه الطريقة قيمة Future تنتهي بعد تهيئة Google Mobile Ads Flutter Plugin، أو بعد 30 ثانية.

يهيئ المثال التالي Google Mobile Ads Flutter Plugin:

// Initialize the Mobile Ads SDK.
MobileAds.instance.initialize();

اختيار شكل الإعلان

بعد استيراد Google Mobile Ads Flutter Plugin، يمكنك اختيار شكل إعلان لتنفيذه. توفّر AdMob أشكال الإعلانات التالية:

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