با 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 را از برگه Integrations فعال کنید. > تنظیمات پروژه .

مرحله 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 را به فایل Gradle ماژول (سطح برنامه) خود اضافه کنید (معمولا <project>/<app-module>/build.gradle.kts یا <project>/<app-module>/build.gradle ):

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

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

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

    Kotlin+KTX

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

    Java

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

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

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

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

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

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

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

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

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

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

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

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

  • کسب درآمد از تبلیغات را برای برنامه خود بهینه کنید

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

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

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

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

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

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

بینابینی

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

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

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

بومی

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

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

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

پاداش داده شد

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

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

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