Эта страница переведена с помощью Cloud Translation API.

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

Kotlin | Java

public class MobileAds

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

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

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

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

Константы

ERROR_DOMAIN

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

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

Общедоступные методы

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

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

public static VersionInfo getVersion()

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

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

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

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

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

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

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

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

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

public static void initialize(Context context, OnInitializationCompleteListener listener)

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

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

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

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

registerCustomTabsSession

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

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

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

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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

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

Параметры
`boolean muted`	Значение true, если приложение отключено, false в противном случае. По умолчанию — false.

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