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 app ou o carregamento de um 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 app ou um carregamento de nível de jogo. Os anúncios intersticiais usam um botão de fechamento 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 esse InterstitialAd.
abstract @Nullable OnPaidEventListener

Recebe o OnPaidEventListener para esse InterstitialAd.
abstract @NonNull ResponseInfo

Retorna o objeto ResponseInfo para o anúncio carregado.
static boolean
isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

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

Este método foi descontinuado.

Use pollAd.
abstract void

Registra um callback para ser invocado quando os anúncios aparecem 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 anúncio tiver uma receita estimada.
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 esse InterstitialAd.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Recebe o OnPaidEventListener para esse InterstitialAd.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

Retorna o objeto ResponseInfo para o 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

Uma atividade ou um contexto do app.
@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 que 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 para ser invocado quando os anúncios aparecem 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 show, se essa flag estiver ativada e o modo imersivo tiver suporte, SYSTEM_UI_FLAG_IMMERSIVE_STICKY e 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 anúncio tiver uma receita estimada.

mostrar

public abstract void show(@NonNull Activity activity)

Mostra o anúncio intersticial.

Parâmetros
@NonNull Activity activity

Um contexto Activity para apresentar o anúncio.