إعداد 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 أشكال الإعلانات التالية:

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