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

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

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) Google Mobile Ads SDK.
`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 )` Этот метод устарел. Вместо этого используйте start или start.

Константы

ERROR_DOMAIN

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

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

Публичные методы

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

public static void disableMediationAdapterInitialization(Context context)

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

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

получитьInitializationStatus

public static @Nullable InitializationStatus getInitializationStatus()

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

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

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

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

public static VersionInfo getVersion()

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

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

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

открытьDebugMenu

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

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

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

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

public static void registerWebView(@NonNull WebView webview)

Регистрирует WebView в Google Mobile Ads SDK для улучшения монетизации рекламы в приложении в рамках этого 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`	Обратный вызов, который будет вызван при изменении доступности рекламы для каждой конфигурации предварительной загрузки.