ادغام Google Mobile Ads SDK در یک برنامه اولین قدم برای نمایش تبلیغات و کسب درآمد است. هنگامی که SDK را ادغام کردید، میتوانید یک قالب تبلیغاتی (مانند ویدیوی بومی یا جایزه دار) را انتخاب کنید و مراحل اجرای آن را دنبال کنید.
قبل از اینکه شروع کنی
برای آماده سازی اپلیکیشن خود، مراحل زیر را انجام دهید.
پیش نیازهای اپلیکیشن
مطمئن شوید که فایل ساخت برنامه شما از مقادیر زیر استفاده می کند:
-
minSdkVersion
19
یا بالاتر -
compileSdkVersion
33
یا بالاتر
-
برنامه خود را در حساب AdMob خود تنظیم کنید
با انجام مراحل زیر، برنامه خود را به عنوان یک برنامه AdMob ثبت کنید:
به یک حساب AdMob وارد شوید یا برای آن ثبت نام کنید .
برنامه خود را با AdMob ثبت کنید . این مرحله یک برنامه AdMob با شناسه برنامه AdMob منحصر به فرد ایجاد می کند که در ادامه این راهنما مورد نیاز است.
برنامه خود را پیکربندی کنید
در فایل
build.gradle
در سطح پروژه خود، مخزن Maven Google و مخزن مرکزی Maven را در هر دو بخشbuildscript
وallprojects
قرار دهید:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
وابستگیهای Google Mobile Ads SDK را به فایل Gradle سطح برنامه ماژول خود اضافه کنید، معمولا
app/build.gradle
:dependencies { implementation 'com.google.android.gms:play-services-ads:22.5.0' }
شناسه برنامه AdMob خود را، همانطور که در رابط وبAdMobمشخص شده است ، به فایل
AndroidManifest.xml
برنامه خود اضافه کنید. برای انجام این کار، یک تگ<meta-data>
باandroid:name="com.google.android.gms.ads.APPLICATION_ID"
اضافه کنید. می توانید شناسه برنامه خود را در رابط وب AdMob پیدا کنید. برایandroid:value
، شناسه برنامه AdMob خود را که با علامت نقل قول احاطه شده است، وارد کنید.<manifest> <application> <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 --> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> </application> </manifest>
در یک برنامه واقعی، از شناسه برنامه واقعی AdMob خود استفاده کنید، نه از شناسه ذکر شده در بالا. اگر فقط به دنبال آزمایش با SDK در یک برنامه Hello World هستید، می توانید از نمونه شناسه برنامه نشان داده شده در بالا استفاده کنید.
همچنین توجه داشته باشید که عدم اضافه کردن تگ
<meta-data>
همانطور که در بالا نشان داده شده است منجر به خرابی پیام می شود:The Google Mobile Ads SDK was initialized incorrectly.
(اختیاری) مجوز
AD_ID
را برای نسخههای قبلی برای کار با Android 13 اعلام کنید.اگر برنامه شما از Google Mobile Ads SDK نسخه 20.4.0 یا بالاتر استفاده میکند، میتوانید این مرحله را رد کنید زیرا SDK بهطور خودکار مجوز
com.google.android.gms.permission.AD_ID
را اعلام میکند و میتواند هر زمان که شناسه تبلیغات در دسترس باشد به آن دسترسی پیدا کند. .برای برنامههایی که از Google Mobile Ads SDK نسخه 20.3.0 یا پایینتر استفاده میکنند و Android 13 را هدف قرار میدهند، باید مجوز
com.google.android.gms.permission.AD_ID
را در فایلAndroidManifest.xml
برای Google Mobile Ads SDK اضافه کنید. دسترسی به شناسه تبلیغات:<manifest> <application> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower --> <uses-permission android:name="com.google.android.gms.permission.AD_ID"/> </application> </manifest>
برای کسب اطلاعات بیشتر در مورد اعلامیه مجوز
com.google.android.gms.permission.AD_ID
، از جمله نحوه غیرفعال کردن آن، لطفاً به این مقاله کنسول Play مراجعه کنید.
Google Mobile Ads SDK را راهاندازی کنید
قبل از بارگیری تبلیغات، از برنامه خود بخواهید با فراخوانی MobileAds.initialize()
که SDK را مقداردهی اولیه می کند و پس از تکمیل اولیه یا پس از 30 ثانیه وقفه، شنونده تکمیل را فراخوانی کند. این کار باید فقط یک بار انجام شود، ایده آل در هنگام راه اندازی برنامه.
تبلیغات ممکن است با تماس با MobileAds.initialize()
توسط Google Mobile Ads SDK یا SDK های شریک واسطه بارگذاری شوند. اگر نیاز به دریافت رضایت از کاربران در منطقه اقتصادی اروپا (EEA) دارید، هر گونه پرچمهای خاص درخواست را تنظیم کنید، مانند tagForChildDirectedTreatment
یا tag_for_under_age_of_consent
، یا در غیر این صورت قبل از بارگیری تبلیغات اقدامی انجام دهید، مطمئن شوید که این کار را قبل از راهاندازی SDK تبلیغات تلفن همراه Google انجام دهید.
در اینجا مثالی از نحوه فراخوانی متد initialize()
در یک Activity آورده شده است:
مثال MainActivity (گزیده)
جاوا
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
public class MainActivity extends AppCompatActivity {
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
MobileAds.initialize(this, new OnInitializationCompleteListener() {
@Override
public void onInitializationComplete(InitializationStatus initializationStatus) {
}
});
}
}
کاتلین
import com.google.android.gms.ads.MobileAds
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
MobileAds.initialize(this) {}
}
}
اگر از میانجیگری استفاده میکنید، منتظر بمانید تا کنترلکننده تکمیل قبل از بارگیری تبلیغات فراخوانی شود، زیرا این کار باعث میشود که همه آداپتورهای میانجی اولیه اولیه شوند.
یک قالب تبلیغاتی را انتخاب کنید
Google Mobile Ads SDK اکنون وارد شده است و شما آماده اجرای یک تبلیغ هستید.AdMob تعدادی قالب تبلیغاتی مختلف ارائه میدهد، بنابراین میتوانید یکی را انتخاب کنید که با تجربه کاربری برنامهتان مطابقت دارد.
بنر
تبلیغات مستطیلی که در بالا یا پایین صفحه نمایش دستگاه ظاهر می شوند. تبلیغات بنری در حالی که کاربران در حال تعامل با برنامه هستند روی صفحه می مانند و می توانند پس از مدت زمان معینی به طور خودکار بازخوانی شوند. اگر در زمینه تبلیغات موبایلی تازه کار هستید، آنها مکان خوبی برای شروع هستند.
بینابینی
تبلیغات تمام صفحه که رابط یک برنامه را تا زمانی که توسط کاربر بسته شود پوشش می دهند. آنها به بهترین وجه در توقف های طبیعی در جریان اجرای برنامه، مانند بین سطوح یک بازی یا درست پس از اتمام یک کار، استفاده می شوند.
بومی
تبلیغات قابل تنظیم که با ظاهر و احساس برنامه شما مطابقت دارند. شما تصمیم می گیرید که چگونه و در کجا قرار گیرند، بنابراین طرح بندی با طراحی برنامه شما سازگارتر است.
تبلیغات بومی را پیاده سازی کنید
پاداش داده شد
تبلیغاتی که به کاربران برای تماشای ویدیوهای کوتاه و تعامل با تبلیغات و نظرسنجیهای قابل پخش پاداش میدهد. برای کسب درآمد از برنامه های بازی رایگان استفاده می شود.
منابع اضافی
مخزن Google Mobile Ads در GitHub نحوه استفاده از قالبهای تبلیغاتی مختلف را که این API ارائه میدهد، نشان میدهد.