تبلیغات موبایلی

کاتلین | جاوا

class MobileAds

---

کلاس شامل منطقی است که در کل برای Google Mobile Ads SDK اعمال می شود. در حال حاضر، تنها روش های موجود در آن برای مقداردهی اولیه استفاده می شود.

خلاصه

ثابت ها
const String !	ERROR_DOMAIN = "com.google.android.gms.ads" نام دامنه خطای پیش‌فرض برای Google Mobile Ads SDK.

توابع عمومی
java-static Unit	disableMediationAdapterInitialization (context: Context !) قبل از initialize یا اولین درخواست آگهی برای غیرفعال کردن مقداردهی اولیه آداپتور میانجی تماس بگیرید.
java-static InitializationStatus ?	getInitializationStatus () وضعیت اولیه سازی SDK را دریافت می کند.
java-static RequestConfiguration	getRequestConfiguration () RequestConfiguration جهانی را دریافت می کند.
java-static VersionInfo !	getVersion () نسخه خارجی (به عنوان مثال، 20.6.0) SDK تبلیغات تلفن همراه Google را دریافت می کند.
java-static Unit	@ RequiresPermission (value = Manifest.permission.INTERNET) initialize (context: Context !) Google Mobile Ads SDK را راه‌اندازی می‌کند.
java-static Unit	initialize (context: Context !, listener: OnInitializationCompleteListener !) Google Mobile Ads SDK را راه‌اندازی می‌کند.
java-static Unit	openAdInspector (context: Context !, listener: OnAdInspectorClosedListener !) رابط کاربری بازرس آگهی را باز می کند.
java-static Unit	openDebugMenu (context: Context !, adUnitId: String !) منوی اشکال زدایی را باز می کند.
java-static Boolean	putPublisherFirstPartyIdEnabled (enabled: Boolean ) فعال بودن شناسه شخص اول ناشر Google Mobile Ads SDK را که قبلاً همان کلید برنامه شناخته می شد، کنترل می کند.
java-static CustomTabsSession ?	registerCustomTabsSession ( context: Context , client: CustomTabsClient , origin: String , callback: CustomTabsCallback ? ) یک CustomTabsClient با Google Mobile Ads SDK ثبت می کند تا درآمدزایی تبلیغات درون برنامه ای از تبلیغات را در این CustomTabsSession بهبود بخشد.
java-static Unit	registerWebView (webview: WebView ) WebView با Google Mobile Ads SDK ثبت می‌کند تا کسب درآمد از تبلیغات درون برنامه‌ای از تبلیغات در این WebView را بهبود بخشد.
java-static Unit	setAppMuted (muted: Boolean ) نشان می دهد که آیا صدای برنامه قطع شده است یا خیر.
java-static Unit	setAppVolume (volume: Float ) میزان صدای برنامه را تنظیم می کند.
java-static Unit	setRequestConfiguration (requestConfiguration: RequestConfiguration ) RequestConfiguration جهانی را تنظیم می کند که برای هر AdRequest در طول جلسه برنامه استفاده می شود.
java-static Unit	startPreload ( context: Context , preloadConfigurations: ( Mutable ) List < PreloadConfiguration !>, preloadCallback: PreloadCallback ) شروع به بارگذاری تبلیغات برای تنظیمات داده شده می کند.

ثابت ها

ERROR_DOMAIN

const val ERROR_DOMAIN = "com.google.android.gms.ads": String!

نام دامنه خطای پیش‌فرض برای Google Mobile Ads SDK.

توابع عمومی

DisableMediationAdapterInitialization

java-static fun disableMediationAdapterInitialization(context: Context!): Unit

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

هشدار: فراخوانی این روش ممکن است بر عملکرد میانجیگری شما تأثیر منفی بگذارد. این روش فقط در صورتی باید فراخوانی شود که آداپتورهای میانجی را در برنامه خود قرار دهید، اما قصد ندارید از میانجیگری Google در این جلسه برنامه استفاده کنید (مثلاً در حال اجرای یک آزمایش A/B هستید).

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

وضعیت اولیه سازی SDK را دریافت می کند.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

RequestConfiguration جهانی را دریافت می کند.

getVersion

java-static fun getVersion(): VersionInfo!

نسخه خارجی (به عنوان مثال، 20.6.0) SDK تبلیغات تلفن همراه Google را دریافت می کند.

initialize نیازی به فراخوانی قبل از این تابع نیست.

مقداردهی اولیه

@RequiresPermission(value = Manifest.permission.INTERNET)
java-static fun initialize(context: Context!): Unit

Google Mobile Ads SDK را راه‌اندازی می‌کند.

برای کاهش تأخیر در اولین درخواست تبلیغ جلسه، هر چه زودتر پس از راه اندازی برنامه، این روش را فراخوانی کنید.

اگر این روش فراخوانی نشود، اولین درخواست آگهی به طور خودکار Google Mobile Ads SDK را مقداردهی اولیه می کند.

پارامترها
context: Context !	Context SDK در آن اجرا می شود.

مقداردهی اولیه

java-static fun initialize(context: Context!, listener: OnInitializationCompleteListener!): Unit

Google Mobile Ads SDK را راه‌اندازی می‌کند.

برای کاهش تأخیر در اولین درخواست تبلیغ جلسه، هر چه زودتر پس از راه اندازی برنامه، این روش را فراخوانی کنید.

اگر این روش فراخوانی نشود، اولین درخواست آگهی به طور خودکار Google Mobile Ads SDK را مقداردهی اولیه می کند.

پارامترها
context: Context !	Context فعالیت که SDK در آن اجرا می شود.
listener: OnInitializationCompleteListener !	یک فراخوانی که پس از اتمام اولیه سازی فراخوانی می شود.

openAdInspector

java-static fun openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!): Unit

رابط کاربری بازرس آگهی را باز می کند.

OpenDebugMenu

java-static fun openDebugMenu(context: Context!, adUnitId: String!): Unit

منوی اشکال زدایی را باز می کند. initialize باید قبل از این تابع فراخوانی شود.

پارامترها
context: Context !	Context فعالیت که SDK در آن اجرا می شود.
adUnitId: String !	هر شناسه واحد تبلیغات Ad Manager مرتبط با برنامه شما.

putPublisherFirstPartyIdEnabled

java-static fun putPublisherFirstPartyIdEnabled(enabled: Boolean): Boolean

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

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

initialize باید قبل از این تابع فراخوانی شود.

پارامترها
enabled: Boolean	اگر شناسه شخص اول ناشر فعال باشد، درست است، در غیر این صورت نادرست است.

برمی گرداند
Boolean	درست است اگر تصمیم با موفقیت ادامه یابد. اگر ادامه پیدا نکند نادرست است.

registerCustomTabsSession

java-static fun registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
): CustomTabsSession?

یک CustomTabsClient با Google Mobile Ads SDK ثبت می کند تا درآمدزایی تبلیغات درون برنامه ای از تبلیغات را در این CustomTabsSession بهبود بخشد. این فقط یک نمونه از CustomTabsSession ایجاد می کند و اجرای مجدد آن جلسه موجود را لغو می کند.

پارامترها
context: Context	Context SDK در آن اجرا می شود.
client: CustomTabsClient	CustomTabsClient برای ایجاد نمونه CustomTabsSession استفاده می شود.
origin: String	رشته به عنوان مبدا در پیوند دارایی دیجیتال برای تأیید استفاده می شود.
callback: CustomTabsCallback ?	CustomTabsCallback اختیاری برای دریافت پاسخ تماس از .

برمی گرداند
CustomTabsSession ?	نمونه CustomTabsSession برای استفاده از Custom Tabs Intent هنگام باز کردن صفحه Custom Tabs.

registerWebView

java-static fun registerWebView(webview: WebView): Unit

WebView با Google Mobile Ads SDK ثبت می‌کند تا کسب درآمد از تبلیغات درون برنامه‌ای از تبلیغات در این WebView را بهبود بخشد.

setAppMuted

java-static fun setAppMuted(muted: Boolean): Unit

نشان می دهد که آیا صدای برنامه قطع شده است یا خیر. بر وضعیت بی صدا اولیه برای همه تبلیغات تأثیر می گذارد.

هشدار: نادیده گرفتن برنامه شما واجد شرایط بودن تبلیغات ویدیویی را کاهش می دهد و ممکن است درآمد تبلیغات برنامه شما را کاهش دهد. فقط در صورتی باید از این API استفاده کنید که برنامه شما یک کنترل بی‌صدا سفارشی برای کاربر ارائه دهد و باید تصمیم کاربر را در این API منعکس کنید.

پارامترها
muted: Boolean	درست است اگر برنامه بی صدا باشد، در غیر این صورت نادرست است. پیش فرض به نادرست.

setAppVolume

java-static fun setAppVolume(volume: Float): Unit

میزان صدای برنامه را تنظیم می کند. بر حجم صدای همه تبلیغات نسبت به سایر خروجی های صوتی تأثیر می گذارد.

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

پارامترها
volume: Float	حجم به صورت شناور از 0 (بی صدا) تا 1.0 (صدای رسانه کامل). پیش‌فرض 1.0 است

پرتاب می کند
java.lang.IllegalArgumentException	اگر حجم صدا خارج از محدوده معتبر باشد

setRequestConfiguration

java-static fun setRequestConfiguration(requestConfiguration: RequestConfiguration): Unit

RequestConfiguration جهانی را تنظیم می کند که برای هر AdRequest در طول جلسه برنامه استفاده می شود.

startPreload

java-static fun startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
): Unit

شروع به بارگذاری تبلیغات برای تنظیمات داده شده می کند.

APIهای پیش بارگیری تبلیغات در آلفای محدود هستند. لطفاً برای اطلاعات بیشتر با مدیر حساب خود تماس بگیرید.

پارامترها
context: Context	Context SDK در آن اجرا می شود.
preloadConfigurations: ( Mutable ) List < PreloadConfiguration !>	تنظیمات برای پیش بارگیری تبلیغات
preloadCallback: PreloadCallback	هنگامی که در دسترس بودن آگهی برای هر پیکربندی پیش بارگیری تغییر می کند، یک تماس برگشتی فراخوانی می شود.