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

class MobileAds

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

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

Константы

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

Доменное имя ошибки по умолчанию для Google Mobile Ads SDK.

Публичные функции

java-static Unit

Вызовите перед initialize или первым запросом объявления, чтобы отключить инициализацию адаптера-посредника.

java-static InitializationStatus ?

Получает статус инициализации SDK.

java-static RequestConfiguration

Получает глобальный RequestConfiguration .

java-static VersionInfo !

Получает внешнюю версию (например, 20.6.0) Google Mobile Ads SDK.

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

Инициализирует Google Mobile Ads SDK.

java-static Unit

Инициализирует Google Mobile Ads SDK.

java-static Unit

Открывает пользовательский интерфейс инспектора рекламы.

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

Открывает меню отладки.

java-static 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

Регистрирует WebView в Google Mobile Ads SDK для улучшения монетизации рекламы в приложении в рамках этого WebView .

java-static Unit
setAppMuted (muted: Boolean )

Указывает, отключен ли звук приложения.

java-static Unit
setAppVolume (volume: Float )

Устанавливает громкость звука приложения.

java-static Unit

Устанавливает глобальную 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!

Доменное имя ошибки по умолчанию для Google Mobile Ads SDK.

Публичные функции

отключитьИнициализациюАдаптераПосредничества 

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

Вызовите перед initialize или первым запросом рекламы, чтобы отключить инициализацию адаптера-посредника. Этот метод является пустым после initialize или первого запроса рекламы.

Предупреждение: Вызов этого метода может негативно повлиять на производительность вашей медиации. Этот метод следует вызывать только в том случае, если вы включаете адаптеры медиации в свое приложение, но не планируете использовать медиацию Google во время этого сеанса приложения (например, вы проводите A/B-тестирование).

получитьInitializationStatus 

java-static fun getInitializationStatus(): InitializationStatus?

Получает статус инициализации SDK.

getRequestConfiguration 

java-static fun getRequestConfiguration(): RequestConfiguration

Получает глобальный RequestConfiguration .

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

java-static fun getVersion(): VersionInfo!

Получает внешнюю версию (например, 20.6.0) Google Mobile Ads SDK.

Перед этой функцией не нужно вызывать 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

Открывает пользовательский интерфейс инспектора рекламы.

открытьDebugMenu 

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

Возвраты
Boolean

true, если решение успешно сохранено. False, если не удалось сохранить.

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 , который будет использоваться для намерения пользовательских вкладок при открытии страницы пользовательских вкладок.

регистрацияWebView 

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

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

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

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

Параметры
context: Context

Context в котором работает SDK.

preloadConfigurations: ( Mutable ) List < PreloadConfiguration !>

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

preloadCallback: PreloadCallback

Обратный вызов, который будет вызван при изменении доступности рекламы для каждой конфигурации предварительной загрузки.