Trang này được dịch bởi Cloud Translation API.

Di chuyển SDK

Trang này trình bày cách di chuyển đối với phiên bản hiện tại và phiên bản cũ.

Chuyển từ phiên bản 22 sang phiên bản 23

Cấp độ API tối thiểu trên Android là 21

Kể từ phiên bản 23.0.0, SDK quảng cáo trên thiết bị di động của Google yêu cầu tất cả ứng dụng phải có API Android cấp 21 trở lên để có thể chạy. Để điều chỉnh cấp độ API, hãy thay đổi giá trị của minSdkVersion trong tệp build.gradle ở cấp ứng dụng thành cấp 21 trở lên.

Xoá/thay thế các phương thức không dùng nữa

API phiên bản 22.0.0	API phiên bản 23.0.0
AdRequest.Builder.addTestDevice()	RequestConfiguration.Builder.setTestDeviceIds()
AdRequest.Builder.tagForChildDirectedTreatment()	RequestConfiguration.Builder.setTagForChildDirectedTreatment()
AdRequest.Builder.setIsDesignedForFamilies()	RequestConfiguration.Builder.setMaxAdContentRating()
AdFormat.UNKNOWN	Không có loại thay thế
AdLoader.Builder.forUnifiedNativeAd()	AdLoader.Builder.forNativeAd()
AdLoader.Builder.forCustomTemplateAd()	AdLoader.Builder.forCustomFormatAd()
AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.`formats`.NativeAdOptions)	AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.`nativead`.NativeAdOptions)
vô hiệu MobileAds.setSameAppKeyEnabled()	boolean MobileAds.putPublisherFirstPartyIdEnabled()

Chuyển từ phiên bản 21 sang phiên bản 22

Sử dụng MobileAds.getVersion() để tải phiên bản SDK Quảng cáo của Google trên thiết bị di động

Phương thức MobileAds.getVersionString() bị xoá trong phiên bản 22.0.0 và thay bằng MobileAds.getVersion().

Phương thức mới sẽ trả về số phiên bản bên ngoài dự kiến. Ví dụ: 22.0.0. Để biết thêm thông tin về thay đổi này, hãy xem bài viết Sử dụng phương thức getVersion() của SDK Quảng cáo của Google trên thiết bị di động mới.

Phương thức bị thay thế hoặc bị xoá

Bảng dưới đây liệt kê các thay đổi cụ thể trong phiên bản 22.0.0.

v21.0.0	v22.0.0
MobileAds.getVersionString()	MobileAds.getVersion()
NativeCustomFormatAd.getVideoMediaView()	NativeCustomFormatAd.getMediaContent()
NativeCustomFormatAd.getVideoController()	NativeCustomFormatAd.getMediaContent().getVideoController()
AdRequest.Builder.setAdInfo()	AdRequest.Builder.setAdString()
MediationRewardedVideoAdAdapter	Bộ chuyển đổi
MediationRewardedVideoAdListener	Bộ chuyển đổi
com.google.android.gms.ads.mediation.VersionInfo	com.google.android.gms.ads.VersionInfo
com.google.android.gms.ads.doubleclick.AppEventListener	com.google.android.gms.ads.admanager.AppEventListener

Chuyển từ phiên bản 20 sang phiên bản 21

Cập nhật minSdkVersion lên phiên bản 19 trở lên

SDK quảng cáo trên thiết bị di động của Google phiên bản 21.0.0 trở lên yêu cầu tất cả ứng dụng phải có API Android cấp 19 trở lên để có thể chạy. Để điều chỉnh cấp độ API, hãy thay đổi giá trị của minSdkVersion trong tệp bản dựng của ứng dụng thành cấp 19 trở lên.

Thực thi tính chất rỗng nghiêm ngặt

Để chuẩn bị cho việc thực thi tính chất rỗng nghiêm ngặt, chú thích @NonNull sẽ được thêm vào tất cả những API chưa xác định rõ ràng tính chất rỗng.

Thay đổi này có thể làm hỏng các ứng dụng Kotlin cũng như ứng dụng sử dụng khung kiểm tra giá trị rỗng Java nếu có lỗi vi phạm an toàn về giá trị rỗng và trước đây chưa từng xử lý các giá trị null một cách an toàn (xem tài liệu của Kotlin về độ an toàn của giá trị rỗng).

Xoá phương thức addNetworkExtras()

Phương thức addNetworkExtras() truyền các thông số bổ sung dưới dạng bản sao NetworkExtras đến một bộ chuyển đổi mạng quảng cáo cụ thể đã ngừng hoạt động trong SDK phiên bản 20.3.0 và sẽ bị xoá trong phiên bản 21.0.0. Hãy sử dụng phương thức addNetworkExtrasBundle() từ cùng một lớp AdRequest.Builder.

Xoá các phương pháp định vị

Các phương pháp định vị sau sẽ bị xoá trong phiên bản 21.0.0:

Phương pháp setLocation(Location location) trong lớp AdRequest.Builder sẽ đặt vị trí của người dùng để nhắm mục tiêu theo nhóm dàn xếp.
Phương pháp getLocation() trong lớp AdRequest trả về thông tin nhắm mục tiêu theo vị trí của người dùng trước đó đã được chuyển đến phương pháp setLocation(Location location).
Phương thức getLocation() trong lớp MediationAdConfiguration trả về vị trí của người dùng, nếu được AdRequest xác định.

Google không sử dụng dữ liệu vị trí để nhắm mục tiêu quảng cáo. Nếu bắt buộc, bạn nên sử dụng API của bên thứ ba để cung cấp thông tin cho các mạng quảng cáo bên thứ ba.

Ngừng sử dụng giao diện sự kiện tuỳ chỉnh

Sự kiện tuỳ chỉnh cho phép nhà xuất bản sử dụng tính năng AdMob dàn xếp để thêm chế độ dàn xếp kiểu thác nước cho một mạng quảng cáo không thuộc danh sách mạng quảng cáo được hỗ trợ của AdMob.

Tất cả giao diện sự kiện tuỳ chỉnh sẽ ngừng hoạt động và thay vào đó là lớp Adapter và giao diện MediationAdLoadCallback.

Bảng bên dưới liệt kê những lớp hoặc giao diện tương ứng sẽ được dùng cho từng giao diện sự kiện tuỳ chỉnh kể từ phiên bản 21.0.0:

Giao diện phiên bản 20.0.0	Lớp/ Giao diện phiên bản 21.0.0
CustomEvent	Bộ chuyển đổi
CustomEventBanner
CustomEventInterstitial
CustomEventNative
CustomEventBannerListener	Bộ chuyển đổi, MediationAdLoadCallback
CustomEventInterstitialListener
CustomEventListener
CustomEventNativeListener

Chuyển từ phiên bản 19 sang phiên bản 20

Có nhiều thay đổi có thể gây lỗi trong phiên bản 20.0.0. Phiên bản 19.7.0 đã ra mắt nhiều API mới, đồng thời ngừng sử dụng hoặc đổi tên nhiều lớp để chuẩn bị cho phiên bản 20.0.0. Hướng dẫn này nêu bật những thay đổi chính trong phiên bản 20.0.0.

Nội dung cập nhật đối với API theo định dạng toàn màn hình

Kể từ phiên bản 20.0.0, các định dạng quảng cáo xen kẽ, quảng cáo có tặng thưởng, quảng cáo xen kẽ có tặng thưởng và quảng cáo khi mở ứng dụng được chuẩn hoá để tuân theo một thiết kế API nhất quán.

Tất cả các API theo định dạng toàn màn hình đều tuân theo nguyên tắc sau:

Phương thức tải tĩnh
Cơ chế tải lệnh gọi lại hoặc trình xử lý tương tự
Sử dụng lớp FullScreenContentCallback để gọi lại bản trình bày

Xóa API RewardedVideoAd cũ

API RewardedAd mới được ra mắt lần đầu vào tháng 3 năm 2019 và là API có tặng thưởng được ưa thích trong hơn 18 tháng qua. API này có nhiều tính năng nâng cao hơn so với API RewardedVideoAd cũ, kể cả khả năng tải nhiều quảng cáo có tặng thưởng cùng lúc.

API RewardedVideoAd cũ sẽ bị xóa trong SDK phiên bản 20.0.0.

Biểu ngữ thông minh sẽ ngừng hoạt động và được thay thế bằng biểu ngữ thích ứng

Quảng cáo biểu ngữ thông minh sẽ ngừng hoạt động và được thay thế bằng quảng cáo biểu ngữ thích ứng. Biểu ngữ thích ứng mang lại hiệu quả hoạt động vượt trội và tính linh hoạt cao hơn trong việc đặt chiều rộng quảng cáo. Nếu muốn tiếp tục sử dụng biểu ngữ có chiều rộng đầy đủ, bạn vẫn có thể làm vậy bằng cách sử dụng biểu ngữ thích ứng, theo cách minh họa trong đoạn mã sau đây:

Java

public class MyActivity extends AppCompatActivity {
  ...
  private AdSize getFullWidthAdaptiveSize() {
    Display display = getWindowManager().getDefaultDisplay();
    DisplayMetrics outMetrics = new DisplayMetrics();
    display.getMetrics(outMetrics);

    float widthPixels = outMetrics.widthPixels;
    float density = outMetrics.density;

    int adWidth = (int) (widthPixels / density);
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
  }
}

Kotlin

class MyActivity : AppCompatActivity() {
  ...
  private val adaptiveAdSize: AdSize
    get() {
      val display = windowManager.defaultDisplay
      val outMetrics = DisplayMetrics()
      display.getMetrics(outMetrics)

      val density = outMetrics.density

      var adWidthPixels = ad_view_container.width.toFloat()
      if (adWidthPixels == 0f) {
        adWidthPixels = outMetrics.widthPixels.toFloat()
      }

      val adWidth = (adWidthPixels / density).toInt()
      return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
    }
}

Xóa lệnh gọi lại ứng dụng

Lệnh gọi lại onAdLeftApplication cho tất cả các định dạng quảng cáo đã bị xoá và được thay thế bằng ProcessLifecycleOwner. Khi sử dụng API ở cấp hệ điều hành, bạn sẽ nhận được thông báo mỗi khi người dùng rời khỏi ứng dụng, bất kể việc đó có phải là do một hành động tương tác với quảng cáo hay không.

Xin lưu ý rằng lệnh gọi lại onAdLeftApplication không nhằm mục đích làm trình xử lý lượt nhấp vào quảng cáo, nên việc dựa vào lệnh gọi lại này để báo cáo lượt nhấp sẽ không tạo ra chỉ số chính xác. Ví dụ: một lượt nhấp vào biểu tượng Lựa chọn quảng cáo làm khởi chạy một trình duyệt bên ngoài đã kích hoạt lệnh gọi lại, nhưng không được tính là một lượt nhấp.

Đổi tên các lớp

Bảng dưới đây liệt kê các lớp cụ thể đã đổi tên hoặc đã bị xóa. Tóm tắt:

Hầu hết các lớp có liên quan đến UnifiedNativeAd đều đã được đổi tên thành NativeAd.
Các lớp và chế độ xem MobileAds.Settings, NativeExpressAdView, NativeAppInstallAd, NativeContentAd và InstreamAd đều đã bị xoá.
Tất cả các lớp có tiền tố Publisher đều đã được thay thế bằng tiền tố AdManager.
Tên gói InterstitialAd đã thay đổi.

Lớp 19.5.0	Lớp 20.0.0
com.google.android.gms.ads.	com.google.android.gms.ads.
reward.RewardedVideoAd	rewarded.RewardedAd
reward.RewardedVideoAdListener	reward.RewardedAdLoadCallback và FullScreenContentCallback
reward.RewardItem	rewarded.RewardItem
rewarded.RewardedAdCallback	OnUserEarnedRewardListener
formats.UnifiedNativeAdView	nativead.NativeAdView
formats.UnifiedNativeAd	nativead.NativeAd
formats.UnifiedNativeAdAssetNames	nativead.NativeAdAssetNames
formats.UnifiedNativeAd.OnUnifiedNativeAdLoadedListener	nativead.NativeAd.OnNativeAdLoadedListener
	nativead.AdChoicesView
formats.NativeAd.AdChoicesInfo	nativead.NativeAd.AdChoicesInfo
formats.MediaView	nativead.MediaView
formats.NativeAdViewHolder	nativead.NativeAdViewHolder
formats.NativeAdOptions	nativead.NativeAdOptions
formats.NativeCustomTemplateAd	nativead.NativeCustomFormatAd
format.NativeNative.On tiênLoadedListener	nativead.NativeCustomFormatAd.OnCustomFormatAdLoadedListener
MobileAds.Settings	Đã xóa
doubleclick.PublisherAdRequest	admanager.AdManagerAdRequest
doubleclick.PublisherAdView	admanager.AdManagerAdView
formats.PublisherAdViewOptions	formats.AdManagerAdViewOptions
doubleclick.PublisherInterstitialAd	admanager.AdManagerInterstitialAd
InterstitialAd	interstitial.InterstitialAd
NativeExpressAdView	Đã xóa
instream.InstreamAd	Đã xóa
mediation.admob.AdMobExtras	Đã xóa
Hệ tương quan	Đã xóa
search.SearchAdRequest	Đã xóa
Giao diện AdRequest.TagForUnderAgeOfConsent	Đã xóa
Giao diện AdRequest.MaxAdContentRating	Đã xóa
formats.NativeAppInstallAd	native.NativeAd
formats.NativeAppInstallAdView	native.NativeAdView
mediation.NativeAppInstallAdMapper	mediation.UnifiedNativeAdMapper
formats.NativeContentAd	native.NativeAd
formats.NativeContentAdView	native.NativeAdView
mediation.NativeContentAdMapper	mediation.UnifiedNativeAdMapper

Xóa/thay thế một số phương thức

Bảng dưới đây liệt kê các thay đổi cụ thể trong phiên bản 20.0.0. Tóm tắt:

Các phương thức khởi động lỗi thời đã bị xoá khỏi lớp MobileAds.
Một số phương thức từ lớp AdRequest.Builder() đã bị xóa hoặc chuyển sang lớp RequestConfiguration.
API RewardedAd và InterstitialAd đã được cập nhật để phù hợp với tất cả các định dạng toàn màn hình.
Các tính năng tương quan đều đã bị xoá.

Lớp	API phiên bản 19.5.0	API phiên bản 20.0.0	Ghi chú
AdSize	getPortraitBannerAdSizeWithWidth()	getPortraitAnchoredAdaptiveBannerAdSize()
	getLandscapeBannerAdSizeWithWidth()	getLandscapeAnchoredAdaptiveBannerAdSize()
	getCurrentOrientationBannerAdSizeWithWidth()	getCurrentOrientationAnchoredAdaptiveBannerAdSize()
MobileAds	khởi tạo(Ngữ cảnh, Chuỗi)	MobileAds.initialize(Context, OnInitializationCompleteListener)	Mã ứng dụng hiện được đặt trong AndroidManifest.xml.
	khởi tạo(Ngữ cảnh, Chuỗi, MobileAds.Settings)	khởi tạo(Ngữ cảnh, OnInitializationCompleteTrình nghe)	Lớp Cài đặt không còn được hỗ trợ nữa.
	getRewardVideoAdInstance()	Đã xóa	Thay vào đó, hãy sử dụng API RewardedAd.
AdListener	onAdFailedToLoad(int)	onAdKhông thành công(LoadAdError)
AdListener	onAdLeftApplication()	Đã xóa	Các định dạng quảng cáo toàn màn hình sử dụng FullscreenContentCallback thay cho AdListener, và không có phương thức tương đương trên FullscreenContentCallback. Phương thức này đã bị xoá khỏi AdListener.
VideoController	getAspectRatio()	MediaContent.getAspectRatio()
AdRequest	getGender()	Đã xóa
	getBirthday()	Đã xóa
	getNetworkExtras()	Đã xóa
	setThủ công lượt hiển thịĐã bật()	Đã xóa
	updateCorrelator()	Đã xóa	Xem Cách lọc nội dung quảng cáo.
AdRequest.Trình tạo	setBirthday()	Đã xóa
	setGender()	Đã xóa
	setIsDesignedForFamilies()	Đã xóa	Xem hướng dẫn.
	addTestDevice()	RequestConfiguration.Builder.setTestDeviceIds()	Xem Cách bật quảng cáo thử nghiệm.
	tagForChildDirectedTreatment()	RequestConfiguration.Builder.setTagForChildDirectedTreatment()	Xem Cách lọc nội dung quảng cáo.
	setTagForUnderAgeOfConsent()	RequestConfiguration.Builder.setTagForUnderAgeOfConsent()
	setMaxAdContentRating()	RequestConfiguration.Builder.setMaxAdContentRating()
AdView	getMediationAdapterClassName()	ResponseInfo.getMediationAdapterClassName()	Đối tượng ResponseInfo hiện có thể lấy được thông qua phương thức AdView getResponseInfo().
NativeAdOptions	setImageOrientation()	setMediaAspectRatio()
NativeAdOptions	getImageOrientation	getMediaAspectRatio()
RewardedAd	tROAS(AdRequest, RewardedAdLoadCallback)	RewardedAd.load(Ngữ cảnh, Chuỗi, AdRequest, RewardedAdLoadCallback)	RewardedAd hiện sử dụng phương pháp tải tĩnh giống như các định dạng toàn màn hình khác.
	Preference(PublisherAdRequest, RewardedAdLoadCallback)	RewardedAd.load(Ngữ cảnh, Chuỗi, AdManagerAdRequest, RewardedAdLoadCallback)
	isLoaded()	Đã xóa	Lệnh gọi lại từ phương thức tải tĩnh sẽ cung cấp quảng cáo đã được tải.
	show(Hoạt động, RewardedAdCallback)	show(Activity, OnUserearnedRewardListener)	Phương thức hiển thị này tuân thủ phương pháp rộng hơn về định dạng toàn màn hình.
RewardedAdLoadCallback	onRewardedAdFailedToLoad(int)	onAdKhông thành công(LoadAdError)
	onRewardedAdKhông thành công(LoadAdError)	onAdKhông thành công(LoadAdError)
	onRewardedAdLoaded()	onAdLoaded(RewardedAd)
AppOpenAdLoadCallback	onAppOpenAdFailedToLoad(int)	onAdKhông thành công(LoadAdError)
	onAppOpenAdKhông thành công(LoadAdError)	onAdKhông thành công(LoadAdError)
	onAppOpenAdĐã tải(AppOpenAd)	onAdLoaded(AppOpenAd)
Lệnh gọi lạiQuảng cáo xen kẽ có tặng thưởng	onRewardInterstitialAdFailedToLoad(int)	onAdKhông thành công(LoadAdError)
	onrewardedInterstitialAdFailedToLoad(LoadAdError)	onAdKhông thành công(LoadAdError)
	onRewardInterstitialAdĐã tải(rewardedInterstitialAd)	onAdLoaded(RewardedInterstitialAd)
InterstitialAd	Hàm InterstitialAd() mới	InterstitialAd.load(Ngữ cảnh, Chuỗi, AdRequest, InterstitialAdLoadCallback)	InterstitialAd hiện sử dụng cùng một phương thức tải tĩnh giống như các định dạng toàn màn hình khác.
InterstitialAd	setAdListener()
DynamicHeightSearchAdYêu cầu	getNetworkExtras()	Đã xóa	Lớp NetworkExtras không còn được hỗ trợ nữa.
AdLoader	forContentAd()	Đã xóa
	forAppInstallAd()	Đã xóa
	withCorrelator()	Đã xóa
	getMediationAdapterClassName()	Đã xóa