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

Межстраничная реклама

Kotlin | Java

public abstract class InterstitialAd

Известные прямые подклассы : AdManagerInterstitialAd

AdManagerInterstitialAd

Для издателей Google Ad Manager полностраничная реклама, демонстрируемая в естественных точках перехода, таких как смена страницы, запуск приложения или загрузка уровня игры.

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

Пример кода:

public class MyActivity extends Activity {
    private InterstitialAd interstitialAd;
    private Button nextLevelButton;
    private TextView textView;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // Create a full screen content callback.
        FullScreenContentCallback fullScreenContentCallback = new FullScreenContentCallback() {
            @Override
            public void onAdDismissedFullScreenContent() {
               interstitialAd = null;
               // Proceed to the next level.
               goToNextLevel();
            }
        };

        // Load an interstitial ad. When a natural transition in the app occurs (such as a level
        // ending in a game), show the interstitial. In this simple example, the press of a
        // button is used instead.
        //
        // If the button is clicked before the interstitial is loaded, the user should proceed to
        // the next part of the app (in this case, the next level).
        //
        // If the interstitial is finished loading, the user will view the interstitial before
        // proceeding.
        InterstitialAd.load(
            this,
            "myAdUnitId",
            new AdRequest.Builder().build(),
            new InterstitialAdLoadCallback() {
                @Override
                public void onAdLoaded(@NonNull InterstitialAd ad) {
                    interstitialAd = ad;
                    interstitialAd.setFullScreenContentCallback(fullScreenContentCallback);
                }

                @Override
                public void onAdFailedToLoad(@NonNull LoadAdError adError) {
                    // Code to be executed when an ad request fails.
                }
            });

        // Create the button to go to the next level.
        nextLevelButton = new Button(this);
        nextLevelButton.setText("Next Level");
        nextLevelButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                // Show the interstitial if it is ready. Otherwise, proceed to the next level
                // without ever showing it.
                if (interstitialAd != null) {
                    interstitialAd.show(MyActivity.this);
                } else {
                    // Proceed to the next level.
                    goToNextLevel();
                }
            }
        });

        // Add the next level button to the layout.
        LinearLayout layout = new LinearLayout(this);
        layout.setOrientation(LinearLayout.VERTICAL);
        layout.addView(nextLevelButton);

        // Create a TextView to display the current level.
        textView = new TextView(this);
        textView.setText("Level 1");
        layout.addView(textView);

        setContentView(layout);
    }

    public void goToNextLevel() {
        // Show the next level, and disable the next level button since there are no more levels.
        nextLevelButton.setEnabled(false);
        textView.setText("Level 2");
    }
}

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

Государственные строители
`InterstitialAd ()`

Общедоступные методы
`abstract @ NonNull String`	`getAdUnitId ()` Возвращает идентификатор рекламного блока.
`abstract @ Nullable FullScreenContentCallback`	`getFullScreenContentCallback ()` Получает вызов `FullScreenContentCallback` для этого `InterstitialAd` .
`abstract @ Nullable OnPaidEventListener`	`getOnPaidEventListener ()` Получает `OnPaidEventListener` для этой `InterstitialAd` .
`abstract long`	`getPlacementId ()` Возвращает идентификатор размещения для этого `InterstitialAd` .
`abstract @ NonNull ResponseInfo`	`getResponseInfo ()` Возвращает объект `ResponseInfo` для загруженного объявления.
`static boolean`	`isAdAvailable (@ NonNull Context context, @ NonNull String adUnitId)` Этот метод устарел. Вместо этого используйте `isAdAvailable` .
`static void`	`load ( @ NonNull Context context, @ NonNull String adUnitId, @ NonNull AdRequest adRequest, @ NonNull InterstitialAdLoadCallback loadCallback )` Загружает `InterstitialAd` .
`static @ Nullable InterstitialAd`	`pollAd (@ NonNull Context context, @ NonNull String adUnitId)` Этот метод устарел. Вместо этого используйте `pollAd` .
`abstract void`	`setFullScreenContentCallback ( @ Nullable FullScreenContentCallback fullScreenContentCallback )` Регистрирует функцию обратного вызова, которая будет вызываться при показе рекламы и закрытии полноэкранного контента.
`abstract void`	`setImmersiveMode (boolean immersiveModeEnabled)` Устанавливает флаг, определяющий, будет ли этот промежуточный объект отображаться в иммерсивном режиме.
`abstract void`	`setOnPaidEventListener (@ Nullable OnPaidEventListener listener)` Регистрирует функцию обратного вызова, которая будет вызвана, когда будет подсчитано, что эта реклама принесла доход.
`abstract void`	`setPlacementId (long placementId)` Задает идентификатор размещения для межстраничной рекламы.
`abstract void`	`show (@ NonNull Activity activity)` Отображает промежуточную рекламу.

Государственные строители

Межстраничная реклама

public InterstitialAd()

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

getAdUnitId

public abstract @NonNull String getAdUnitId()

Возвращает идентификатор рекламного блока.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Получает вызов FullScreenContentCallback для этого InterstitialAd .

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Получает OnPaidEventListener для этой InterstitialAd .

getPlacementId

public abstract long getPlacementId()

Возвращает идентификатор размещения для этого InterstitialAd .

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

Возвращает объект ResponseInfo для загруженного объявления. Возвращает null до тех пор, пока объявление не загрузится успешно.

isAdAvailable

public static boolean isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

Возвращает true , если доступна межстраничная реклама, загруженная из startPreload .

нагрузка

public static void load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdRequest adRequest,
    @NonNull InterstitialAdLoadCallback loadCallback
)

Загружает InterstitialAd .

Параметры
`@ NonNull Context context`	Контекст деятельности или применения.
`@ NonNull String adUnitId`	Идентификатор рекламного блока.
`@ NonNull AdRequest adRequest`	Запрос на показ рекламы с информацией о таргетинге.
`@ NonNull InterstitialAdLoadCallback loadCallback`	Функция обратного вызова, которая будет вызвана после завершения загрузки межстраничной рекламы.

pollAd

public static @Nullable InterstitialAd pollAd(@NonNull Context context, @NonNull String adUnitId)

Получает следующую межстраничную рекламу, загруженную из startPreload , или null если реклама недоступна.

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

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

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

Устанавливает флаг, определяющий, будет ли этот промежуточный объект отображаться в иммерсивном режиме. Вызовите этот метод перед show . Во время show , если этот флаг включен и иммерсивный режим поддерживается, для промежуточной рекламы будут включены флаги SYSTEM_UI_FLAG_IMMERSIVE_STICKY и SYSTEM_UI_FLAG_HIDE_NAVIGATION.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Регистрирует функцию обратного вызова, которая будет вызвана, когда будет подсчитано, что эта реклама принесла доход.

setPlacementId

public abstract void setPlacementId(long placementId)

Задает идентификатор размещения для межстраничной рекламы.

Чтобы гарантировать включение этого идентификатора размещения в отчеты, вызовите этот метод перед показом объявления.

Параметры
`long placementId`	Длинное целое число, предоставляемое пользовательским интерфейсом AdMob для настроенного размещения.

показывать

public abstract void show(@NonNull Activity activity)

Отображает промежуточную рекламу.

Параметры
`@ NonNull Activity activity`	Контекст `Activity` , в рамках которого будет показана реклама.