إعداد 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.
  • معرّف تطبيق في "مدير الإعلانات" لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة البحث عن رقم تعريف تطبيق أو رقم تعريف وحدة إعلانية.

استيراد 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 Ad Manager 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 برقم تعريف تطبيقك على "مدير إعلانات Google".

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

iOS

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

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

    <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، يمكنك اختيار شكل إعلان لتنفيذه. توفّر "إدارة إعلانات Google" أشكال الإعلانات التالية:

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