Эта страница переведена с помощью 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 )` Начинает предварительную загрузку рекламы для заданных конфигураций.

Константы

ОШИБКА_ДОМЕН

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

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

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

отключитьMediationAdapterInitialization

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

Открывает интерфейс инспектора объявлений.

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

Открывает меню отладки. initialize должна быть вызвана до этой функции.

Параметры
`Context context`	`Context` активности, в котором работает SDK.
`String adUnitId`	Любой идентификатор рекламного блока Менеджера рекламы, связанный с вашим приложением.

путпублишерфирстпатииденаблед

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

Определяет, включен ли собственный идентификатор издателя Google Mobile Ads SDK, ранее известный как тот же ключ приложения.

Идентификатор включен по умолчанию. Если этот параметр отключен, параметр сохраняется во всех сеансах приложения, а идентификатор очищается.

initialize должна быть вызвана до этой функции.

Параметры
`boolean enabled`	boolean true, если собственный идентификатор издателя включен, в противном случае — false.

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

РегистрацияCustomTabsSession

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. По умолчанию ложь.

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