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

کاتلین | جاوا

public class MobileAds

---

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

خلاصه

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

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

ثابت ها

ERROR_DOMAIN

public static final String ERROR_DOMAIN = "com.google.android.gms.ads"

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

روش های عمومی

DisableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

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

getInitializationStatus

public static @Nullable InitializationStatus getInitializationStatus()

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

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

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

getVersion

public static VersionInfo getVersion()

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

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

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

@RequiresPermission(value = Manifest.permission.INTERNET)
public static void initialize(Context context)

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

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

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

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

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

public static void initialize(Context context, OnInitializationCompleteListener listener)

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

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

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

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

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

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

OpenDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

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

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

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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

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

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

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

registerCustomTabsSession

public static @Nullable CustomTabsSession registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

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

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

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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

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

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

setAppVolume

public static void setAppVolume(float volume)

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

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

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

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

setRequestConfiguration

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

public static void startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

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

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

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