RewardedAd

public abstract class RewardedAd

Lớp này dùng để yêu cầu và hiển thị quảng cáo có tặng thưởng. 

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

Tóm tắt

Hàm khởi tạo công khai

Phương thức công khai
abstract Bundle

Lấy tất cả siêu dữ liệu quảng cáo có sẵn cho RewardedAd này.
abstract @NonNull String

Trả về mã đơn vị quảng cáo.
abstract @Nullable FullScreenContentCallback

Lấy FullScreenContentCallback cho RewardedAd này.
abstract @Nullable OnAdMetadataChangedListener

Lấy OnAdMetadataChangedListener cho RewardedAd này.
abstract @Nullable OnPaidEventListener

Lấy OnPaidEventListener cho RewardedAd này.
abstract long

Lấy mã vị trí cho RewardedAd này.
abstract @NonNull ResponseInfo

Trả về đối tượng ResponseInfo cho quảng cáo đã tải.
abstract @NonNull RewardItem

Nhận vật phẩm thưởng cho quảng cáo có tặng thưởng đã tải.
static boolean
isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

Phương thức này không được dùng nữa.

Thay vào đó, hãy sử dụng isAdAvailable.
static void
load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdManagerAdRequest adManagerAdRequest,
    @NonNull RewardedAdLoadCallback loadCallback
)

Tải một RewardedAd.
static void
load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdRequest adRequest,
    @NonNull RewardedAdLoadCallback loadCallback
)

Tải một RewardedAd.
static @Nullable RewardedAd
pollAd(@NonNull Context context, @NonNull String adUnitId)

Phương thức này không được dùng nữa.

Thay vào đó, hãy sử dụng pollAd.
abstract void

Đăng ký một lệnh gọi lại sẽ được gọi khi quảng cáo hiển thị và loại bỏ nội dung toàn màn hình.
abstract void
setImmersiveMode(boolean immersiveModeEnabled)

Đặt một cờ kiểm soát việc đối tượng quảng cáo có tặng thưởng này sẽ hiển thị ở chế độ sống động hay không.
abstract void

Đặt OnAdMetadataChangedListener cho RewardedAd này.
abstract void

Đăng ký một lệnh gọi lại sẽ được gọi khi quảng cáo này được ước tính là đã kiếm được tiền.
abstract void
setPlacementId(long placementId)

Đặt mã vị trí cho quảng cáo có tặng thưởng.
abstract void

Đặt ServerSideVerificationOptions cho RewardedAd này.
abstract void
show(
    @NonNull Activity activity,
    @NonNull OnUserEarnedRewardListener onUserEarnedRewardListener
)

Hiển thị quảng cáo có tặng thưởng.

Hàm khởi tạo công khai

RewardedAd

public RewardedAd()

Phương thức công khai

getAdMetadata

public abstract Bundle getAdMetadata()

Lấy tất cả siêu dữ liệu quảng cáo có sẵn cho RewardedAd này. Siêu dữ liệu quảng cáo sẽ trống nếu quảng cáo đã tải không có siêu dữ liệu. Siêu dữ liệu quảng cáo có thể cập nhật sau khi tải. Dùng onAdMetadataChanged để theo dõi các thay đổi.

getAdUnitId

public abstract @NonNull String getAdUnitId()

Trả về mã đơn vị quảng cáo.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Lấy FullScreenContentCallback cho RewardedAd này.

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

Lấy OnAdMetadataChangedListener cho RewardedAd này.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Lấy OnPaidEventListener cho RewardedAd này.

getPlacementId

public abstract long getPlacementId()

Lấy mã vị trí cho RewardedAd này.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

Trả về đối tượng ResponseInfo cho quảng cáo đã tải.

getRewardItem

public abstract @NonNull RewardItem getRewardItem()

Nhận vật phẩm thưởng cho quảng cáo có tặng thưởng đã tải.

isAdAvailable

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

Trả về true nếu có quảng cáo có tặng thưởng được tải từ startPreload.

trọng tải

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

Tải một RewardedAd.

Thông số
@NonNull Context context

Bối cảnh.
@NonNull String adUnitId

Mã đơn vị quảng cáo.
@NonNull AdManagerAdRequest adManagerAdRequest

Yêu cầu quảng cáo Google Ad Manager có thông tin nhắm mục tiêu.
@NonNull RewardedAdLoadCallback loadCallback

Một lệnh gọi lại sẽ được gọi khi quảng cáo có tặng thưởng tải xong.

trọng tải

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

Tải một RewardedAd.

Thông số
@NonNull Context context

Bối cảnh.
@NonNull String adUnitId

Mã đơn vị quảng cáo.
@NonNull AdRequest adRequest

Yêu cầu quảng cáo có thông tin nhắm mục tiêu.
@NonNull RewardedAdLoadCallback loadCallback

Một lệnh gọi lại sẽ được gọi khi quảng cáo có tặng thưởng tải xong.

pollAd

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

Truy xuất quảng cáo có tặng thưởng tiếp theo được tải từ startPreload hoặc null nếu không có quảng cáo.

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

Đăng ký một lệnh gọi lại sẽ được gọi khi quảng cáo hiển thị và loại bỏ nội dung toàn màn hình.

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

Đặt một cờ kiểm soát việc đối tượng quảng cáo có tặng thưởng này sẽ hiển thị ở chế độ sống động hay không. Gọi phương thức này trước show. Trong show, nếu cờ này đang bật và chế độ sống động được hỗ trợ, thì SYSTEM_UI_FLAG_IMMERSIVE_STICKY và SYSTEM_UI_FLAG_HIDE_NAVIGATION sẽ bật cho quảng cáo có tặng thưởng.

setOnAdMetadataChangedListener

public abstract void setOnAdMetadataChangedListener(
    @Nullable OnAdMetadataChangedListener listener
)

Đặt OnAdMetadataChangedListener cho RewardedAd này.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Đăng ký một lệnh gọi lại sẽ được gọi khi quảng cáo này được ước tính là đã kiếm được tiền.

setPlacementId

public abstract void setPlacementId(long placementId)

Đặt mã vị trí cho quảng cáo có tặng thưởng.

Để đảm bảo mã vị trí này được đưa vào báo cáo, hãy gọi phương thức này trước khi hiển thị quảng cáo.

Thông số
long placementId

Một số nguyên dài do giao diện người dùng AdMob cung cấp cho vị trí đã định cấu hình.

setServerSideVerificationOptions

public abstract void setServerSideVerificationOptions(
    @Nullable ServerSideVerificationOptions options
)

Đặt ServerSideVerificationOptions cho RewardedAd này.

hiện (lên)/cho thấy

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

Hiển thị quảng cáo có tặng thưởng.

Thông số
@NonNull Activity activity

Hoạt động mà từ đó quảng cáo có tặng thưởng sẽ xuất hiện.
@NonNull OnUserEarnedRewardListener onUserEarnedRewardListener

Trình nghe sẽ nhận được thông báo khi người dùng nhận được phần thưởng.