InterstitialAd

public abstract class InterstitialAd

Bilinen doğrudan alt sınıflar
AdManagerInterstitialAd

Google Ad Manager yayıncıları için sayfa değişimi, uygulama başlatma veya oyun seviyesi yüklenmesi gibi doğal geçiş noktalarındaki tam sayfa reklam deneyimidir.


Sayfa değişimi, uygulama başlatma veya oyun seviyesi yüklenmesi gibi doğal geçiş noktalarındaki tam sayfa reklam deneyimidir. Geçiş reklamları, reklamı kullanıcının deneyiminden kaldıran bir kapat düğmesi kullanır.

Örnek kod:

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

Özet

Herkese açık oluşturucular

Herkese açık yöntemler

abstract @NonNull String

Reklam birimi kimliğini döndürür.

abstract @Nullable FullScreenContentCallback

Bu InterstitialAd için FullScreenContentCallback değerini alır.

abstract @Nullable OnPaidEventListener

Bu InterstitialAd için OnPaidEventListener değerini alır.

abstract long

Bu InterstitialAd için yerleşim kimliğini döndürür.

abstract @NonNull ResponseInfo

Yüklenen reklam için ResponseInfo nesnesini döndürür.

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

Bu yöntem kullanımdan kaldırılmıştır.

Bunun yerine isAdAvailable'ı kullanın.

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

InterstitialAd yükler.

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

Bu yöntem kullanımdan kaldırılmıştır.

Bunun yerine pollAd'i kullanın.

abstract void

Reklamlar gösterildiğinde ve tam ekran içerik kapatıldığında çağrılacak bir geri çağırma kaydeder.

abstract void
setImmersiveMode(boolean immersiveModeEnabled)

Bu geçiş reklamı nesnesinin tam ekran modunda gösterilip gösterilmeyeceğini kontrol eden bir işaret ayarlar.

abstract void

Bu reklamın para kazandığı tahmin edildiğinde çağrılacak bir geri çağırma işlevi kaydeder.

abstract void
setPlacementId(long placementId)

Geçiş reklamı için bir yerleşim kimliği ayarlar.

abstract void
show(@NonNull Activity activity)

Geçiş reklamını gösterir.

Herkese açık oluşturucular

InterstitialAd

public InterstitialAd()

Herkese açık yöntemler

getAdUnitId

public abstract @NonNull String getAdUnitId()

Reklam birimi kimliğini döndürür.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Bu InterstitialAd için FullScreenContentCallback değerini alır.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Bu InterstitialAd için OnPaidEventListener değerini alır.

getPlacementId

public abstract long getPlacementId()

Bu InterstitialAd için yerleşim kimliğini döndürür.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

Yüklenen reklam için ResponseInfo nesnesini döndürür. Reklam başarıyla yüklenene kadar null değerini döndürür.

isAdAvailable

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

startPreload kaynağından yüklenen kullanılabilir bir geçiş reklamı varsa true değerini döndürür.

load

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

InterstitialAd yükler.

Parametreler
@NonNull Context context

Etkinlik veya uygulama bağlamı.

@NonNull String adUnitId

Reklam birimi kimliği.

@NonNull AdRequest adRequest

Hedefleme bilgileri içeren bir reklam isteği.

@NonNull InterstitialAdLoadCallback loadCallback

Geçiş reklamı yüklenmeyi tamamladığında çağrılacak geri çağırma.

pollAd

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

startPreload kaynağından yüklenen bir sonraki geçiş reklamını veya reklam yoksa null değerini alır.

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

Reklamlar gösterildiğinde ve tam ekran içerik kapatıldığında çağrılacak bir geri çağırma kaydeder.

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

Bu geçiş reklamı nesnesinin tam ekran modunda gösterilip gösterilmeyeceğini kontrol eden bir işaret ayarlar. Bu yöntemi show tarihinden önce çağırın. show sırasında bu işaret etkinse ve tam ekran modu destekleniyorsa geçiş reklamı için SYSTEM_UI_FLAG_IMMERSIVE_STICKY ve SYSTEM_UI_FLAG_HIDE_NAVIGATION etkinleştirilir.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Bu reklamın para kazandığı tahmin edildiğinde çağrılacak bir geri çağırma işlevi kaydeder.

setPlacementId

public abstract void setPlacementId(long placementId)

Geçiş reklamı için bir yerleşim kimliği ayarlar.

Bu yerleşim kimliğinin raporlamaya dahil edilmesini sağlamak için reklamı göstermeden önce bu yöntemi çağırın.

Parametreler
long placementId

Yapılandırılmış yerleşim için AdMob kullanıcı arayüzü tarafından sağlanan uzun bir tam sayı.

göster

public abstract void show(@NonNull Activity activity)

Geçiş reklamını gösterir.

Parametreler
@NonNull Activity activity

Reklamın sunulacağı bir Activity bağlamı.