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

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

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

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

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

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

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

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

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

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

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

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

مرحله 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 Mobile Ads

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:23.6.0")
   

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

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

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

   Kotlin+KTX

   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

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

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

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

• در داشبورد Analytics کنسول Firebase ، می‌توانید آمار و خلاصه‌ای از معیارهای کلیدی را مشاهده کنید. اگر Firebase SDK را برای Google Analytics اضافه کنید ، همچنین می‌توانید تبدیل‌ها را برای کمپین‌های تبلیغاتی علامت‌گذاری کنید و مخاطبان سفارشی را در کنسول Firebase ایجاد کنید.

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

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

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

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

  • ثبت رویداد سفارشی را در برنامه خود پیاده کنید.

  • تبدیل ها را برای کمپین های تبلیغاتی سفارشی علامت گذاری کنید.

  • داده‌های رویداد ecommerce_purchase را در محاسبه درآمد برای معیارهای ARPU و ARPPU لحاظ کنید.

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

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

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

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

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

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

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

  • پذیرش قالب آگهی جدید را آزمایش کنید ( نمای کلی | پیاده سازی ).

  • فرکانس تبلیغات را بهینه کنید ( نمای کلی | پیاده سازی ).

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

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

بنر

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

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