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 để 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 iOS.

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:

Đ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:

• Mục tiêu triển khai iOS từ 13.0 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).

• Phiên bản Google Mobile Ads SDK mới nhất.

• Thiết lập tính năng Dàn xếp AdMob.

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:

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

Tìm 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

Sử dụng Trình quản lý gói Swift

Trước khi tiếp tục, bạn phải có phiên bản bộ chuyển đổi tối thiểu được hỗ trợ là 7.5.3.0.

Để thêm phần phụ thuộc gói vào dự án, hãy làm theo các bước sau:

1. Trong Xcode, hãy chuyển đến File > Add Package Dependencies... (Tệp > Thêm phần phụ thuộc của gói...).

2. Trong lời nhắc xuất hiện, hãy tìm URL gói sau:

   https://github.com/googleads/googleads-mobile-ios-mediation-liftoffmonetize.git
   

3. Trong Quy tắc phụ thuộc, hãy chọn Chi nhánh.

4. Trong trường văn bản, hãy nhập main.

Sử dụng CocoaPods

• Thêm dòng sau vào Podfile của dự án:

  pod 'GoogleMobileAdsMediationVungle'
  

• Trên dòng lệnh, hãy chạy:

  pod install --repo-update

Tích hợp thủ công

• Tải phiên bản mới nhất của Vungle iOS SDK xuống rồi liên kết VungleAdsSDK.xcframework trong dự án của bạn.

• Tải phiên bản mới nhất của bộ chuyển đổi Liftoff Monetize xuống từ đường liên kết để tải xuống trong Nhật ký thay đổi rồi liên kết LiftoffMonetizeAdapter.xcframework trong dự án của bạn.

• Thêm các Khung sau vào dự án của bạn:

  • AdSupport
  • AudioToolbox
  • AVFoundation
  • CFNetwork
  • CoreGraphics
  • CoreMedia
  • libz.tbd
  • MediaPlayer
  • QuartzCore
  • StoreKit
  • SystemConfiguration

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

Sự đồng ý của người dùng ở Liên minh Châu Âu và GDPR

Để 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.

VunglePrivacySettings.setCCPAStatus(true)
LiftoffMonetizeMediationSwiftSnippets.swift

[VunglePrivacySettings setCCPAStatus:YES];
LiftoffMonetizeMediationObjectiveCSnippets.m

Hãy xem hướng dẫn triển khai được đề xuất theo 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

Triển khai SKAdNetwork

Làm theo tài liệu của Liftoff Monetize để thêm giá trị nhận dạng SKAdNetwork vào tệp Info.plist của dự án.

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ợ một tham số yêu cầu bổ sung có thể được truyền đến bộ chuyển đổi bằng lớp VungleAdNetworkExtras. Lớp này bao gồm các thuộc tính sau:

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.

nativeAdOptionPosition

Một số nguyên chỉ định vị trí biểu tượng quyền riêng tư cho quảng cáo gốc.

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:

let adRequest = Request()
let extras = VungleAdNetworkExtras()
extras.userId = "myUserID"
extras.nativeAdOptionPosition = AdChoicesPosition.topRightCorner
// ...
adRequest.register(extras)
LiftoffMonetizeMediationSwiftSnippets.swift

GADRequest *adRequest = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.userId = @"myUserID";
extras.nativeAdOptionPosition = GADAdChoicesPositionTopRightCorner;
// ...
[adRequest registerAdNetworkExtras:extras];
LiftoffMonetizeMediationObjectiveCSnippets.m

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

¹ 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 GADMediaView 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 GADResponseInfo.adNetworkInfoArray trong các lớp sau:

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:

Đố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 iOS

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 13.11.0.
• SDK Vungle phiên bản 7.7.8.

Phiên bản 7.7.7.0

• Đã 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 13.9.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ập nhật bộ chuyển đổi để dựa vào SDK Vungle nhằm kiểm tra xem quảng cáo khi mở ứng dụng đã sẵn sàng phát hay chưa.

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

• Google Mobile Ads SDK phiên bản 13.7.0.
• SDK Vungle phiên bản 7.7.6.

Phiên bản 7.7.5.0

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

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

• Google Mobile Ads SDK phiên bản 13.7.0.
• SDK Vungle phiên bản 7.7.5.

Phiên bản 7.7.4.0

• Đã xác minh khả năng tương thích với SDK Vungle phiên bản 7.7.4.
• Cập nhật phiên bản tối thiểu của SDK Quảng cáo của Google trên thiết bị di động cho iOS thành 13.3 để nới lỏng và cho phép các phiên bản nhỏ.

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

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

Phiên bản 7.7.3.0

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

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

• Google Mobile Ads SDK phiên bản 13.4.0.
• SDK Vungle phiên bản 7.7.3.

Phiên bản 7.7.2.1

• Bộ chuyển đổi hiện chuyển tiếp cờ ageRestrictedTreatment của Google Mobile Ads SDK đến API COPPA của SDK Vungle.

Đượ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 13.3.0.
• SDK Vungle phiên bản 7.7.2.

Phiên bản 7.7.2.0

• Đã thêm thông điệp nhật ký khi có yêu cầu về kích thước quảng cáo biểu ngữ không được hỗ trợ.
• Thêm chế độ cài đặt thuộc tính adapterAdFormat được giới thiệu trong SDK Vungle phiên bản 7.7.1.
• 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 13.2.0.
• 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 13.1.0.
• SDK Vungle phiên bản 7.7.1.

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ập nhật phần phụ thuộc Google Mobile Ads SDK lên phiên bản 13.0.0 trở lên.
• Tăng mục tiêu triển khai iOS tối thiểu lên 13.0.
• Thêm tính năng hỗ trợ cho các lựa chọn video gốc và lệnh gọi lại của trình uỷ quyền chế độ xem nội dung nghe nhìn.

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

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

Phiên bản 7.6.3.2

• Cập nhật phiên bản iOS tối thiểu của CocoaPods lên 13.0.

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

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

Phiên bản 7.6.3.1

• Thêm tính năng hỗ trợ chuyển tiếp các tham số tagForChildDirectedTreatment và tagForUnderAgeOfConsent của SDK quảng cáo trên thiết bị di động của Google đến SDK Vungle.

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

• Google Mobile Ads SDK phiên bản 12.14.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 12.14.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 12.13.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 12.12.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 12.11.0.
• SDK Vungle phiên bản 7.6.0.

Phiên bản 7.5.3.0

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

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

• Google Mobile Ads SDK phiên bản 12.8.0.
• SDK Vungle phiên bản 7.5.3.

Phiên bản 7.5.2.0

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

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

• Google Mobile Ads SDK phiên bản 12.7.0.
• SDK Vungle phiên bản 7.5.2.

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 12.4.0.
• SDK Vungle phiên bản 7.5.1.

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:

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

Phiên bản 7.4.5.0

• Đã bật cờ -fobjc-arc và -fstack-protector-all.
• Xác minh khả năng tương thích với Vungle SDK 7.4.5.

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

• Google Mobile Ads SDK phiên bản 12.2.0.
• SDK Vungle phiên bản 7.4.5.

Phiên bản 7.4.4.1

• Hiện yêu cầu Google Mobile Ads SDK phiên bản 12.0.0 trở lên.

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

• Google Mobile Ads SDK phiên bản 12.0.0.
• SDK Vungle phiên bản 7.4.4.

Phiên bản 7.4.4.0

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

Đượ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 11.13.0.
• SDK Vungle phiên bản 7.4.4.

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:

• SDK quảng cáo trên thiết bị di động của Google phiên bản 11.13.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 11.10.0.
• SDK Vungle phiên bản 7.4.2.

Phiên bản 7.4.1.1

• Cập nhật CFBundleShortVersionString để có 3 thành phần thay vì 4.

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

• Google Mobile Ads SDK phiên bản 11.10.0.
• SDK Vungle phiên bản 7.4.1.

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ập nhật VungleAdNetworkExtras.nativeAdOptionPosition để sử dụng các giá trị từ GADAdChoicesPosition nhằm chỉ định vị trí của biểu tượng Lựa chọn quảng cáo.
• Thêm tính năng hỗ trợ tỷ lệ khung hình vào đị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 11.10.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ợ cho kích thước quảng cáo biểu ngữ tuỳ chỉnh cho hoạt động đặt giá thầu và quy trình dàn xếp kiểu thác nước.

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

• Google Mobile Ads SDK phiên bản 11.7.0.
• SDK Vungle phiên bản 7.4.0.

Phiên bản 7.4.0.0

• 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:

• Google Mobile Ads SDK phiên bản 11.6.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:

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

Phiên bản 7.3.1.1.0

• Xác minh khả năng tương thích với SDK Vungle phiên bản 7.3.1.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 11.3.0.
• SDK Vungle phiên bản 7.3.1.1.

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:

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

Phiên bản 7.3.0.0

• Xác minh khả năng tương thích với SDK Vungle phiên bản 7.3.0.
• Khắc phục vấn đề không thể nhập bộ chuyển đổi trong Swift.
• 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:

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

Phiên bản 7.2.2.1

• Hiện yêu cầu phiên bản iOS tối thiểu là 12.0.
• Hiện yêu cầu Google Mobile Ads SDK phiên bản 11.0 trở lên.
• Đã thêm Info.plist vào các khung trong LiftoffMonetizeAdapter.xcframework.

Đượ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 11.0.1.
• SDK Vungle phiên bản 7.2.2.

Phiên bản 7.2.2.0

• Đã xác minh khả năng tương thích với SDK Vungle phiên bản 7.2.2.
• Hiện yêu cầu phiên bản iOS tối thiểu là 12.0.

Đượ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 11.0.0.
• SDK Vungle phiên bản 7.2.2.

Phiên bản 7.2.1.1

• Cập nhật tiêu chí so khớp MREC thành bất kỳ kích thước nào có thể vừa với MREC thay vì so khớp chính xác.

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

• Google Mobile Ads SDK phiên bản 10.14.0.
• SDK Vungle phiên bản 7.2.1.

Phiên bản 7.2.1.0

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

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

• Google Mobile Ads SDK phiên bản 10.14.0.
• SDK Vungle phiên bản 7.2.1.

Phiên bản 7.2.0.0

• Đã xác minh khả năng tương thích với SDK Vungle phiên bản 7.2.0.
• Xoá các phương thức uỷ quyền willBackgroundApplication không dùng nữa khỏi các cách triển khai quảng cáo biểu ngữ và quảng cáo xen kẽ.
• Thay thế phương thức childDirectedTreatment không dùng nữa bằng thuộc tính GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment.

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

• Google Mobile Ads SDK phiên bản 10.14.0.
• SDK Vungle phiên bản 7.2.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 10.10.0.
• SDK Vungle phiên bản 7.1.0.

Phiên bản 7.0.1.0

• Thêm tính năng hỗ trợ hình mờ cho quảng cáo đặt giá thầu.
• Đã xác minh khả năng tương thích với SDK Vungle phiên bản 7.0.1.

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

• Google Mobile Ads SDK phiên bản 10.7.0.
• SDK Vungle phiên bản 7.0.1.

Phiên bản 7.0.0.0

• Đổ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.
• Xoá tính năng hỗ trợ kiến trúc armv7.
• Thêm tính năng hỗ trợ cho cấu trúc trình mô phỏng arm64.
• Hiện yêu cầu phiên bản iOS tối thiểu là 11.0.
• Hiện yêu cầu SDK quảng cáo trên thiết bị di động của Google phiên bản 10.4.0 trở lên.

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

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

Phiên bản 6.12.3.0

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

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

• Google Mobile Ads SDK phiên bản 10.2.0.
• SDK Vungle phiên bản 6.12.3.

Phiên bản 6.12.2.0

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

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

• Google Mobile Ads SDK phiên bản 10.0.0.
• SDK Vungle phiên bản 6.12.2.

Phiên bản 6.12.1.2

• Hiện yêu cầu Google Mobile Ads SDK phiên bản 10.0.0 trở lên.

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

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

Phiên bản 6.12.1.1

• Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.12.1.
• Bổ sung tính năng hỗ trợ đặt giá thầu cho định dạng quảng cáo biểu ngữ.

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

• Google Mobile Ads SDK phiên bản 9.14.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 9.13.0.
• SDK Vungle phiên bản 6.12.1.

Phiên bản 6.12.0.0

• Khả năng tương thích đã xác minh với SDK Vungle phiên bản 6.12.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ập nhật bộ chuyển đổi để sử dụng API didRewardUser.
• Đã xóa ordinal thừa trong VungleAdNetworkExtras.
• Hiện yêu cầu Google Mobile Ads SDK phiên bản 9.8.0 trở lên.

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

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

Phiên bản 6.11.0.2

• 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 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 9.8.0.
• SDK Vungle phiên bản 6.11.0.

Phiên bản 6.11.0.1

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

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

• Google Mobile Ads SDK phiên bản 9.6.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 9.4.0.
• SDK Vungle phiên bản 6.11.0

Phiên bản 6.10.6.1

• Khắc phục vấn đề trong đó uỷ quyền quảng cáo bị xoá nếu quảng cáo tiếp theo không tải xuống được. Điều này chỉ áp dụng cho các vị trí đặt quảng cáo được lưu vào bộ nhớ đệm tự động.
• Đã xóa lệnh gọi lại willPresentFullScreenView và adapterWillPresentFullScreenModal trong quảng cáo biểu ngữ.

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

• Google Mobile Ads SDK phiên bản 9.0.0.
• SDK Vungle phiên bản 6.10.6

Phiên bản 6.10.6.0

• Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.10.6.
• Đã xác minh khả năng tương thích với SDK quảng cáo trên thiết bị di động của Google phiên bản 9.0.0.
• Hiện yêu cầu Google Mobile Ads SDK phiên bản 9.0.0 trở lên.

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

• Google Mobile Ads SDK phiên bản 9.0.0.
• SDK Vungle phiên bản 6.10.6

Phiên bản 6.10.5.1

• 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 tạo và thử nghiệm với

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

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 tạo và thử nghiệm với

• Google Mobile Ads SDK phiên bản 8.13.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ập nhật bộ chuyển đổi để tuân thủ chế độ cài đặt tắt tiếng trong trang tổng quan của nhà xuất bản Vungle khi boolean muteIsSet trong VungleAdNetworkExtras không được đặt rõ ràng.

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

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

Phiên bản 6.10.3.1

• Sửa lỗi lệnh gọi lại quảng cáo xen kẽ không được gọi sau lần phát đầu tiên.
• Cập nhật từ điển options được truyền vào phương thức playAd để thêm thuộc tính bị tắt tiếng do nhà xuất bản đặt trong đối tượng bổ sung.

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

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

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.
• Hiện yêu cầu phiên bản iOS tối thiểu là 10.0.

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

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

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.
• Giảm bớt phần phụ thuộc vào Google Mobile Ads SDK phiên bản 8.0.0 trở lên.
• Hiện yêu cầu tạo bản dựng bằng Xcode 12.5 trở lên.

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

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

Phiên bản 6.10.0.0 (đã khôi phục)

• Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.10.0.
• Giảm bớt phần phụ thuộc vào Google Mobile Ads SDK phiên bản 8.0.0 trở lên.
• Hiện yêu cầu tạo bản dựng bằng Xcode 12.5 trở lên.

Đượ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 8.4.0.
• SDK Vungle phiên bản 6.10.0.

Phiên bản 6.9.2.0

• Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.9.2.
• Hiện yêu cầu SDK quảng cáo trên thiết bị di động của Google phiên bản 8.3.0 trở lên.

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

• Google Mobile Ads SDK phiên bản 8.3.0.
• SDK Vungle phiên bản 6.9.2.

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.
• Hiện yêu cầu SDK quảng cáo trên thiết bị di động của Google phiên bản 8.1.0 trở lên.
• Thêm mã lỗi và thông báo lỗi chuẩn hoá của bộ chuyển đổi.
• Cập nhật bộ chuyển đổi để sử dụng định dạng .xcframework.
• Xoá quy trình kiểm tra lỗi VungleSDKResetPlacementForDifferentAdSize khi tải quảng cáo.
• Ra mắt lệnh gọi lại uỷ quyền SDK mới vungleAdViewedForPlacement: để theo dõi lượt hiển thị.

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

• Google Mobile Ads SDK phiên bản 8.1.0.
• SDK Vungle phiên bản 6.9.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.
• Hiện yêu cầu SDK quảng cáo trên thiết bị di động của Google phiên bản 7.66.0 trở lên.

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

• Google Mobile Ads SDK phiên bản 7.66.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.
• Hiện yêu cầu Google Mobile Ads SDK phiên bản 7.65.0 trở lên.

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

• Google Mobile Ads SDK phiên bản 7.65.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.
• Hiện yêu cầu Google Mobile Ads SDK phiên bản 7.64.0 trở lên.
• Khắc phục vấn đề không gọi được didFailToPresentWithError: khi quảng cáo có tặng thưởng không hiển thị được.

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

• Google Mobile Ads SDK phiên bản 7.64.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.
• Hiện yêu cầu Google Mobile Ads SDK phiên bản 7.62.0 trở lên.
• Bổ sung tính năng hỗ trợ phát nhiều quảng cáo biểu ngữ cùng một lúc.
• Giờ đây, lượt nhấp sẽ được báo cáo khi xảy ra lượt nhấp thay vì khi quảng cáo bị đóng.
• Quảng cáo biểu ngữ và quảng cáo xen kẽ hiện chuyển tiếp lệnh gọi lại willLeaveApplication.

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

• Google Mobile Ads SDK phiên bản 7.62.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.
• Hiện yêu cầu Google Mobile Ads SDK phiên bản 7.58.0 trở lên.
• Bổ sung tính năng hỗ trợ cho quảng cáo Biểu ngữ thông minh và Biểu ngữ thích ứng.
• Thêm tính năng hỗ trợ cho quảng cáo Biểu ngữ (320x50, 300x50, 728x90).
• Thêm lựa chọn hướng video khi phát quảng cáo.
• Khắc phục lỗi không gọi được report_ad sau lần làm mới đầu tiên.
• Khắc phục vấn đề về độ trễ của quảng cáo có sẵn bằng thác nước dài hơn.
• Xoá tính năng hỗ trợ cho cấu trúc i386.

Đượ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 7.58.0.
• SDK Vungle phiên bản 6.5.3.

Phiên bản 6.4.6.0

• Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.4.6.
• Thêm tính năng hỗ trợ cho quảng cáo biểu ngữ (MREC).
• Khắc phục lỗi khiến lệnh gọi lại didReceiveInterstitial: được gọi nhiều lần.
• Đã xóa các lệnh gọi lại đến adapterWillLeaveApplication, vốn trước đây không được gọi vào đúng thời điểm.

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

• Google Mobile Ads SDK phiên bản 7.52.0.
• SDK Vungle phiên bản 6.4.6.

Phiên bản 6.3.2.3

• Khắc phục sự cố trong [GADMAdapterVungleRewardedAd adAvailable:].

Phiên bản 6.3.2.2

• Khắc phục lỗi khiến bộ chuyển đổi Vungle không bao giờ tải quảng cáo có tặng thưởng nếu không khởi chạy được SDK Vungle. Giờ đây, bộ chuyển đổi sẽ cố gắng khởi chạy lại SDK Vungle trong các yêu cầu quảng cáo có tặng thưởng tiếp theo.
• Hiện yêu cầu SDK quảng cáo trên thiết bị di động của Google phiên bản 7.42.2 trở lên.

Phiên bản 6.3.2.1

• Cập nhật bộ chuyển đổi để sử dụng API quảng cáo có tặng thưởng mới.
• Hiện yêu cầu SDK quảng cáo trên thiết bị di động của Google phiên bản 7.41.0 trở lên.

Phiên bản 6.3.2.0

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

Phiên bản 6.3.0.0

• Đã xác minh khả năng tương thích với SDK Vungle phiên bản 6.3.0.
• Đã cập nhật phương thức updateConsentStatus thành updateConsentStatus:consentMessageVersion: trong lớp VungleRouterConsent.

Phiên bản 6.2.0.3

• Thêm lệnh gọi lại adapterDidCompletePlayingRewardBasedVideoAd: vào trình chuyển đổi.

Phiên bản 6.2.0.2

• Thêm lớp VungleRouterConsent chứa các phương thức updateConsentStatus và getConsentStatus.

Phiên bản 6.2.0.1

• Cập nhật trình khởi chạy SDK Vungle đúng cách.

Phiên bản 6.2.0.0

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

Phiên bản 5.4.0.0

• Đã xác minh khả năng tương thích với Vungle SDK phiên bản 5.4.0.
• 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

• Thêm hai thành phần bổ sung mới vào VungleAdNetworkExtras:
  • ordinal – Một số nguyên cho biết thứ tự hiển thị quảng cáo này trong phiên trò chơi.
  • flexViewAutoDismissSeconds – Đặt quảng cáo Flex View tự động đóng sau số giây được chỉ định.
• Đã xác minh khả năng tương thích với SDK Vungle phiên bản 5.3.2.

Phiên bản 5.3.0.0

• Cập nhật mục tiêu triển khai lên iOS 8.
• Đã 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.2.0.0

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

Phiên bản 5.1.1.0

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

Phiên bản 5.1.0.0

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

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.