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

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

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

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

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

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

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

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

مرحله ۱: برنامه خود را در حساب AdMob خود تنظیم کنید

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

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

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

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

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

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

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

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

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

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

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

شناسه برنامه AdMob خود را با اضافه کردن تگ <meta-data> مطابق شکل زیر به فایل 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>

مرحله ۳: اضافه کردن و مقداردهی اولیه SDK Mobile Ads

  1. وابستگی مربوط به SDK Google Mobile Ads را به فایل Gradle ماژول (سطح برنامه) خود اضافه کنید (معمولاً <project>/<app-module>/build.gradle.kts یا <project>/<app-module>/build.gradle ):

    implementation("com.google.android.gms:play-services-ads:24.7.0")

  2. قبل از بارگذاری تبلیغات، متد MobileAds.initialize() را فراخوانی کنید.

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

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

    Kotlin 

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

    Java 

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

مرحله ۴: مشاهده معیارهای کاربر و داده‌های تحلیلی

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

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

مرحله ۵: (اختیاری) استفاده از ویژگی‌های بیشتر Google Analytics و فایربیس

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

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

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

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

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

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

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

  • بهینه‌سازی کسب درآمد از تبلیغات برای اپلیکیشن شما

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

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

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

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

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

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

بینابینی

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

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

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

بومی

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

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

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

پاداش داده شده

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

تبلیغات جایزه‌دار (یا «مبتنی بر جایزه») می‌توانند به کسب درآمد از کاربران بازی‌های رایگان کمک کنند.

تبلیغات جایزه‌دار (Rewarded Ads) را پیاده‌سازی کنید پیاده‌سازی تبلیغات جایزه‌دار (APIهای جدید)