Мобильная реклама

Kotlin | Java

class MobileAds

---

Класс содержит логику, которая применяется ко всему SDK Google Mobile Ads. В настоящий момент единственные методы в нем используются для инициализации.

Краткое содержание

Константы
const String !	ERROR_DOMAIN = "com.google.android.gms.ads" Доменное имя по умолчанию для ошибок в SDK мобильной рекламы Google.

Общественные функции
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 !) Инициализирует SDK для мобильной рекламы Google.
java-static Unit	initialize (context: Context !, listener: OnInitializationCompleteListener !) Инициализирует SDK для мобильной рекламы Google.
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 в SDK Google Mobile Ads для улучшения монетизации рекламы внутри приложения, размещаемой в рамках этой CustomTabsSession .
java-static Unit	registerWebView (webview: WebView ) Регистрирует WebView в SDK Google Mobile Ads для улучшения монетизации рекламы внутри 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 ) Эта функция устарела. Используйте start или start вместо этого.

Константы

ERROR_DOMAIN

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

Доменное имя по умолчанию для ошибок в SDK мобильной рекламы Google.

Общественные функции

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 ).

получитьВерсию

java-static fun getVersion(): VersionInfo!

Получает внешнюю версию (например, 20.6.0) SDK для мобильной рекламы Google.

Вызов initialize перед этой функцией не требуется.

инициализировать

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

Инициализирует SDK для мобильной рекламы Google.

Вызывайте этот метод как можно раньше после запуска приложения, чтобы уменьшить задержку при первом запросе рекламы в рамках сессии.

Если этот метод не вызывается, первый запрос объявления автоматически инициализирует SDK Google Mobile Ads.

Параметры
context: Context !	Context в котором работает SDK.

инициализировать

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

Инициализирует SDK для мобильной рекламы Google.

Вызывайте этот метод как можно раньше после запуска приложения, чтобы уменьшить задержку при первом запросе рекламы в рамках сессии.

Если этот метод не вызывается, первый запрос объявления автоматически инициализирует SDK Google Mobile Ads.

Параметры
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	Логическое значение: true, если включен идентификатор издателя, false в противном случае.

Возвраты
Boolean	Возвращает true, если решение успешно сохранено. Возвращает false, если сохранение не удалось.

registerCustomTabsSession

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

Регистрирует объект CustomTabsClient в SDK Google Mobile Ads для улучшения монетизации рекламы внутри приложения в рамках этой CustomTabsSession . Будет создан только один экземпляр CustomTabsSession , и повторный запуск перезапишет существующую сессию.

Параметры
context: Context	Context в котором работает SDK.
client: CustomTabsClient	CustomTabsClient используется для создания экземпляра CustomTabsSession .
origin: String	Строка, используемая в качестве исходного значения в ссылке на цифровой актив для проверки.
callback: CustomTabsCallback ?	Необязательный CustomTabsCallback для получения обратных вызовов от CustomTabsSession .

Возвраты
CustomTabsSession ?	Экземпляр CustomTabsSession будет использоваться для Intent Custom Tabs при открытии страницы с пользовательскими вкладками.

registerWebView

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

Регистрирует WebView в SDK Google Mobile Ads для улучшения монетизации рекламы внутри 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	Громкость задается числом с плавающей запятой от 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

Эта функция устарела.

Используйте start или start вместо этого.

Запускает предварительную загрузку рекламы для заданных конфигураций.

API для предварительной загрузки рекламы находятся на стадии ограниченной альфа-версии. Для получения дополнительной информации обратитесь к своему менеджеру по работе с клиентами.

Параметры
context: Context	Context в котором работает SDK.
preloadConfigurations: ( Mutable ) List < PreloadConfiguration !>	Настройки для предварительной загрузки рекламы.
preloadCallback: PreloadCallback	Функция обратного вызова, которая будет вызываться при изменении доступности рекламы для каждой конфигурации предварительной загрузки.