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

class MobileAds

Class contains logic that applies to the Google Mobile Ads SDK as a whole. Right now, the only methods in it are used for initialization.

خلاصه

ثابت‌ها

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

Default error domain name for the Google Mobile Ads SDK.

کارکردهای عمومی

java-static Unit

Call before initialize or the first ad request to disable mediation adapter initialization.

java-static InitializationStatus ?

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

java-static RequestConfiguration

RequestConfiguration سراسری را دریافت می‌کند.

java-static VersionInfo !

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

java-static Unit

Initializes the Google Mobile Ads SDK.

java-static Unit

Initializes the Google Mobile Ads SDK.

java-static Unit

Opens the ad inspector UI.

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

منوی اشکال‌زدایی را باز می‌کند.

java-static Boolean

Controls whether the Google Mobile Ads SDK publisher first-party ID, formerly known as the same app key, is enabled.

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

یک CustomTabsClient را با SDK تبلیغات موبایلی گوگل ثبت می‌کند تا کسب درآمد از تبلیغات درون برنامه‌ای را در این CustomTabsSession بهبود بخشد.

java-static Unit

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

java-static Unit
setAppMuted (muted: Boolean )

نشان می‌دهد که آیا صدای برنامه قطع شده است یا خیر.

java-static Unit
setAppVolume (volume: Float )

Sets the application's audio volume.

java-static Unit

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

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

این تابع منسوخ شده است.

Use start or start instead.

ثابت‌ها

ERROR_DOMAIN 

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

نام دامنه‌ی پیش‌فرض خطا برای SDK تبلیغات موبایلی گوگل.

کارکردهای عمومی

disableMediationAdapterInitialization 

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

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

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

دریافت وضعیت مقداردهی اولیه 

java-static fun getInitializationStatus(): InitializationStatus?

Gets the SDK initialization status.

getRequestConfiguration 

java-static fun getRequestConfiguration(): RequestConfiguration

Gets the global RequestConfiguration .

getVersion 

java-static fun getVersion(): VersionInfo!

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

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

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

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

Initializes the Google Mobile Ads SDK.

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

اگر این متد فراخوانی نشود، اولین درخواست تبلیغ به طور خودکار SDK تبلیغات موبایلی گوگل را مقداردهی اولیه می‌کند.

پارامترها
context: Context !

The Context the SDK is running in.

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

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

Initializes the Google Mobile Ads SDK.

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

اگر این متد فراخوانی نشود، اولین درخواست تبلیغ به طور خودکار SDK تبلیغات موبایلی گوگل را مقداردهی اولیه می‌کند.

پارامترها
context: Context !

The activity Context the SDK is running in.

listener: OnInitializationCompleteListener !

یک فراخوانی برگشتی که پس از اتمام مقداردهی اولیه فراخوانی می‌شود.

openAdInspector 

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

Opens the ad inspector UI.

openDebugMenu 

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

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

پارامترها
context: Context !

The activity Context the SDK is running in.

adUnitId: String !

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

putPublisherFirstPartyIdEnabled 

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

کنترل می‌کند که آیا شناسه شخص ثالث ناشر SDK تبلیغات موبایل گوگل، که قبلاً با نام همان کلید برنامه شناخته می‌شد، فعال باشد یا خیر.

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

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

پارامترها
enabled: Boolean

اگر شناسه‌ی شخص اول ناشر فعال باشد، مقدار بولی true و در غیر این صورت false خواهد بود.

بازگشت‌ها
Boolean

اگر تصمیم با موفقیت حفظ شود، مقدار true و اگر حفظ نشود، مقدار false برمی‌گرداند.

registerCustomTabsSession 

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

یک CustomTabsClient را با SDK تبلیغات موبایلی گوگل ثبت می‌کند تا کسب درآمد از تبلیغات درون برنامه‌ای را در این CustomTabsSession بهبود بخشد. این کار فقط یک نمونه از CustomTabsSession ایجاد می‌کند و اجرای مجدد آن، session موجود را لغو می‌کند.

پارامترها
context: Context

Context SDK در آن اجرا می‌شود.

client: CustomTabsClient

CustomTabsClient used to create the CustomTabsSession instance.

origin: String

رشته‌ای که به عنوان مبدا در پیوند دارایی دیجیتال برای تأیید استفاده می‌شود.

callback: CustomTabsCallback ?

CustomTabsCallback اختیاری برای دریافت فراخوانی‌های مجدد از CustomTabsSession .

بازگشت‌ها
CustomTabsSession ?

نمونه‌ای از CustomTabsSession که برای نمایش تب‌های سفارشی هنگام باز کردن یک صفحه تب‌های سفارشی استفاده می‌شود.

registerWebView 

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

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

setAppMuted 

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

نشان می‌دهد که آیا صدای برنامه بی‌صدا است یا خیر. روی حالت بی‌صدای اولیه برای همه تبلیغات تأثیر می‌گذارد.

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

پارامترها
muted: Boolean

اگر برنامه بی‌صدا باشد، مقدار true و در غیر این صورت false است. مقدار پیش‌فرض false است.

setAppVolume 

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

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

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

پارامترها
volume: Float

the volume as a float from 0 (muted) to 1.0 (full media volume). Defaults to 1.0

پرتاب‌ها
java.lang.IllegalArgumentException

if volume is out of the valid range

setRequestConfiguration 

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

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

startPreload 

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

Starts preloading ads for the given configurations.

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

پارامترها
context: Context

Context SDK در آن اجرا می‌شود.

preloadConfigurations: ( Mutable ) List < PreloadConfiguration !>

The configurations to preload ads.

preloadCallback: PreloadCallback

A callback to be invoked when ad availability changes for each preload configuration.