ادغام Google Mobile Ads SDK در برنامه Flutter اولین قدم برای نمایش تبلیغات و کسب درآمد است. هنگامی که SDK را ادغام کردید، می توانید یک یا چند فرمت تبلیغاتی پشتیبانی شده را پیاده سازی کنید.
شناسه برنامه Ad Manager باید در AndroidManifest.xml موجود باشد. عدم انجام این کار منجر به خرابی هنگام راه اندازی برنامه می شود.
با افزودن یک برچسب <meta-data> با نام com.google.android.gms.ads.APPLICATION_ID ، شناسه برنامه Ad Manager را، همانطور که در رابط وب Ad Manager مشخص شده است ، به فایل android/app/src/main/AndroidManifest.xml برنامه اضافه کنید. برای android:value ، شناسه برنامه خود را مانند نشان داده شده در گیومه وارد کنید:
هنگامی که افزونه را در کد دارت خود مقداردهی اولیه می کنید، از همان value استفاده کنید.
برای اطلاعات بیشتر درباره پیکربندی AndroidManifest.xml و تنظیم شناسه برنامه، راهنمای Android را ببینید.
iOS
به روز رسانی Info.plist
در فایل ios/Runner/Info.plist برنامه خود، یک کلید GADApplicationIdentifier با مقدار رشته شناسه برنامه Ad Manager خود، همانطور که در رابط وب Ad Manager مشخص شده است ، اضافه کنید:
هنگامی که افزونه را در کد دارت خود مقداردهی اولیه می کنید، باید همان مقدار را ارسال کنید.
برای اطلاعات بیشتر درباره پیکربندی Info.plist و تنظیم شناسه برنامه، راهنمای iOS را ببینید.
SDK تبلیغات موبایل را راه اندازی کنید
قبل از بارگیری تبلیغات، از برنامه خود بخواهید با فراخوانی MobileAds.instance.initialize() که SDK را مقداردهی اولیه می کند و یک Future را برمی گرداند که پس از تکمیل اولیه یا پس از وقفه 30 ثانیه ای به پایان می رسد. در اسرع وقت فراخوانی initialize() .
// Initialize the Mobile Ads SDK.MobileAds.instance.initialize();
پس از وارد کردن SDK تبلیغات موبایل، شما آماده اجرای یک تبلیغ هستید. Ad Manager قالبهای مختلف تبلیغاتی را ارائه میدهد، بنابراین میتوانید یکی را انتخاب کنید که با تجربه کاربری برنامهتان مطابقت دارد.
بنر
تبلیغات مستطیلی که در بالا یا پایین صفحه نمایش دستگاه ظاهر می شوند. تبلیغات بنری در حالی که کاربران در حال تعامل با برنامه هستند روی صفحه می مانند و می توانند پس از مدت زمان معینی به طور خودکار بازخوانی شوند. اگر در زمینه تبلیغات موبایلی تازه کار هستید، آنها مکان خوبی برای شروع هستند.
تبلیغات تمام صفحه که رابط یک برنامه را تا زمانی که توسط کاربر بسته شود پوشش می دهند. آنها به بهترین وجه در مکث های طبیعی در جریان اجرای برنامه استفاده می شوند، مانند بین سطوح یک بازی یا درست پس از اتمام یک کار.
تبلیغات قابل تنظیم که با ظاهر و احساس برنامه شما مطابقت دارند. شما تصمیم می گیرید که چگونه و در کجا قرار گیرند، بنابراین طرح بندی با طراحی برنامه شما سازگارتر است.
تبلیغاتی که به کاربران برای تماشای ویدیوهای کوتاه و تعامل با تبلیغات و نظرسنجیهای قابل پخش پاداش میدهد. برای کسب درآمد از کاربران رایگان بازی خوب است.
تاریخ آخرین بهروزرسانی 2025-08-30 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-30 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis guide explains how to integrate Google Mobile Ads SDK into a Flutter app for monetization with Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, ensure you meet the prerequisites, which include specific Flutter, Android, and iOS requirements.\u003c/p\u003e\n"],["\u003cp\u003eYou must update your AndroidManifest.xml or Info.plist with your Ad Manager app ID for Android and iOS respectively, then initialize the Mobile Ads SDK in your Dart code.\u003c/p\u003e\n"],["\u003cp\u003eThe SDK supports banner, interstitial, native, and rewarded ad formats - select the one that best suits your app.\u003c/p\u003e\n"],["\u003cp\u003eDetailed implementation steps are provided for each ad format after the initial integration is complete.\u003c/p\u003e\n"]]],["Publishers monetize Flutter apps by integrating the Google Mobile Ads SDK. This involves importing the SDK plugin and setting up platform-specific configurations. For Android, update `AndroidManifest.xml` with the Ad Manager app ID; for iOS, update `Info.plist`. Initialize the SDK using `MobileAds.instance.initialize()` before loading ads. Finally, choose an ad format: banner, interstitial, native, or rewarded, each with detailed implementation guides. Ensure you have the latest SDK version for full privacy compliance.\n"],null,["# Get started\n\nSelect platform: [Android](/ad-manager/mobile-ads-sdk/android/quick-start \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/quick-start \"View this page for the iOS platform docs.\") [Unity](/ad-manager/mobile-ads-sdk/unity/quick-start \"View this page for the Unity platform docs.\") [Flutter](/ad-manager/mobile-ads-sdk/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 Ad Manager app ID must be included in the `AndroidManifest.xml`.\nFailure to do so results in a crash on app launch.\n\nAdd the Ad Manager app ID, as\n\n[identified in the Ad Manager web interface](//support.google.com/admanager/answer/15014197),\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 Ad Manager 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](/ad-manager/mobile-ads-sdk/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 Ad Manager app ID, as\n[identified in the Ad Manager web interface](//support.google.com/admanager/answer/15014197): \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](/ad-manager/mobile-ads-sdk/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.\nAd Manager 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](/ad-manager/mobile-ads-sdk/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](/ad-manager/mobile-ads-sdk/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](/ad-manager/mobile-ads-sdk/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](/ad-manager/mobile-ads-sdk/flutter/rewarded)"]]