يُعدّ دمج حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في تطبيق Flutter الخطوة الأولى نحو عرض الإعلانات وتحقيق الإيرادات. بعد دمج حزمة تطوير البرامج (SDK)، يمكنك المتابعة لتنفيذ شكل واحد أو أكثر من أشكال الإعلانات المتوافقة.
يجب تضمين معرّف تطبيق AdMob في AndroidManifest.xml.
ويؤدي عدم إجراء ذلك إلى تعطُّل التطبيق عند تشغيله.
أضِف معرّف تطبيق AdMob، كما هو
محدّد في واجهة مستخدم الويب الخاصة بـ AdMob،
إلى ملف android/app/src/main/AndroidManifest.xml الخاص بالتطبيق من خلال إضافة علامة
<meta-data> بالاسم com.google.android.gms.ads.APPLICATION_ID.
بالنسبة إلى android:value، أدخِل معرّف تطبيقك الخاص بين علامتَي اقتباس كما هو موضّح:
استخدِم value نفسه عند إعداد المكوّن الإضافي في رمز Dart البرمجي.
راجِع دليل Android للحصول على مزيد من المعلومات حول إعداد AndroidManifest.xml وإعداد معرّف التطبيق.
iOS
تعديل ملف Info.plist
في ملف ios/Runner/Info.plist الخاص بتطبيقك، أضِف مفتاحًا GADApplicationIdentifier
بقيمة سلسلة تمثّل معرّف تطبيقك على AdMob، كما هو محدّد في واجهة ويب AdMob:
يجب إدخال القيمة نفسها عند إعداد المكوّن الإضافي في رمز Dart البرمجي.
راجِع دليل iOS لمزيد من المعلومات حول إعداد Info.plist وإعداد رقم تعريف التطبيق.
إعداد حزمة تطوير البرامج (SDK) للإعلانات على الأجهزة الجوّالة
قبل تحميل الإعلانات، يجب أن يبدأ تطبيقك حزمة تطوير البرامج (SDK) للإعلانات على الأجهزة الجوّالة من خلال استدعاء
MobileAds.instance.initialize()
الذي يبدأ حزمة تطوير البرامج (SDK) ويعرض Future ينتهي بعد اكتمال عملية الإعداد أو بعد انتهاء المهلة البالغة 30 ثانية. يجب الاتصال بالرقم initialize()
في أقرب وقت ممكن.
// Initialize the Mobile Ads SDK.MobileAds.instance.initialize();
بعد استيراد "حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة"، ستكون مستعدًا لعرض إعلان.
توفّر AdMob عددًا من أشكال الإعلانات المختلفة، ما يتيح لك اختيار الشكل الأنسب لتجربة المستخدم في تطبيقك.
بانر
إعلانات مستطيلة تظهر في أعلى شاشة الجهاز أو أسفلها تبقى إعلانات البانر معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن إعادة تحميلها تلقائيًا بعد فترة زمنية محدّدة. إذا كنت جديدًا في مجال الإعلانات على الأجهزة الجوّالة، ستكون هذه الإعلانات خيارًا رائعًا للبدء.
إعلانات بملء الشاشة تغطي واجهة التطبيق إلى أن يغلقها المستخدم
ويُفضّل استخدامها عند التوقف مؤقتًا بشكل طبيعي أثناء تنفيذ التطبيق، مثلاً بين مستويات اللعبة أو بعد إكمال مهمة مباشرةً.
هي إعلانات تكافئ المستخدمين على مشاهدة فيديوهات قصيرة وتفاعلهم مع "إعلانات تشغيل إصدار بسيط من اللعبة" ومع الاستطلاعات. وهذه الإعلانات مناسبة لتحقيق الربح من المستخدمين الذين يشغّلون الألعاب المجانية.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide explains how to integrate the Google Mobile Ads SDK into a Flutter app to display AdMob ads and earn revenue.\u003c/p\u003e\n"],["\u003cp\u003ePublishers need to meet prerequisites such as minimum Flutter and Android/iOS versions, and ideally create and register an AdMob account.\u003c/p\u003e\n"],["\u003cp\u003eThe integration process involves importing the SDK, platform-specific setup (Android/iOS), and initializing the Mobile Ads SDK before loading ads.\u003c/p\u003e\n"],["\u003cp\u003eAdMob offers various ad formats including banner, interstitial, native, and rewarded, each with its own implementation guide linked in the document.\u003c/p\u003e\n"],["\u003cp\u003eYou can choose the format best suited for your app and follow the respective guide for detailed implementation instructions.\u003c/p\u003e\n"]]],["Publishers integrating AdMob ads into a Flutter app must first include the Google Mobile Ads SDK plugin. They then update `AndroidManifest.xml` (Android) and `Info.plist` (iOS) with their AdMob app ID. Before loading ads, they initialize the SDK using `MobileAds.instance.initialize()`. Finally, publishers can select an ad format: banner, interstitial, native, or rewarded, based on their app's user experience. The document provides further links for setting up the app and ad formats.\n"],null,["# Get started\n\nSelect platform: [Android](/admob/android/quick-start \"View this page for the Android platform docs.\") [iOS](/admob/ios/quick-start \"View this page for the iOS platform docs.\") [Unity](/admob/unity/quick-start \"View this page for the Unity platform docs.\") [Flutter](/admob/flutter/quick-start \"View this page for the Flutter platform docs.\")\n\n\u003cbr /\u003e\n\nIntegrating the Google Mobile Ads SDK into a Flutter app is the first step\ntoward displaying ads and earning revenue. Once you've integrated the SDK, you\ncan proceed to implement one or more of the supported ad formats.\n\nPrerequisites\n-------------\n\n- Flutter 3.27.0 or higher\n- Android\n - Latest version of Android Studio\n- iOS\n - Latest version of Xcode with [enabled command-line\n tools](//flutter.dev/docs/get-started/install/macos#install-xcode)\n\nImport the Mobile Ads SDK\n-------------------------\n\n- Include the [Google Mobile Ads SDK for Flutter\n plugin](//pub.dev/packages/google_mobile_ads/install) in your Flutter project.\n\nPlatform specific setup\n-----------------------\n\n\n| **Important:** Use the latest Google Mobile Ads SDK so that you have access to all the privacy compliance features.\n\n\u003cbr /\u003e\n\n### Android\n\n**Update AndroidManifest.xml**\n\nThe AdMob app ID must be included in the `AndroidManifest.xml`.\nFailure to do so results in a crash on app launch.\n\nAdd the AdMob app ID, as\n\n[identified in the AdMob web interface](//support.google.com/admob/answer/7356431),\n\nto the app's `android/app/src/main/AndroidManifest.xml` file by adding a\n`\u003cmeta-data\u003e` tag with the name `com.google.android.gms.ads.APPLICATION_ID`.\nFor `android:value`, insert your own app ID in quotes as shown: \n\n \u003cmanifest\u003e\n \u003capplication\u003e\n \u003c!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 --\u003e\n \u003cmeta-data\n android:name=\"com.google.android.gms.ads.APPLICATION_ID\"\n android:value=\"ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy\"/\u003e\n \u003capplication\u003e\n \u003cmanifest\u003e\n\nUse the same `value` when you initialize the plugin in your Dart code.\n\nSee the\n\n[Android guide](/admob/android/quick-start#update_your_androidmanifestxml)\n\nfor more information about configuring `AndroidManifest.xml` and setting up\nthe app ID.\n\n### iOS\n\n**Update Info.plist**\n\nIn your app's `ios/Runner/Info.plist` file, add a `GADApplicationIdentifier`\nkey with a string value of your AdMob app ID, as\n[identified in the AdMob web interface](//support.google.com/admob/answer/7356431): \n\n \u003ckey\u003eGADApplicationIdentifier\u003c/key\u003e\n \u003cstring\u003eca-app-pub-################~##########\u003c/string\u003e\n\nYou must pass the same value when you initialize the plugin in your Dart code.\n\nSee the\n\n[iOS guide](/admob/ios/quick-start#update_your_infoplist)\n\nfor more information about configuring `Info.plist` and setting up the app ID.\n\nInitialize the Mobile Ads SDK\n-----------------------------\n\nBefore loading ads, have your app initialize the Mobile Ads SDK by calling\n[`MobileAds.instance.initialize()`](//pub.dev/documentation/google_mobile_ads/latest/google_mobile_ads/MobileAds/initialize.html)\nwhich initializes the SDK and returns a `Future` that finishes once\ninitialization is complete, or after a 30-second timeout. Call `initialize()`\nas early as possible. \n\n // Initialize the Mobile Ads SDK.\n MobileAds.instance.initialize(); \n https://github.com/googleads/googleads-mobile-flutter/blob/5dce0f8f948d1fd04a5e156d80ed0ea6e17f837c/samples/admob/banner_example/lib/main.dart#L229-L230\n\nSelect an ad format\n-------------------\n\nAfter the Mobile Ads SDK is imported, you're ready to implement an ad.\nAdMob offers a number of different ad formats, so you can choose\nthe one that best fits your app's user experience.\n\n### Banner\n\nRectangular ads that appear at the top or bottom of the device screen. Banner\nads stay on screen while users are interacting with the app, and can refresh\nautomatically after a certain period of time. If you're new to mobile\nadvertising, they're a great place to start. \n\n[Implement a Banner ad](/admob/flutter/banner)\n\n### Interstitial\n\nFull-screen ads that cover the interface of an app until closed by the user.\nThey're best used at natural pauses in the flow of an app's execution, such as\nin between levels of a game or just after completing a task. \n\n[Implement an Interstitial ad](/admob/flutter/interstitial)\n\n### Native\n\nCustomizable ads that match the look and feel of your app. You decide how and\nwhere they're placed, so the layout is more consistent with your app's design. \n\n[Implement a Native ad](/admob/flutter/native)\n\n### Rewarded\n\nAds that reward users for watching short videos and interacting with playable\nads and surveys. Good for monetizing free-to-play users. \n\n[Implement a Rewarded ad](/admob/flutter/rewarded)"]]
