راه‌اندازی افزایه Google Mobile Ads Flutter

پلاتفرم را انتخاب کنید: Android iOS Unity Flutter Android (Legacy)

برای ارائه آگهی و کسب درآمد، Google Mobile Ads Flutter Plugin را در برنامه Flutter خود ادغام کنید. برای آماده‌سازی پروژه‌تان، قبل‌از درخواست آگهی، Google Mobile Ads Flutter Plugin را وارد و مقداردهی اولیه کنید.

این راهنما شامل وارد کردن و مقداردهی اولیه Google Mobile Ads Flutter Plugin و انتخاب قالب آگهی است.

پیش‌نیازها

پیش‌از ادامه دادن، به موارد زیر نیاز دارید:

وارد کردن 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، یا پس‌از ۳۰ ثانیه تمام می‌شود.

مثال زیر Google Mobile Ads Flutter Plugin را مقداردهی اولیه می‌کند:

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

انتخاب قالب آگهی

پس‌از وارد کردن Google Mobile Ads Flutter Plugin، می‌توانید قالب آگهی را برای پیاده‌سازی انتخاب کنید. AdMob قالب‌های آگهی زیر را ارائه می‌دهد:

قالب آگهی شرح اسناد
برنما آگهی‌های مستطیلی را در ناحیه تعیین‌شده نشان می‌دهد. این آگهی‌ها به‌طور خودکار بازآوری می‌شوند و به کاربران اجازه می‌دهند آگهی‌ها را درحالی‌که در همان صفحه باقی می‌مانند مشاهده کنند. راه‌اندازی آگهی‌های برنما
بینابینی آگهی‌های تمام‌صفحه را در برنامه‌تان نشان می‌دهد. این آگهی‌ها را در نقاط انتقال طبیعی، مثلاً بین سطوح بازی، قرار دهید. آگهی‌های بینابینی
بومی به شما امکان می‌دهد دارایی‌ها، مانند عنوان‌ها و دعوت به اقدام‌ها، را در برنامه‌هایتان سفارشی‌سازی کنید. وقتی آگهی را سفارشی‌سازی می‌کنید، آگهی‌هایی ایجاد می‌کنید که با طراحی بصری برنامه‌تان مطابقت دارد. بار کردن آگهی بومی
پاداش به کاربران اجازه می‌دهد برای کسب پاداش‌های درون‌برنامه، مثل سکه یا جان اضافی، ویدیو تماشا کنند یا در نظرسنجی‌ها شرکت کنند. برای هر واحد آگهی، می‌توانید مقادیر پاداش را مشخص کنید. آگهی‌های پاداش‌دار
بینابینی پاداش‌دار به شما امکان می‌دهد برای آگهی‌هایی که درطول انتقال‌های برنامه نشان داده می‌شود پاداش‌هایی مثل سکه یا جان اضافه ارائه دهید. آگهی‌های بینابینی پاداش‌دار
صفحه باز شدن برنامه وقتی کاربران برنامه شما را باز می‌کنند یا به آن برمی‌گردند ظاهر می‌شود. آگهی روی صفحه بارگیری قرار می‌گیرد. آگهی‌های باز شدن برنامه