Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

با AdMob در پروژه Android خود شروع کنید

با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

این راهنمای شروع سریع برای ناشران و توسعه دهندگانی است که می خواهند از AdMob برای کسب درآمد از برنامه ای که با Firebase ساخته شده است استفاده کنند. اگر قصد ندارید Firebase را در برنامه خود قرار دهید، به جای آن از راهنمای AdMob مستقل بازدید کنید.

اگر هنوز این کار را نکرده اید، با تمام مزایای استفاده از AdMob، Firebase و Google Analytics با هم آشنا شوید.

قبل از اینکه شروع کنی

  • اگر قبلاً پروژه Firebase و برنامه Firebase ندارید، راهنمای شروع Firebase را دنبال کنید: Firebase را به پروژه Android خود اضافه کنید .

  • مطمئن شوید که Google Analytics در پروژه Firebase شما فعال است:

    • اگر در حال ایجاد یک پروژه Firebase هستید، Google Analytics را در جریان کار ایجاد پروژه فعال کنید.

    • اگر پروژه Firebase موجودی دارید که Google Analytics را فعال نکرده است، می‌توانید Google Analytics را از برگه ادغام > تنظیمات پروژه فعال کنید.

مرحله 1: برنامه خود را در حساب AdMob خود راه اندازی کنید

  1. برنامه خود را به عنوان یک برنامه AdMob ثبت کنید.

    1. وارد حساب AdMob شوید یا برای آن ثبت نام کنید.

    2. برنامه خود را با AdMob ثبت کنید . این مرحله یک برنامه AdMob با شناسه برنامه AdMob منحصر به فرد ایجاد می کند که بعداً در این راهنما به آن نیاز خواهید داشت.

    از شما خواسته می شود SDK تبلیغات موبایل را به برنامه خود اضافه کنید. دستورالعمل های دقیق برای این کار را بعداً در این راهنما بیابید.

  2. برنامه AdMob خود را به برنامه Firebase خود پیوند دهید.

    این مرحله اختیاری است اما به شدت توصیه می شود. درباره مزایای فعال کردن معیارهای کاربر و پیوند دادن برنامه AdMob خود به Firebase بیشتر بدانید.

    دو مرحله زیر را در داشبورد Apps حساب AdMob خود انجام دهید:

    1. User Metrics را فعال کنید تا به AdMob اجازه دهد داده های تجزیه و تحلیل انتخاب شده را در حساب AdMob شما پردازش و نمایش دهد. همچنین یک تنظیم ضروری برای شماست که برنامه AdMob خود را به Firebase پیوند دهید.

    2. برنامه AdMob خود را به پروژه Firebase و برنامه Firebase موجود خود پیوند دهید .

      مطمئن شوید که همان نام بسته ای را که برای برنامه Firebase وارد کرده اید وارد کنید. نام بسته برنامه Firebase خود را در کارت برنامه‌های شما > تنظیمات پروژه پیدا کنید.

مرحله 2: شناسه برنامه AdMob خود را به فایل AndroidManifest.xml خود اضافه کنید

با افزودن برچسب <meta-data> مطابق شکل زیر، شناسه برنامه AdMob خود را به فایل AndroidManifest.xml برنامه خود اضافه کنید.

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

مرحله 3: افزودن و مقداردهی اولیه SDK تبلیغات موبایل

  1. وابستگی Google Mobile Ads SDK را به فایل build.gradle ماژول (سطح برنامه) برنامه خود اضافه کنید:

    implementation 'com.google.android.gms:play-services-ads:21.2.0'
    
  2. قبل از بارگذاری تبلیغات، متد MobileAds.initialize() را فراخوانی کنید.

    این فراخوانی SDK را مقداردهی اولیه می‌کند و پس از تکمیل اولیه (یا پس از یک بازه زمانی 30 ثانیه‌ای) یک شنونده تکمیل را فراخوانی می‌کند. این روش را فقط یک بار و در اسرع وقت، ایده آل هنگام راه اندازی برنامه، فراخوانی کنید.

    در اینجا مثالی از نحوه فراخوانی متد initialize() در یک Activity آورده شده است:

    Java

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // ...
        MobileAds.initialize(this);
    }

    Kotlin+KTX

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // ...
        MobileAds.initialize(this)
    }

مرحله 4: معیارهای کاربر و داده های تجزیه و تحلیل را مشاهده کنید

پس از راه‌اندازی، کیت توسعه نرم‌افزار تبلیغات موبایلی به‌طور خودکار شروع به ثبت رویدادهای تحلیلی و ویژگی‌های کاربر از برنامه شما می‌کند. می‌توانید این داده‌ها را بدون افزودن کد اضافی به برنامه خود یا پیاده‌سازی هر گونه تبلیغات مشاهده کنید. در اینجا می توانید این داده های تحلیلی را مشاهده کنید:

توجه داشته باشید که برای نمایش بهتر معیارهای ARPU و ARPPU ، ممکن است بخواهید داده‌های یک رویداد سفارشی تحلیلی به نام ecommerce_purchase را در محاسبه درآمد برای این معیارها قرار دهید ( چطور یاد بگیرید ).

مرحله 5: (اختیاری) از ویژگی های بیشتر Google Analytics و Firebase استفاده کنید

از فرصت ها و ویژگی های بیشتر برای بهبود کسب درآمد از برنامه و تعامل کاربر استفاده کنید:

  • افزودن و استفاده از Firebase SDK برای Google Analytics

  • از سایر محصولات Firebase در برنامه خود استفاده کنید

    پس از افزودن Firebase SDK برای Google Analytics، از سایر محصولات Firebase برای بهینه سازی تبلیغات در برنامه خود استفاده کنید.

    • Remote Config شما را قادر می سازد تا رفتار و ظاهر برنامه خود را بدون انتشار به روز رسانی برنامه، بدون هیچ هزینه ای، برای کاربران فعال روزانه نامحدود تغییر دهید.

    • تست A/B به شما این قدرت را می‌دهد که تغییرات را در UI، ویژگی‌ها یا کمپین‌های تعامل برنامه‌تان آزمایش کنید تا بدانید که آیا این تغییرات بر معیارهای کلیدی شما (مانند درآمد و حفظ) تأثیر می‌گذارند یا نه، قبل از انتشار گسترده تغییرات.

برای شروع، به راهنمای استفاده از Google Analytics و Firebase با برنامه‌های AdMob مراجعه کنید.

مرحله 6: یک قالب تبلیغاتی را برای پیاده سازی در برنامه خود انتخاب کنید

AdMob فرمت‌های مختلف تبلیغاتی را ارائه می‌کند، بنابراین می‌توانید قالبی را انتخاب کنید که به بهترین وجه با تجربه کاربری برنامه‌تان مطابقت دارد. برای مشاهده دستورالعمل‌های اجرایی دقیق در اسناد AdMob، روی دکمه‌ای برای قالب تبلیغات کلیک کنید.

تبلیغات مستطیلی که در بالا یا پایین صفحه نمایش دستگاه ظاهر می شوند

تبلیغات بنری در حالی که کاربران در حال تعامل با برنامه هستند روی صفحه می مانند و می توانند پس از مدت زمان معینی به طور خودکار بازخوانی شوند. اگر در زمینه تبلیغات موبایلی تازه کار هستید، آنها مکان خوبی برای شروع هستند.

پیاده سازی تبلیغات بنری

بینابینی

تبلیغات تمام صفحه که رابط یک برنامه را تا زمانی که توسط کاربر بسته شود پوشش می دهند

تبلیغات بینابینی بهتر است در مکث های طبیعی در جریان اجرای برنامه، مانند بین سطوح یک بازی یا درست پس از اتمام یک کار، استفاده شوند.

اجرای تبلیغات بینابینی

بومی

تبلیغات قابل تنظیم که با ظاهر و احساس برنامه شما مطابقت دارند

تبلیغات بومی یک قالب تبلیغاتی مبتنی بر مؤلفه است. شما تصمیم می گیرید که تبلیغات بومی چگونه و در کجا قرار گیرد تا طرح بندی با طراحی برنامه شما سازگارتر باشد. با انتخاب فونت ها، رنگ ها و سایر جزئیات برای خود، می توانید ارائه های تبلیغاتی طبیعی و بدون مزاحمت ایجاد کنید که می تواند به تجربه کاربری غنی اضافه کند.

تبلیغات پیشرفته بومی را پیاده سازی کنید

پاداش داده شد

تبلیغاتی که به کاربران برای تماشای ویدیوهای کوتاه و تعامل با تبلیغات و نظرسنجی‌های قابل پخش پاداش می‌دهد

تبلیغات با پاداش (یا "بر اساس پاداش") می تواند به کسب درآمد از کاربران رایگان کمک کند.

اجرای تبلیغات با پاداش پیاده سازی تبلیغات پاداش (API های جدید)