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ũ.

Di chuyển từ phiên bản 22 sang phiên bản 23

Cấp độ API Android tối thiểu 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 21 trở lên.

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

Di 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ị xoá hoặc thay thế

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

Di 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

Kể từ phiên bản 21.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 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ể khiến các ứng dụng Kotlin và những ứng dụng sử dụng khung kiểm tra giá trị rỗng của Java gặp lỗi nếu vi phạm quy định về sự an toàn cho giá trị rỗng và chưa xử lý các giá trị null theo cách an toàn (xem Tài liệu của Kotlin về sự an toàn cho 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. Thay vào đó, hãy sử dụng phương thức addNetworkExtrasBundle() từ cùng một lớp AdRequest.Builder.

Xoá các phương thức định vị

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

• Phương thức 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 thức 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 thức 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 dàn xếpAdMob để thiết lập nguồn quảng cáo dạng thác nước không phải là một trong các nguồn 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:

Di 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, loại bỏ và đổ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

Xoá 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ị xoá 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 hoạ trong đoạn mã sau đây:

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

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

Xoá 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 có chức năng như một trình xử lý lượt nhấp quảng cáo, và 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 cung cấp 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 lớp

Bảng dưới đây liệt kê các lớp cụ thể đã đổi tên hoặc đã bị xoá. 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.

Xoá/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ị xoá 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á.