InterstitialAd

public abstract class InterstitialAd

Subclasses diretas conhecidas
AdManagerInterstitialAd

Uma experiência de anúncio de página inteira em pontos de transição naturais, como a mudança de página, a abertura de um aplicativo ou um carregamento de nível de jogo para editores do Google Ad Manager.


Uma experiência de anúncio de página inteira em pontos de transição naturais, como a mudança de página, a abertura de um aplicativo ou um carregamento de nível de jogo. Os anúncios intersticiais usam um botão "Fechar" que remove o anúncio da experiência do usuário.

Código de exemplo:

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");
    }
}

Resumo

Construtores públicos

Métodos públicos

abstract @NonNull String

Retorna o ID do bloco de anúncios.

abstract @Nullable FullScreenContentCallback

Recebe o FullScreenContentCallback para este InterstitialAd.

abstract @Nullable OnPaidEventListener

Recebe o OnPaidEventListener para este InterstitialAd.

abstract long

Retorna o ID da posição para este InterstitialAd.

abstract @NonNull ResponseInfo

Retorna o objeto ResponseInfo do anúncio carregado.

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

Esse método foi descontinuado.

Use isAdAvailable.

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

Carrega um InterstitialAd.

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

Esse método foi descontinuado.

Use pollAd.

abstract void

Registra um callback a ser invocado quando os anúncios mostram e dispensam o conteúdo em tela cheia.

abstract void
setImmersiveMode(boolean immersiveModeEnabled)

Define uma flag que controla se esse objeto intersticial será exibido no modo imersivo.

abstract void

Registra um callback para ser invocado quando o sistema estima que o anúncio gerou dinheiro.

abstract void
setPlacementId(long placementId)

Define um ID de posição para o anúncio intersticial.

abstract void
show(@NonNull Activity activity)

Mostra o anúncio intersticial.

Construtores públicos

InterstitialAd

public InterstitialAd()

Métodos públicos

getAdUnitId

public abstract @NonNull String getAdUnitId()

Retorna o ID do bloco de anúncios.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Recebe o FullScreenContentCallback para este InterstitialAd.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Recebe o OnPaidEventListener para este InterstitialAd.

getPlacementId

public abstract long getPlacementId()

Retorna o ID da posição para este InterstitialAd.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

Retorna o objeto ResponseInfo do anúncio carregado. Retorna null até que o anúncio seja carregado.

isAdAvailable

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

Retorna true se houver um anúncio intersticial disponível carregado de startPreload.

autoinfligida

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

Carrega um InterstitialAd.

Parâmetros
@NonNull Context context

Um contexto de atividade ou aplicativo.

@NonNull String adUnitId

O ID do bloco de anúncios.

@NonNull AdRequest adRequest

Uma solicitação de anúncio com informações de segmentação.

@NonNull InterstitialAdLoadCallback loadCallback

Um callback a ser invocado quando um anúncio intersticial terminar de carregar.

pollAd

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

Recupera o próximo anúncio intersticial carregado de startPreload ou null se nenhum anúncio estiver disponível.

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

Registra um callback a ser invocado quando os anúncios mostram e dispensam o conteúdo em tela cheia.

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

Define uma flag que controla se esse objeto intersticial será exibido no modo imersivo. Chame esse método antes de show. Durante o show, se essa flag estiver ativada e o modo imersivo for compatível, SYSTEM_UI_FLAG_IMMERSIVE_STICKY &SYSTEM_UI_FLAG_HIDE_NAVIGATION serão ativados para o anúncio intersticial.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Registra um callback para ser invocado quando o sistema estima que o anúncio gerou dinheiro.

setPlacementId

public abstract void setPlacementId(long placementId)

Define um ID de posição para o anúncio intersticial.

Para garantir que esse ID de posição seja incluído nos relatórios, chame esse método antes de mostrar o anúncio.

Parâmetros
long placementId

Um número inteiro longo fornecido pela interface da AdMob para a posição configurada.

mostrar

public abstract void show(@NonNull Activity activity)

Mostra o anúncio intersticial.

Parâmetros
@NonNull Activity activity

Um contexto Activity de onde apresentar o anúncio.