Tích hợp Liftoff Monetize với tính năng dàn xếp

Hướng dẫn này cho bạn biết cách sử dụng Google Mobile Ads SDK (Legacy) để tải và hiển thị quảng cáo từ Liftoff Monetize bằng tính năng Dàn xếp AdMob, bao gồm cả các hoạt động tích hợp đặt giá thầu và dàn xếp kiểu thác nước. Tài liệu này trình bày cách thêm Liftoff Monetize vào cấu hình dàn xếp của một đơn vị quảng cáo, cũng như cách tích hợp SDK và bộ chuyển đổi Vungle vào một ứng dụng Android.

Các công cụ tích hợp và định dạng quảng cáo được hỗ trợ

Bộ chuyển đổi dàn xếp cho Liftoff Monetize có các chức năng sau:

Tích hợp
Đặt giá thầu
Thác nước
Định dạng
Mở ứng dụng
Biểu 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
Mã gốc

Điều kiện tiên quyết

Trước khi tiếp tục, hãy xác minh những thông tin sau:

  • Android API cấp 24 trở lên.
  • [Đối với tính năng đặt giá thầu]: Để tích hợp tất cả các định dạng quảng cáo được hỗ trợ trong tính năng đặt giá thầu, hãy sử dụng bộ chuyển đổi Liftoff Monetize phiên bản 7.3.0.0 trở lên (nên dùng phiên bản mới nhất).

Bước 1: Thiết lập cấu hình trong giao diện người dùng của Liftoff Monetize

Đăng ký hoặc đăng nhập vào tài khoản Liftoff Monetize.

Thêm ứng dụng của bạn vào trang tổng quan Liftoff Monetize bằng cách nhấp vào nút Add Application (Thêm ứng dụng).

Điền tất cả thông tin cần thiết vào biểu mẫu.

Sau khi tạo ứng dụng, hãy chọn ứng dụng đó trong Trang tổng quan về ứng dụng Liftoff Monetize.

Ghi lại Mã ứng dụng.

Thêm vị trí mới

Để tạo một vị trí mới dùng với tính năng Dàn xếp AdMob, hãy chuyển đến Trang tổng quan về vị trí của Liftoff Monetize, nhấp vào nút Add Placement (Thêm vị trí) rồi chọn ứng dụng của bạn trong danh sách thả xuống.

Thông tin chi tiết về cách thêm vị trí mới được nêu dưới đây:

Mở ứng dụng

Chọn Interstitial (Quảng cáo xen kẽ) rồi nhập Placement Name (Tên vị trí). Sau đó, chọn Có cho mục Có thể bỏ qua rồi điền thông tin vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy chuyển nút Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

Chọn Banner (Biểu ngữ), nhập Placement Name (Tên vị trí đặt quảng cáo) và điền thông tin vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy bật nút chuyển Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

Biểu ngữ 300x250

Chọn MREC, nhập Tên vị trí rồi điền thông tin vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy bật nút chuyển Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

Quảng cáo xen kẽ

Chọn Interstitial (Quảng cáo xen kẽ), nhập Placement Name (Tên vị trí đặt quảng cáo) và điền vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy chuyển nút chuyển Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

Được thưởng

Chọn Rewarded (Có tặng thưởng), nhập Placement Name (Tên vị trí đặt quảng cáo) rồi điền thông tin vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy bật nút chuyển Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

Quảng cáo xen kẽ có tặng thưởng

Chọn Có tặng thưởng. Nhập Tên vị trí, bật Có thể bỏ qua và điền vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy bật nút chuyển Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

Mã gốc

Chọn Quảng cáo gốc, nhập Tên vị trí rồi điền thông tin vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy bật nút chuyển Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

Ghi lại Mã tham chiếu rồi nhấp vào Đồng ý.

Mở ứng dụng

Biểu ngữ 300x250

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

Mã gốc

Tìm khoá API báo cáo

Đặt giá thầu

Bạn không cần thực hiện bước này đối với các hoạt động tích hợp đặt giá thầu.

Thác nước

Ngoài Mã ứng dụng và Mã tham chiếu, bạn cũng cần có Khoá API báo cáo của Liftoff Monetize để thiết lập mã đơn vị quảng cáo AdMob. Chuyển đến Trang tổng quan về báo cáo của Liftoff Monetize rồi nhấp vào nút Khoá API báo cáo để xem Khoá API báo cáo.

Cập nhật tệp app-ads.txt

Tệp Authorized Sellers for Apps app-ads.txt là một sáng kiến của IAB Tech Lab giúp đảm bảo rằng khoảng không quảng cáo trong ứng dụng của bạn chỉ được bán thông qua những kênh mà bạn đã xác định là được uỷ quyền. Để tránh mất nhiều doanh thu từ quảng cáo, bạn cần phải triển khai tệp app-ads.txt. Nếu chưa làm, hãy thiết lập tệp app-ads.txt cho ứng dụng của bạn.

Để triển khai app-ads.txt cho Liftoff Monetize, hãy tải xuống và thêm các mục nhập của Liftoff Monetize app-ads.txt vào tệp app-ads.txt hiện có của bạn. Để biết thêm thông tin, hãy xem app-ads.txt.

Bật chế độ thử nghiệm

Để bật quảng cáo thử nghiệm, hãy chuyển đến trang tổng quan Liftoff Monetize rồi chuyển đến mục Applications (Ứng dụng).

Chọn ứng dụng mà bạn muốn bật quảng cáo thử nghiệm trong phần Mã tham chiếu vị trí của ứng dụng. Bạn có thể bật quảng cáo thử nghiệm bằng cách chọn Chế độ thử nghiệm thành Chỉ hiển thị quảng cáo thử nghiệm trong phần Trạng thái.

Bước 2: Thiết lập nhu cầu về Liftoff Monetize trong giao diện người dùng AdMob

Định cấu hình chế độ cài đặt dàn xếp cho đơn vị quảng cáo

Bạn cần thêm Liftoff Monetize vào cấu hình dàn xếp cho đơn vị quảng cáo của mình.

Trước tiên, hãy đăng nhập vào tài khoản AdMob của bạn. Tiếp theo, hãy chuyển đến thẻ Dàn xếp. Nếu bạn có một nhóm dàn xếp hiện có mà bạn muốn sửa đổi, hãy nhấp vào tên của nhóm dàn xếp đó để chỉnh sửa rồi chuyển sang bước Thêm Liftoff Monetize làm nguồn quảng cáo.

Để tạo một nhóm dàn xếp mới, hãy chọn Tạo nhóm dàn xếp.

Nhập định dạng quảng cáo và nền tảng, rồi nhấp vào Tiếp tục.

Đặt tên cho nhóm dàn xếp và chọn vị trí để nhắm mục tiêu. Tiếp theo, hãy đặt trạng thái của nhóm dàn xếp thành Đã bật, rồi nhấp vào Thêm đơn vị quảng cáo.

Liên kết nhóm dàn xếp này với một hoặc nhiều đơn vị quảng cáo AdMob hiện có của bạn. Sau đó, hãy nhấp vào Xong.

Bây giờ, bạn sẽ thấy thẻ đơn vị quảng cáo được điền sẵn các đơn vị quảng cáo mà bạn đã chọn:

Thêm Liftoff Monetize làm nguồn quảng cáo

Đặt giá thầu


Trong mục Nguồn quảng cáo, hãy tìm thẻ Đặt giá thầu rồi chọn Thêm nguồn quảng cáo. Sau đó, chọn Liftoff Monetize .

Nhấp vào Cách ký thoả thuận hợp tác và thiết lập mối quan hệ đối tác đặt giá thầu với Liftoff Monetize.



Nhấp vào Xác nhận và đồng ý, sau đó nhấp vào Tiếp tục.



Nếu đã có mối liên kết cho Liftoff Monetize, bạn có thể chọn mối liên kết đó. Nếu không, hãy nhấp vào Thêm mối liên kết.



Tiếp theo, hãy nhập Mã ứng dụng và Mã tham chiếu vị trí mà bạn đã lấy được trong phần trước. Sau đó, hãy nhấp vào Xong.



Thác nước


Trong thẻ Thác nước ở mục Nguồn quảng cáo, hãy chọn Thêm nguồn quảng cáo.

Chọn Liftoff Monetize rồi bật nút chuyển Tối ưu hoá. Nhập Khoá API báo cáo mà bạn đã lấy được ở phần trước để thiết lập tính năng tối ưu hoá nguồn quảng cáo cho Liftoff Monetize. Sau đó, hãy nhập một giá trị eCPM cho Liftoff Monetize rồi nhấp vào Tiếp tục.




Nếu đã có mối liên kết cho Liftoff Monetize, bạn có thể chọn mối liên kết đó. Nếu không, hãy nhấp vào Thêm mối liên kết.



Tiếp theo, hãy nhập Mã ứng dụng và Mã tham chiếu vị trí mà bạn đã lấy được trong phần trước. Sau đó, hãy nhấp vào Xong.


Thêm Liftoff vào danh sách đối tác quảng cáo theo GDPR và quy định của các bang tại Hoa Kỳ

Hãy làm theo các bước trong phần Chế độ cài đặt theo quy định của Châu Âu và Chế độ cài đặt theo quy định của các bang tại Hoa Kỳ để thêm Liftoff vào danh sách đối tác quảng cáo theo quy định của Châu Âu và các bang tại Hoa Kỳ trong giao diện người dùng AdMob.

Bước 3: Nhập SDK Vungle và bộ chuyển đổi Liftoff Monetize

Trong tệp gradle ở cấp ứng dụng, hãy thêm các phần phụ thuộc triển khai sau:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:vungle:7.7.8.1")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:vungle:7.7.8.1'
}

Tích hợp thủ công

Bước 4: Triển khai chế độ cài đặt quyền riêng tư trên SDK Vungle

Để tuân thủ Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu của Google, bạn phải công bố một số thông tin nhất định cho người dùng ở Khu vực kinh tế Châu Âu (EEA), Vương quốc Anh và Thuỵ Sĩ, đồng thời phải có được sự đồng ý của họ để sử dụng cookie hoặc phương pháp lưu trữ cục bộ khác khi pháp luật yêu cầu, cũng như để thu thập, chia sẻ và sử dụng dữ liệu cá nhân cho hoạt động cá nhân hoá quảng cáo. Chính sách này thể hiện các yêu cầu của Chỉ thị về quyền riêng tư và truyền thông điện tử của Liên minh Châu Âu và Quy định chung về việc bảo vệ dữ liệu (GDPR). Bạn chịu trách nhiệm xác minh rằng sự đồng ý được truyền đến từng nguồn quảng cáo trong chuỗi dàn xếp của bạn.

Kể từ phiên bản 7.4.1 của Vungle SDK, Liftoff Monetize sẽ tự động đọc sự đồng ý theo GDPR do các nền tảng quản lý sự đồng ý đặt ra (các nền tảng này hỗ trợ Thông số về sự đồng ý bổ sung của Google), bao gồm cả UMP SDK. Để biết thêm thông tin, hãy xem Hướng dẫn triển khai được đề xuất theo GDPR.

Luật về quyền riêng tư của các tiểu bang ở Hoa Kỳ

Luật về quyền riêng tư của các tiểu bang tại Hoa Kỳ yêu cầu cung cấp cho người dùng quyền chọn không tham gia vào việc "bán" "thông tin cá nhân" (theo định nghĩa của các thuật ngữ này trong luật) của họ, trong đó quyền chọn không tham gia được cung cấp thông qua một đường liên kết nổi bật "Không bán thông tin cá nhân của tôi" trên trang chủ của bên "bán". Hướng dẫn tuân thủ luật về quyền riêng tư của các bang tại Hoa Kỳ cho phép bạn bật chế độ xử lý dữ liệu bị hạn chế cho hoạt động phân phát quảng cáo của Google, nhưng Google không thể áp dụng chế độ cài đặt này cho từng mạng quảng cáo trong chuỗi dàn xếp của bạn. Do đó, bạn phải xác định từng mạng quảng cáo trong chuỗi dàn xếp có thể tham gia vào việc bán thông tin cá nhân và làm theo hướng dẫn của từng mạng đó để đảm bảo tuân thủ quy định.

Liftoff Monetize có một API cho phép bạn chuyển sự đồng ý đến SDK Vungle. Mã mẫu sau đây cho thấy cách truyền thông tin về sự đồng ý này đến SDK của Vungle. Nếu chọn gọi phương thức này, bạn nên thực hiện trước khi yêu cầu quảng cáo thông qua Google Mobile Ads SDK (Legacy).

Java

VunglePrivacySettings.setCCPAStatus(true);

Kotlin

VunglePrivacySettings.setCCPAStatus(true)

Hãy xem phần Triển khai CCPA để biết thêm thông tin chi tiết và các giá trị có thể được cung cấp trong phương thức này.

Bước 5: Thêm mã bắt buộc

Bạn không cần thêm mã để tích hợp Liftoff Monetize.

Bước 6: Kiểm tra kết quả triển khai

Bật quảng cáo thử nghiệm

Đảm bảo rằng bạn đăng ký thiết bị thử nghiệm cho AdMob và bật chế độ thử nghiệm trong giao diện người dùng Liftoff Monetize.

Xác minh quảng cáo thử nghiệm

Để xác minh rằng bạn đang nhận được quảng cáo thử nghiệm từ Liftoff Monetize, hãy bật thử nghiệm riêng một nguồn quảng cáo trong công cụ kiểm tra quảng cáo bằng (các) nguồn quảng cáo Liftoff Monetize (Đặt giá thầu) và Liftoff Monetize(Thác nước).

Các bước không bắt buộc

Tham số dành riêng cho mạng

Bộ chuyển đổi Liftoff Monetize hỗ trợ các tham số yêu cầu bổ sung sau đây có thể được truyền đến bộ chuyển đổi:

userId
Một chuỗi đại diện cho Mã nhận dạng người dùng được khuyến khích của Liftoff Monetize.
adOrientation
Một số nguyên chỉ định hướng trình bày cho quảng cáo toàn màn hình.
setBackButtonImmediatelyEnabled
Một giá trị boolean để bật hoặc tắt nút quay lại trên Quảng cáo khi mở ứng dụng ngay lập tức. Đặt thành true để bật nút quay lại ngay lập tức, nếu không thì đặt thành false. Giá trị mặc định là false. Hãy xem tài liệu của Liftoff Monetize về cách tích hợp quảng cáo khi mở ứng dụng để biết thêm thông tin.

Dưới đây là ví dụ về mã để tạo một yêu cầu quảng cáo đặt các tham số này:

Java

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true);

AdRequest request =
    new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
        .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
        // App Open ads use VungleMediationAdapter
        .addNetworkExtrasBundle(VungleMediationAdapter.class, extras)
        .build();

Kotlin

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true)

val request =
  AdRequest.Builder()
    .addNetworkExtrasBundle(VungleAdapter::class.java, extras) // Rewarded.
    .addNetworkExtrasBundle(VungleInterstitialAdapter::class.java, extras) // Interstitial.
    // App Open ads use VungleMediationAdapter
    .addNetworkExtrasBundle(VungleMediationAdapter::class.java, extras)
    .build()

Hiển thị quảng cáo gốc

Bộ chuyển đổi Liftoff Monetize trả về quảng cáo gốc dưới dạng đối tượng NativeAd. Bảng này điền sẵn các nội dung mô tả trường quảng cáo gốc sau đây cho một NativeAd.

Trường Các thành phần luôn được bộ chuyển đổi Liftoff Monetize đưa vào
Dòng tiêu đề
Hình ảnh 1
Chế độ xem nội dung nghe nhìn
Nội dung
Biểu tượng ứng dụng
Lời kêu gọi hành động
Điểm xếp hạng theo sao
Cửa hàng
Giá

1 Bộ chuyển đổi Liftoff Monetize không cung cấp quyền truy cập trực tiếp vào thành phần hình ảnh chính cho quảng cáo gốc. Thay vào đó, bộ chuyển đổi sẽ điền vào MediaView bằng một video hoặc hình ảnh.

Mã lỗi

Nếu bộ chuyển đổi không nhận được quảng cáo từ Liftoff Monetize, nhà xuất bản có thể kiểm tra lỗi cơ bản trong phản hồi quảng cáo bằng ResponseInfo.getAdapterResponses() trong các lớp sau:

Định dạng Tên lớp
Quảng cáo khi mở ứng dụng (Đặt giá thầu) com.google.ads.mediation.vungle.VungleMediationAdapter
Quảng cáo khi mở ứng dụng (Thác nước) com.google.ads.mediation.vungle.VungleMediationAdapter
Quảng cáo biểu ngữ (Đặt giá thầu) com.google.ads.mediation.vungle.VungleMediationAdapter
Biểu ngữ (Thác nước) com.vungle.mediation.VungleInterstitialAdapter
Quảng cáo xen kẽ (Đặt giá thầu) com.google.ads.mediation.vungle.VungleMediationAdapter
Quảng cáo xen kẽ (Thác nước) com.vungle.mediation.VungleInterstitialAdapter
Quảng cáo có tặng thưởng (Đặt giá thầu) com.google.ads.mediation.vungle.VungleMediationAdapter
Quảng cáo có tặng thưởng (Thác nước) com.vungle.mediation.VungleAdapter
Quảng cáo xen kẽ có tặng thưởng (Đặt giá thầu) com.google.ads.mediation.vungle.VungleMediationAdapter
Quảng cáo xen kẽ có tặng thưởng (Thác nước) com.google.ads.mediation.vungle.VungleMediationAdapter
Quảng cáo gốc (Đặt giá thầu) com.google.ads.mediation.vungle.VungleMediationAdapter
Quảng cáo gốc (Thác nước) com.google.ads.mediation.vungle.VungleMediationAdapter

Dưới đây là các mã và thông báo đi kèm do bộ chuyển đổi Liftoff Monetize gửi khi quảng cáo không tải được:

Mã lỗi Miền Lý do
101 com.google.ads.mediation.vungle Thông số máy chủ không hợp lệ (ví dụ: mã ứng dụng hoặc mã vị trí đặt quảng cáo).
102 com.google.ads.mediation.vungle Kích thước biểu ngữ được yêu cầu không liên kết với kích thước quảng cáo hợp lệ của Liftoff Monetize.
103 com.google.ads.mediation.vungle Liftoff Monetize yêu cầu một Activitycontext để yêu cầu quảng cáo.
104 com.google.ads.mediation.vungle SDK Vungle không thể tải nhiều quảng cáo cho cùng một mã vị trí.
105 com.google.ads.mediation.vungle Không khởi chạy được SDK Vungle.
106 com.google.ads.mediation.vungle SDK Vungle đã trả về một lệnh gọi lại tải thành công, nhưng Banners.getBanner() hoặc Vungle.getNativeAd() đã trả về giá trị rỗng.
107 com.google.ads.mediation.vungle SDK Vungle chưa sẵn sàng phát quảng cáo.
108 com.google.ads.mediation.vungle SDK Vungle đã trả về mã thông báo đặt giá thầu không hợp lệ.

Đối với các lỗi bắt nguồn từ SDK Vungle, hãy tham khảo bài viết Mã lỗi: SDK Vungle cho iOS và Android.

Nhật ký thay đổi của Bộ chuyển đổi dàn xếp Liftoff Monetize cho Android

Phiên bản 7.7.8.1

  • Ghim phần phụ thuộc Kotlin của bộ chuyển đổi vào phiên bản 1.9.0 (phiên bản Kotlin tối thiểu được GMA NextGen SDK hỗ trợ).

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.4.0.
  • Google Mobile Ads Next-Gen SDK phiên bản 1.4.0.
  • SDK Vungle phiên bản 7.7.8.

Phiên bản 7.7.8.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 7.7.8.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.4.0.
  • Google Mobile Ads Next-Gen SDK phiên bản 1.4.0.
  • SDK Vungle phiên bản 7.7.8.

Phiên bản 7.7.7.0

  • Đã xóa quy trình kiểm tra canPlayAd() trước khi hiển thị quảng cáo khi mở ứng dụng để Liftoff SDK xử lý trường hợp chưa sẵn sàng và kích hoạt lệnh gọi lại không thành công của riêng SDK này.
  • Đặt các đối tượng quảng cáo xen kẽ và quảng cáo khi mở ứng dụng thành có thể rỗng, đồng thời thêm các bước kiểm tra rỗng trước play().
  • Thêm tính năng ghi nhật ký bằng VungleMediationLogger khi thực thể quảng cáo khi mở ứng dụng, quảng cáo xen kẽ hoặc quảng cáo có tặng thưởng (thác nước và đặt giá thầu) có giá trị rỗng tại thời điểm hiển thị.
  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 7.7.7.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.4.0.
  • Google Mobile Ads Next-Gen SDK phiên bản 1.3.0.
  • SDK Vungle phiên bản 7.7.7.

Phiên bản 7.7.6.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 7.7.6.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.4.0.
  • Google Mobile Ads Next-Gen SDK phiên bản 1.3.0.
  • SDK Vungle phiên bản 7.7.6.

Phiên bản 7.7.4.2

  • Liên kết AgeRestrictedTreatment với API COPPA của Liftoff Monetize.
  • Đã xóa các cách triển khai API cũ cho các định dạng quảng cáo dạng thác nước sau: Quảng cáo biểu ngữ, Quảng cáo xen kẽ.
  • Cập nhật bộ chuyển đổi để sử dụng loadBannerAd cho quảng cáo Biểu ngữ dạng thác nước và loadInterstitialAd cho quảng cáo Xen kẽ dạng thác nước.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.4.0.
  • Google Mobile Ads Next-Gen SDK phiên bản 1.2.1.
  • SDK Vungle phiên bản 7.7.4.

Phiên bản 7.7.4.1

  • Thêm tính năng ghi nhật ký bằng VungleMediationLogger để làm nổi bật trường hợp phát hiện thấy nhiều mã ứng dụng.

Được tạo và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 25.3.0.
  • Google Mobile Ads Next-Gen SDK phiên bản 1.2.1.

Phiên bản 7.7.4.0

  • Đã thêm cách triển khai MediationInterstitialAd vào định dạng quảng cáo xen kẽ.
  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 7.7.4.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.2.0.
  • SDK Vungle phiên bản 7.7.4.

Phiên bản 7.7.2.0

  • Thêm thuộc tính để tạo bộ chuyển đổi có phần phụ thuộc GMA Next-Gen SDK.
  • Đã thêm tính năng ghi nhật ký bằng VungleMediationLogger cho trường hợp kích thước biểu ngữ thích ứng không khớp.
  • Đặt thuộc tính adapterAdFormat trong BaseAd.
  • Xác minh khả năng tương thích với Vungle SDK phiên bản 7.7.2.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.0.0.
  • Google Mobile Ads Next-Gen SDK phiên bản 0.25.0-beta01.
  • SDK Vungle phiên bản 7.7.2.

Phiên bản 7.7.1.0

  • Xác minh khả năng tương thích với Vungle SDK 7.7.1.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.0.0.
  • SDK Vungle phiên bản 7.7.1.

Phiên bản 7.7.0.1

  • Bổ sung tính năng hỗ trợ để nhà xuất bản định cấu hình com.vungle.ads.AdConfig.setBackButtonImmediatelyEnabled cho quảng cáo khi mở ứng dụng bằng cách sử dụng các tính năng bổ sung của tính năng dàn xếp.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.9.0.
  • SDK Vungle phiên bản 7.7.0.

Phiên bản 7.7.0.0

  • Xác minh khả năng tương thích với SDK Vungle phiên bản 7.7.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.9.0.
  • SDK Vungle phiên bản 7.7.0.

Phiên bản 7.6.3.1

  • Thêm tính năng hỗ trợ chuyển tiếp tham số tagForUnderAgeOfConsent của Google Mobile Ads SDK đến SDK Liftoff Monetize.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.9.0.
  • SDK Vungle phiên bản 7.6.3.

Phiên bản 7.6.3.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 7.6.3.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.9.0.
  • SDK Vungle phiên bản 7.6.3.

Phiên bản 7.6.2.0

  • Xác minh khả năng tương thích với SDK Vungle phiên bản 7.6.2.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.9.0.
  • SDK Vungle phiên bản 7.6.2.

Phiên bản 7.6.1.0

  • Xác minh khả năng tương thích với SDK Vungle phiên bản 7.6.1.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.7.0.
  • SDK Vungle phiên bản 7.6.1.

Phiên bản 7.6.0.0

  • Xác minh khả năng tương thích với Vungle SDK phiên bản 7.6.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.7.0.
  • SDK Vungle phiên bản 7.6.0.

Phiên bản 7.5.1.1

  • Đã xóa các tham chiếu cấp lớp đến Context. Có thể giúp giảm các vấn đề rò rỉ bộ nhớ.
  • Thêm cách triển khai API mới cho Quảng cáo biểu ngữ dạng thác nước.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.7.0.
  • SDK Vungle phiên bản 7.5.1.

Phiên bản 7.5.1.0

  • Xác minh khả năng tương thích với SDK Vungle phiên bản 7.5.1.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.5.0.
  • SDK Vungle phiên bản 7.5.1.

Phiên bản 7.5.0.1

  • Đặt overrideImpressionRecording thành true cho cả quảng cáo gốc dạng thác nước và quảng cáo gốc đặt giá thầu theo thời gian thực (RTB).

Được tạo và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 24.4.0.
  • SDK Vungle phiên bản 7.5.0.

Phiên bản 7.5.0.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 7.5.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.2.0.
  • SDK Vungle phiên bản 7.5.0.

Phiên bản 7.4.3.1

  • Cập nhật cấp độ API Android tối thiểu bắt buộc lên 23.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 24.0.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.0.0.
  • SDK Vungle phiên bản 7.4.3.

Phiên bản 7.4.3.0

  • Xác minh khả năng tương thích với SDK Vungle phiên bản 7.4.3.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 23.6.0.
  • SDK Vungle phiên bản 7.4.3.

Phiên bản 7.4.2.0

  • Xác minh khả năng tương thích với SDK Vungle phiên bản 7.4.2.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 23.5.0.
  • SDK Vungle phiên bản 7.4.2.

Phiên bản 7.4.1.0

  • Xác minh khả năng tương thích với Vungle SDK phiên bản 7.4.1.

Được tạo và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 23.3.0.
  • SDK Vungle phiên bản 7.4.1.

Phiên bản 7.4.0.1

  • Thêm tính năng hỗ trợ kích thước quảng cáo tuỳ chỉnh cho quảng cáo biểu ngữ đặt giá thầu và quảng cáo biểu ngữ dạng thác nước.

Được tạo và thử nghiệm với:

  • SDK Quảng cáo của Google trên thiết bị di động phiên bản 23.2.0.
  • SDK Vungle phiên bản 7.4.0.

Phiên bản 7.4.0.0

  • Mở rộng lớp VungleInterstitialAdapter từ VungleMediationAdapter để thêm tính năng hỗ trợ quảng cáo dạng thác nước cho định dạng quảng cáo khi mở ứng dụng trên Google Ad Manager.
  • Xác minh khả năng tương thích với Vungle SDK phiên bản 7.4.0.

Được tạo và thử nghiệm với:

  • SDK Quảng cáo của Google trên thiết bị di động phiên bản 23.2.0.
  • SDK Vungle phiên bản 7.4.0.

Phiên bản 7.3.2.0

  • Xác minh khả năng tương thích với SDK Vungle phiên bản 7.3.2.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 23.0.0.
  • SDK Vungle phiên bản 7.3.2.

Phiên bản 7.3.1.0

  • Xác minh khả năng tương thích với Vungle SDK 7.3.1.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 23.0.0.
  • SDK Vungle phiên bản 7.3.1.

Phiên bản 7.3.0.0

  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 23.0.0.
  • Xác minh khả năng tương thích với SDK Vungle phiên bản 7.3.0.
  • Bổ sung tính năng hỗ trợ đặt giá thầu và thác nước cho định dạng quảng cáo khi mở ứng dụng.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 23.0.0.
  • SDK Vungle phiên bản 7.3.0.

Phiên bản 7.1.0.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 7.1.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 22.3.0.
  • SDK Vungle phiên bản 7.1.0.

Phiên bản 7.0.0.1

  • Khắc phục vấn đề Google Mobile Ads SDK không ghi nhận lượt hiển thị cho quảng cáo gốc đặt giá thầu.
  • Huỷ bỏ thay đổi để bộ chuyển đổi phụ thuộc vào Google Mobile Ads SDK phiên bản 22.3.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 22.3.0.
  • SDK Vungle phiên bản 7.0.0.

Phiên bản 7.0.0.0

  • Thêm tính năng hỗ trợ tải nhiều quảng cáo có cùng mã vị trí cho tất cả định dạng quảng cáo dạng thác nước.
  • Đổi tên bộ chuyển đổi từ Vungle thành Liftoff Monetize.
  • Xác minh khả năng tương thích với SDK Vungle phiên bản 7.0.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 22.4.0.
  • SDK Vungle phiên bản 7.0.0.

Phiên bản 6.12.1.1

  • Đã cập nhật bộ chuyển đổi để sử dụng lớp VersionInfo mới.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 22.0.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 22.0.0.
  • SDK Vungle phiên bản 6.12.1.

Phiên bản 6.12.1.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.12.1.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 21.4.0.
  • SDK Vungle phiên bản 6.12.1.

Phiên bản 6.12.0.1

  • Bổ sung tính năng hỗ trợ đặt giá thầu cho định dạng quảng cáo biểu ngữ.
  • Khả năng tương thích đã xác minh với SDK Vungle phiên bản 6.12.0.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 21.4.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 21.4.0.
  • SDK Vungle phiên bản 6.12.0.

Phiên bản 6.12.0.0

  • Bổ sung tính năng đặt giá thầu và dàn xếp kiểu thác nước cho định dạng quảng cáo xen kẽ có tặng thưởng.
  • Bổ sung tính năng hỗ trợ đặt giá thầu cho định dạng quảng cáo gốc.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 21.1.0.
  • SDK Vungle phiên bản 6.12.0.

Phiên bản 6.11.0.3

  • Thêm tính năng hỗ trợ dàn xếp kiểu thác nước cho định dạng quảng cáo gốc.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 21.1.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 21.1.0.
  • SDK Vungle phiên bản 6.11.0.

Phiên bản 6.11.0.2

  • Thêm tính năng hỗ trợ tải nhiều quảng cáo cho cùng một mã vị trí trong quảng cáo đặt giá thầu có tặng thưởng.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 21.0.0.
  • SDK Vungle phiên bản 6.11.0.

Phiên bản 6.11.0.1

  • Cập nhật compileSdkVersion và targetSdkVersion lên API 31.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 21.0.0.
  • Cập nhật cấp độ API Android tối thiểu bắt buộc lên 19.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 21.0.0.
  • SDK Vungle phiên bản 6.11.0.

Phiên bản 6.11.0.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.11.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 20.6.0.
  • SDK Vungle phiên bản 6.11.0.

Phiên bản 6.10.5.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.10.5.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 20.6.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 20.6.0.
  • SDK Vungle phiên bản 6.10.5.

Phiên bản 6.10.4.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.10.4.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 20.5.0.
  • SDK Vungle phiên bản 6.10.4.

Phiên bản 6.10.3.0

  • Xác minh khả năng tương thích với Vungle SDK phiên bản 6.10.3.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 20.5.0.
  • SDK Vungle phiên bản 6.10.3.

Phiên bản 6.10.2.1

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.10.2.
  • Bổ sung tính năng hỗ trợ đặt giá thầu cho định dạng quảng cáo xen kẽ và quảng cáo có tặng thưởng.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 20.5.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 20.5.0.
  • SDK Vungle phiên bản 6.10.2.

Phiên bản 6.10.2.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.10.2.
  • Khắc phục vấn đề về bộ chuyển đổi bằng cách thay thế tham số serverParameters bằng mediationExtras để lấy các tham số dành riêng cho mạng Vungle khi yêu cầu quảng cáo Biểu ngữ và quảng cáo Xen kẽ.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 20.3.0.
  • SDK Vungle phiên bản 6.10.2.

Phiên bản 6.10.1.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.10.1.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 20.3.0.
  • Quảng cáo MREC hiện được hỗ trợ thông qua API biểu ngữ của Vungle.
  • Cập nhật mã lỗi và thông báo lỗi chuẩn hoá.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 20.3.0.
  • SDK Vungle phiên bản 6.10.1.

Phiên bản 6.9.1.1

  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 20.0.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 20.0.0.
  • SDK Vungle phiên bản 6.9.1.

Phiên bản 6.9.1.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.9.1.
  • Thêm tính năng hỗ trợ cho OMSDK.
  • Nhiều bản sửa lỗi khác nhau.
  • Hỗ trợ quảng cáo có tặng thưởng cho lệnh gọi lại onAdViewed của Vungle.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 19.7.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 19.7.0.
  • SDK Vungle phiên bản 6.9.1.

Phiên bản 6.8.1.1

  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 19.6.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 19.6.0.
  • SDK Vungle phiên bản 6.8.1.

Phiên bản 6.8.1.0

  • Đã xác minh khả năng tương thích với Vungle SDK 6.8.1.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 19.5.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 19.5.0.
  • SDK Vungle phiên bản 6.8.1.

Phiên bản 6.8.0.0

  • Xác minh khả năng tương thích với SDK Vungle phiên bản 6.8.0.
  • Cập nhật bộ chuyển đổi để không chuyển tiếp onAdClosed() khi quảng cáo biểu ngữ được làm mới hoặc bị huỷ.
  • Xoá FlexFeed và FlexView (không dùng nữa trong Vungle 6.8.0).
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 19.4.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 19.4.0.
  • SDK Vungle phiên bản 6.8.0.

Phiên bản 6.7.1.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.7.1.
  • Khắc phục lỗi quảng cáo không tải nếu quảng cáo được tải bằng ngữ cảnh ứng dụng.
  • Cập nhật targetSdkVersion lên API 29.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 19.3.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 19.3.0.
  • SDK Vungle phiên bản 6.7.1.

Phiên bản 6.7.0.0

  • Xác minh khả năng tương thích với SDK Vungle phiên bản 6.7.0.
  • Cập nhật bộ chuyển đổi để hỗ trợ các yêu cầu về biểu ngữ thích ứng cùng dòng.
  • Quảng cáo xen kẽ và quảng cáo có tặng thưởng hiện được bật tiếng theo mặc định.
  • Quảng cáo xen kẽ hiện chuyển tiếp lệnh gọi lại onAdLeftApplication() khi được nhấp vào.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 19.2.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 19.2.0.
  • SDK Vungle phiên bản 6.7.0.

Phiên bản 6.5.3.0

  • Đã xác minh khả năng tương thích với Vungle SDK 6.5.3.
  • Bổ sung tính năng hỗ trợ cho định dạng Biểu ngữ mới ra mắt của Vungle.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 19.0.1.

Được tạo và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 19.0.1.
  • SDK Vungle phiên bản 6.5.3.

Phiên bản 6.4.11.1

  • Khắc phục vấn đề quảng cáo biểu ngữ không làm mới được.

Phiên bản 6.4.11.0

  • Đã xác minh khả năng tương thích với Vungle SDK 6.4.11.
  • Thêm tính năng hỗ trợ cho quảng cáo biểu ngữ.
  • Di chuyển bộ chuyển đổi sang AndroidX.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên 18.2.0.

Phiên bản 6.3.24.1

  • Cập nhật bộ chuyển đổi để hỗ trợ API quảng cáo có tặng thưởng mới trong giai đoạn thử nghiệm beta công khai.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 17.2.0.

Phiên bản 6.3.24.0

  • Đã xác minh khả năng tương thích với SDK Vungle 6.3.24.

Phiên bản 6.3.17.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.3.17.

Phiên bản 6.3.12.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.3.12.

Phiên bản 6.2.5.1

  • Cập nhật bộ chuyển đổi để gọi sự kiện quảng cáo onRewardedVideoComplete().

Phiên bản 6.2.5.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.2.5.

Phiên bản 5.3.2.1

  • Cập nhật bộ chuyển đổi để báo cáo chính xác số lượt nhấp cho Google Mobile Ads SDK.

Phiên bản 5.3.2.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 5.3.2.
  • Cập nhật dự án Adapter cho Android Studio 3.0.
  • Thêm các phương thức sau vào lớp trình tạo Gói.
    • setOrdinalViewCount : Trường này được dùng để truyền số thứ tự dàn xếp, bất cứ khi nào Nhà xuất bản nhận được báo cáo dữ liệu số thứ tự từ Vungle.
    • setFlexViewCloseTimeInSec : Tuỳ chọn này dùng để tự động đóng quảng cáo chế độ xem linh hoạt sau số giây được chỉ định.

Phiên bản 5.3.0.0

  • Đã xác minh khả năng tương thích với SDK Vungle phiên bản 5.3.0.

Phiên bản 5.1.0.0

  • Cập nhật bộ chuyển đổi để tương thích với SDK Vungle 5.1.0.
  • Thay đổi hệ thống đặt tên phiên bản thành [phiên bản SDK Vungle].[phiên bản bản vá của bộ chuyển đổi].

Các phiên bản trước

  • Thêm tính năng hỗ trợ cho định dạng quảng cáo xen kẽ và quảng cáo dạng video có tặng thưởng.