ادغام GMA Next-Gen SDK در برنامه اولین گام برای نمایش آگهی و کسب درآمد است. پس‌از ادغام کیت توسعه نرم‌افزار، می‌توانید قالب آگهی (مثل آگهی بومی یا ویدیویی پاداش‌دار) را انتخاب کنید و مراحل پیاده‌سازی آن را دنبال کنید.
قبل‌از شروع
برای آماده کردن برنامه‌تان، مراحل بخش‌های زیر را تکمیل کنید.
پیش‌نیازهای برنامه
مطمئن شوید که فایل ساخت برنامه شما از مقادیر زیر استفاده می‌کند:
- حداقل نسخه کیت توسعه نرم‌افزار
24یا بالاتر - نسخه کیت توسعه نرم‌افزار
35یا بالاتر را کامپایل کنید
- حداقل نسخه کیت توسعه نرم‌افزار
- برای برنامه‌های Kotlin، از حداقل نسخه Kotlin 1.9 استفاده کنید.
برنامه‌تان را در حساب AdMob راه‌اندازی کنید
با تکمیل مراحل زیر، برنامه‌تان را به‌عنوان برنامه AdMob ثبت کنید:
به سیستم حساب AdMob وارد شوید یا ثبت‌نام کنید.
برنامه خود را در AdMob ثبت کنید. این مرحله برنامه AdMob را با شناسه برنامه AdMob یکتا ایجاد می‌کند که بعداً در این راهنما به آن نیاز خواهید داشت.
پیکربندی برنامه
در فایل تنظیمات Gradle، مخزن Maven در Google و مخزن مرکزی Maven را اضافه کنید:
Kotlin
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include(":app")
Groovy
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include ':app'
وابستگی‌های GMA Next-Gen SDK را به فایل ساخت سطح برنامه اضافه کنید:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0' }
روی هم‌اکنون همگام‌سازی شود کلیک کنید. برای جزئیات همگام‌سازی، به همگام‌سازی پروژه‌ها با فایل‌های Gradle مراجعه کنید.
مقداردهی اولیه GMA Next-Gen SDK
برای مقداردهی اولیه GMA Next-Gen SDK،
MobileAds.initialize()
تماس بگیرید. این باید در یک رشته پس‌زمینه فراخوانی شود، درغیراین‌صورت ممکن است خطای «برنامه پاسخ نمی‌دهد» (ANR) ایجاد شود.
Kotlin
import com.google.android.libraries.ads.mobile.sdk.MobileAds import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig import kotlinx.coroutines.CoroutineScope import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.launch class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val backgroundScope = CoroutineScope(Dispatchers.IO) backgroundScope.launch { // Initialize GMA Next-Gen SDK on a background thread. MobileAds.initialize( this@MainActivity, // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 InitializationConfig.Builder("SAMPLE_APP_ID").build() ) { // Adapter initialization is complete. } // SDK initialization is complete. If you don't want to wait for bidding adapters to finish // initializing, start loading ads now. } } }
جاوا
import com.google.android.libraries.ads.mobile.sdk.MobileAds; import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig; public class MainActivity extends AppCompatActivity { protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); new Thread( () -> { // Initialize GMA Next-Gen SDK on a background thread. MobileAds.initialize( this, // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 new InitializationConfig.Builder("SAMPLE_APP_ID") .build(), initializationStatus -> { // Adapter initialization is complete. }); // SDK initialization is complete. If you don't want to wait for bidding adapters to // finish initializing, start loading ads now. }) .start(); } }
این روش «کیت توسعه نرم‌افزار» را مقداردهی اولیه می‌کند و پس‌از تکمیل مقداردهی اولیه GMA Next-Gen SDK و آداپتور، یا پس‌از اتمام مهلت ۳۰ ثانیه‌ای، شنونده تکمیل را فرا می‌خواند. این کار فقط یک‌بار باید انجام شود، ترجیحاً در زمان راه‌اندازی برنامه.
اگر از «واسطه‌گری AdMob» استفاده می‌کنید، قبل‌از بار کردن آگهی‌ها، منتظر بمانید تا کنترل‌کننده تکمیل فراخوانی شود. این کار تضمین می‌کند که همه آداپتورهای واسطه‌گری مقداردهی اولیه شوند.
آگهی‌ها ممکن است توسط GMA Next-Gen SDK یا کیت‌های توسعه نرم‌افزار شریک واسطه‌گری
پس‌از مقداردهی اولیه پیش‌بارگیری شوند. اگر باید از کاربران ساکن منطقه اقتصادی اروپا (EEA)، پادشاهی متحد (UK)، یا سوئیس رضایت دریافت کنید، پرچم‌های مختص درخواست را تنظیم کنید، برای نمونه
RequestConfiguration.TagForChildDirectedTreatment
یا
RequestConfiguration.TagForUnderAgeOfConsent،
یا قبل‌از بار کردن آگهی‌ها اقدام دیگری انجام دهید، مطمئن شوید این کار را قبل‌از مقداردهی اولیه GMA Next-Gen SDK انجام دهید.
انتخاب قالب آگهی
GMA Next-Gen SDK اکنون وارد شده است و برای پیاده‌سازی آگهی آماده‌اید. AdMob قالب‌های آگهی مختلفی ارائه می‌دهد، بنابراین می‌توانید قالبی را انتخاب کنید که بهترین تناسب را با تجربه کاربری برنامه‌تان داشته باشد.
برنما
واحدهای آگهی برنمایی آگهی‌های مستطیلی را نمایش می‌دهند که بخشی از چیدمان برنامه را اشغال می‌کنند. می‌توانند پس‌از یک دوره زمانی مشخص به‌طور خودکار بازآوری شوند. این یعنی کاربران در فواصل زمانی منظم آگهی جدیدی را مشاهده می‌کنند، حتی اگر در همان صفحه برنامه شما بمانند. همچنین ساده‌ترین قالب آگهی برای پیاده‌سازی هستند.
بینابینی
واحدهای آگهی بینابینی آگهی‌های تمام‌صفحه را در برنامه شما نشان می‌دهند. آن‌ها را در وقفه‌های طبیعی و گذرهای رابط برنامه، مثل پس‌از تکمیل سطح در برنامه بازی، قرار دهید.
بومی
آگهی‌های بومی آگهی‌هایی هستند که در آن‌ها می‌توانید روش ارائه دارایی‌ها مثل عنوان‌ها و دعوت‌ها به اقدام در برنامه‌هایتان را سفارشی‌سازی کنید. با سبک‌دهی کردن آگهی خودتان، می‌توانید ارائه آگهی طبیعی و نامحسوسی ایجاد کنید که می‌تواند به تجربه کاربری غنی بیفزاید.
پاداش
واحدهای آگهی دارای پاداش به کاربران امکان می‌دهند بازی کنند، در نظرسنجی شرکت کنند، یا ویدیو تماشا کنند تا پاداش‌های درون‌برنامه‌ای مثل سکه، جان اضافی، یا امتیاز کسب کنند. می‌توانید پاداش‌های مختلفی برای واحدهای آگهی مختلف تنظیم کنید و مقادیر پاداش و مواردی را که کاربر دریافت می‌کند مشخص کنید.
بینابینی پاداش‌دار
آگهی میان‌ویدیویی پاداش‌دار نوع جدیدی از قالب آگهی انگیزشی است که به شما امکان می‌دهد برای آگهی‌هایی که به‌طور خودکار درطول انتقال‌های طبیعی برنامه نمایش داده می‌شوند، پاداش‌هایی مثل سکه یا جان اضافه ارائه دهید.
برخلاف آگهی‌های دارای پاداش، کاربران ملزم به موافقت برای مشاهده آگهی بینابینی دارای پاداش نیستند.
به‌جای پیام‌واره موافقت در آگهی‌های دارای پاداش، میان‌آگهی‌های دارای پاداش به صفحه مقدماتی نیاز دارند که پاداش را اعلام کند و به کاربران فرصت دهد درصورت تمایل انصراف دهند.
پیاده‌سازی آگهی‌های بینابینی پاداش‌دار
صفحه باز شدن برنامه
آگهی باز کردن برنامه قالب آگهی‌ای است که وقتی کاربران برنامه شما را باز می‌کنند یا به آن برمی‌گردند نمایش داده می‌شود. آگهی روی صفحه بارگیری قرار می‌گیرد.
پیاده‌سازی آگهی‌های در صفحه باز شدن برنامه
تصویردرتصویر (نسخه بتا)
آگهی‌های تصویردرتصویر (PiP) آگهی را در پنجره‌ای شناور نمایش می‌دهند که در بالای محتوای روی صفحه باقی می‌ماند. این قالب به کاربران شما امکان می‌دهد با برنامه‌تان تعامل داشته باشند درحالی‌که آگهی همچنان رؤیت‌پذیر است.
پیاده‌سازی آگهی‌های تصویردرتصویر