RewardedAd

public abstract class RewardedAd


Ta klasa służy do wysyłania żądań reklam z nagrodą i wyświetlania ich.

public class MainActivity extends AppCompatActivity {

    private RewardedAd rewardedAd;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        FullScreenContentCallback fullScreenContentCallback =
            new FullScreenContentCallback() {
                @Override
                public void onAdShowedFullScreenContent() {
                    // Code to be invoked when the ad showed full screen content.
                }

                @Override
                public void onAdDismissedFullScreenContent() {
                    rewardedAd = null;
                    // Code to be invoked when the ad dismissed full screen content.
                }
            };

        RewardedAd.load(
            this,
            "adUnitId",
            new AdRequest.Builder().build(),
            new RewardedAdLoadCallback() {
                @Override
                public void onAdLoaded(RewardedAd ad) {
                    findViewById(R.id.display_button).setVisibility(View.VISIBLE);
                    rewardedAd = ad;
                    rewardedAd.setFullScreenContentCallback(fullScreenContentCallback);
                }
            });
    }

    public void onDisplayButtonClicked(View view) {
        if (rewardedAd != null) {
            rewardedAd.show(
                this,
                new OnUserEarnedRewardListener() {
                    @Override
                    public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
                        Toast.makeText(
                            MainActivity.this,
                            "onRewarded! currency: "
                                + rewardItem.getType() + "    amount: "
                                + rewardItem.getAmount(), Toast.LENGTH_SHORT).show();
                    }
                });
        }
    }
}

Podsumowanie

Konstruktory publiczne

Metody publiczne

abstract Bundle

Pobiera wszystkie dostępne metadane reklamy dla tego RewardedAd.

abstract @NonNull String

Zwraca identyfikator jednostki reklamowej.

abstract @Nullable FullScreenContentCallback

Pobiera FullScreenContentCallback dla tego RewardedAd.

abstract @Nullable OnAdMetadataChangedListener

Pobiera OnAdMetadataChangedListener dla tego RewardedAd.

abstract @Nullable OnPaidEventListener

Pobiera OnPaidEventListener dla tego RewardedAd.

abstract long

Pobiera identyfikator miejsca docelowego dla tego RewardedAd.

abstract @NonNull ResponseInfo

Zwraca obiekt ResponseInfo wczytanej reklamy.

abstract @NonNull RewardItem

Pobiera nagrodę za wczytaną reklamę z nagrodą.

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

Ta metoda została wycofana.

Zamiast niej używaj zasady isAdAvailable.

static void
load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdManagerAdRequest adManagerAdRequest,
    @NonNull RewardedAdLoadCallback loadCallback
)

Wczytuje RewardedAd.

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

Wczytuje RewardedAd.

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

Ta metoda została wycofana.

Zamiast niej używaj zasady pollAd.

abstract void

Rejestruje wywołanie zwrotne, które ma być wywoływane, gdy reklamy wyświetlają i odrzucają treści pełnoekranowe.

abstract void
setImmersiveMode(boolean immersiveModeEnabled)

Ustawia flagę, która określa, czy ten obiekt reklamy z nagrodą będzie wyświetlany w trybie pełnoekranowym.

abstract void

Ustawia OnAdMetadataChangedListener dla tego RewardedAd.

abstract void

Rejestruje wywołanie zwrotne, które ma zostać wywołane, gdy ta reklama wygeneruje szacunkowe przychody.

abstract void
setPlacementId(long placementId)

Ustawia identyfikator miejsca docelowego reklamy z nagrodą.

abstract void

Ustawia ServerSideVerificationOptions dla tego RewardedAd.

abstract void
show(
    @NonNull Activity activity,
    @NonNull OnUserEarnedRewardListener onUserEarnedRewardListener
)

Wyświetla reklamę z nagrodą.

Konstruktory publiczne

RewardedAd

public RewardedAd()

Metody publiczne

getAdMetadata

public abstract Bundle getAdMetadata()

Pobiera wszystkie dostępne metadane reklamy dla tego RewardedAd. Metadane reklamy są puste, jeśli wczytana reklama nie ma metadanych. Metadane reklamy mogą się zaktualizować po wczytaniu. Użyj onAdMetadataChanged, aby nasłuchiwać zmian.

getAdUnitId

public abstract @NonNull String getAdUnitId()

Zwraca identyfikator jednostki reklamowej.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Pobiera FullScreenContentCallback dla tego RewardedAd.

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

Pobiera OnAdMetadataChangedListener dla tego RewardedAd.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Pobiera OnPaidEventListener dla tego RewardedAd.

getPlacementId

public abstract long getPlacementId()

Pobiera identyfikator miejsca docelowego dla tego RewardedAd.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

Zwraca obiekt ResponseInfo wczytanej reklamy.

getRewardItem

public abstract @NonNull RewardItem getRewardItem()

Pobiera nagrodę za wczytaną reklamę z nagrodą.

isAdAvailable

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

Zwraca wartość true, jeśli wczytana z startPreload jest dostępna reklama z nagrodą.

ładunek

public static void load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdManagerAdRequest adManagerAdRequest,
    @NonNull RewardedAdLoadCallback loadCallback
)

Wczytuje RewardedAd.

Parametry
@NonNull Context context

kontekst,

@NonNull String adUnitId

Identyfikator jednostki reklamowej.

@NonNull AdManagerAdRequest adManagerAdRequest

Żądanie reklamy w Google Ad Manager z informacjami o kierowaniu.

@NonNull RewardedAdLoadCallback loadCallback

Wywołanie zwrotne, które ma zostać wywołane po zakończeniu wczytywania reklamy z nagrodą.

ładunek

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

Wczytuje RewardedAd.

Parametry
@NonNull Context context

kontekst,

@NonNull String adUnitId

Identyfikator jednostki reklamowej.

@NonNull AdRequest adRequest

Żądanie reklamy z informacjami o kierowaniu.

@NonNull RewardedAdLoadCallback loadCallback

Wywołanie zwrotne, które ma zostać wywołane po zakończeniu wczytywania reklamy z nagrodą.

pollAd

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

Pobiera następną reklamę z nagrodą wczytaną z startPreload lub null, jeśli żadna reklama nie jest dostępna.

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

Rejestruje wywołanie zwrotne, które ma być wywoływane, gdy reklamy wyświetlają i odrzucają treści pełnoekranowe.

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

Ustawia flagę, która określa, czy ten obiekt reklamy z nagrodą będzie wyświetlany w trybie pełnoekranowym. Wywołaj tę metodę przed show. Podczas show, jeśli ta flaga jest włączona i tryb pełnoekranowy jest obsługiwany, w przypadku reklamy z nagrodą włączone zostaną flagi SYSTEM_UI_FLAG_IMMERSIVE_STICKY i SYSTEM_UI_FLAG_HIDE_NAVIGATION.

setOnAdMetadataChangedListener

public abstract void setOnAdMetadataChangedListener(
    @Nullable OnAdMetadataChangedListener listener
)

Ustawia OnAdMetadataChangedListener dla tego RewardedAd.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Rejestruje wywołanie zwrotne, które ma zostać wywołane, gdy ta reklama wygeneruje szacunkowe przychody.

setPlacementId

public abstract void setPlacementId(long placementId)

Ustawia identyfikator miejsca docelowego reklamy z nagrodą.

Aby ten identyfikator miejsca docelowego był uwzględniany w raportach, wywołaj tę metodę przed wyświetleniem reklamy.

Parametry
long placementId

Długa liczba całkowita podana w interfejsie AdMob dla skonfigurowanego miejsca docelowego.

setServerSideVerificationOptions

public abstract void setServerSideVerificationOptions(
    @Nullable ServerSideVerificationOptions options
)

Ustawia ServerSideVerificationOptions dla tego RewardedAd.

pokaż

public abstract void show(
    @NonNull Activity activity,
    @NonNull OnUserEarnedRewardListener onUserEarnedRewardListener
)

Wyświetla reklamę z nagrodą.

Parametry
@NonNull Activity activity

Aktywność, w której ma się wyświetlać reklama z nagrodą.

@NonNull OnUserEarnedRewardListener onUserEarnedRewardListener

Słuchacz, który ma otrzymywać powiadomienia, gdy użytkownik zdobędzie nagrodę.