Hướng dẫn này chỉ cho bạn cách sử dụng SDK Quảng cáo của Google trên thiết bị di động để tải và hiển thị quảng cáo từ Unity Ads bằng cách sử dụng dàn xếp, bao gồm việc tích hợp thác nước. Hướng dẫn này trình bày cách thêm Quảng cáo Unity vào cấu hình dàn xếp cũng như cách tích hợp SDK Unity Ads và bộ chuyển đổi vào ứng dụng Android .
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 Unity Ads có các khả năng sau:
Tích hợp | |
---|---|
Đặt giá thầu | |
Thác nước | |
Định dạng | |
Biểu ngữ | |
Quảng cáo xen kẽ | |
Được thưởng | |
Mã gốc |
Yêu cầu
- Android API cấp 21 trở lên
SDK Quảng cáo của Google trên thiết bị di động mới nhất
Hoàn tất quá trình dàn xếp Hướng dẫn bắt đầu sử dụng
Bước 1: Thiết lập cấu hình trong giao diện người dùng Unity Ads
Đăng ký hoặc đăng nhập vào Unity Ads.
Tạo một dự án
Trên Trang tổng quan quảng cáo Unity, hãy chuyển đến Projects (Dự án) rồi nhấp vào Create Project (Tạo dự án).
Điền vào biểu mẫu rồi nhấp vào Create Project (Tạo dự án) để thêm dự án của bạn.
Chuyển đến mục Kiếm tiền > Bắt đầu, rồi nhấp vào Bắt đầu.
Trong cửa sổ Thiết lập dự án, hãy chọn Tôi dự định sử dụng Dàn xếp và Google AdMob cho Đối tác dàn xếp, sau đó nhấp vào Tiếp theo.
Chọn chế độ cài đặt quảng cáo, rồi nhấp vào Tiếp theo.
Điền vào biểu mẫu, sau đó nhấp vào Thêm dự án.
Ghi lại Mã nhận dạng trò chơi.
Tạo Đơn vị quảng cáo
Chuyển đến mục Kiếm tiền > Đơn vị quảng cáo, rồi nhấp vào Thêm đơn vị quảng cáo.
Nhập Ad Unit Name, sau đó chọn Platform (Nền tảng) và Ad Format (Định dạng quảng cáo).
Cuối cùng, nhấp vào Tạo để lưu đơn vị quảng cáo của bạn.
Thêm vị trí
Sau khi tạo dự án, hãy chuyển đến phần Kiếm tiền > Vị trí đặt quảng cáo. Người nhận tạo vị trí mới, hãy nhấp vào Thêm vị trí cho đơn vị quảng cáo của bạn.
Điền thông tin cần thiết và nhấp vào Thêm vị trí.
Ghi lại Mã vị trí.
Xác định vị trí khoá Unity Ads Reporting API
Đặt giá thầu
Bạn không bắt buộc phải thực hiện bước này để tích hợp tính năng đặt giá thầu.
Thác nước
Ngoài Mã trò chơi và Mã vị trí, bạn cũng sẽ cần Khoá API và Mã nhận dạng chính của tổ chức cho Unity Ads để thiết lập Ad Manager mã đơn vị quảng cáo.
Chuyển đến mục Kiếm tiền > Thiết lập > Quản lý API và ghi chú về Khoá truy cập API số liệu thống kê về hoạt động kiếm tiền.
Sau đó, hãy chuyển đến thẻ Kiếm tiền > Cài đặt tổ chức và ghi chú của Mã nhận dạng chính của tổ chức.
Bật chế độ thử nghiệm
Bạn có thể bật chế độ thử nghiệm từ Trang tổng quan Unity Ads. Trong phần Cài đặt, chọn thẻ Thử nghiệm.
Bạn có thể buộc sử dụng chế độ thử nghiệm cho ứng dụng bằng cách nhấp vào nút chỉnh sửa bên cạnh Cửa hàng Google Play , chọn Ghi đè chế độ thử nghiệm ứng dụng và chọn Buộc chế độ thử nghiệm BẬT (tức là sử dụng quảng cáo thử nghiệm) cho tất cả thiết bị.
Ngoài ra, bạn có thể bật chế độ thử nghiệm cho các thiết bị cụ thể bằng cách nhấp vào Nút Thêm thiết bị thử nghiệm.
Điền thông tin vào biểu mẫu và nhấp vào mục Lưu.
Bước 2: Thiết lập nhu cầu của Unity Ads trong Ad Manager giao diện người dùng
Định cấu hình cài đặt dàn xếp cho đơn vị quảng cáo của bạn
Đăng nhập vào tài khoản Ad Manager của bạn.
Chuyển đến phần Phân phối > Nhóm lợi nhuận và nhấp vào nút Nhóm lợi nhuận mới.
Nhập một Tên riêng biệt cho nhóm lợi nhuận của bạn, đặt Trạng thái thành Đang hoạt động, chọn Định dạng quảng cáo và đặt Loại khoảng không quảng cáo thành Ứng dụng dành cho thiết bị di động. Trong phần Nhắm mục tiêu > Khoảng không quảng cáo, hãy chọn đơn vị quảng cáo trong Khoảng không quảng cáo và Ứng dụng dành cho thiết bị di động mà bạn muốn thêm tính năng dàn xếp.
Tiếp theo, hãy nhấp vào nút Thêm đối tác lợi nhuận.
Nếu đã có Đối tác lợi nhuận cho Unity Ads, thì bạn có thể chọn đối tác đó. Nếu không, hãy chọn Tạo đối tác lợi nhuận mới.
Chọn Unity Ads làm Mạng quảng cáo, nhập Tên riêng biệt và bật tính năng Dàn xếp.
Bật tuỳ chọn Thu thập dữ liệu tự động rồi nhậpAPI Key and Organization core ID đã nhận được trong phần trước.
Sau khi chọn Đối tác lợi nhuận, hãy chọn Dàn xếp SDK trên thiết bị di động làm Loại tích hợp, Android làm Nền tảng và Đang hoạt động làm Trạng thái. NhậpGame ID and Placement ID nhận được ở phần trước. Sau đó, hãy nhập giá trị CPM mặc định.
Nhấp vào Lưu ở cuối trang khi hoàn tất.
Thêm Unity Ads vào Quy định chung về việc bảo vệ dữ liệu (GDPR) và danh sách đối tác quảng cáo theo quy định của các tiểu bang ở Hoa Kỳ
Hãy làm theo các bước trong cài đặt GDPR và cài đặt quy định của chính phủ Hoa Kỳ để thêm Unity Ads vào GDPR và danh sách đối tác quảng cáo theo quy định của tiểu bang Hoa Kỳ trong Ad Manager giao diện người dùng.
Bước 3: Nhập SDK Unity Ads và bộ chuyển đổi
Tích hợp Android Studio (nên dùng)
Trong tệp build.gradle.kts
ở cấp ứng dụng, hãy thêm phương thức triển khai sau
các phần phụ thuộc và cấu hình. Sử dụng các phiên bản mới nhất của SDK Unity Ads
và bộ chuyển đổi:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.unity3d.ads:unity-ads:4.12.1")
implementation("com.google.ads.mediation:unity:4.12.2.0")
}
Tích hợp thủ công
Tải SDK quảng cáo Unity mới nhất xuống (
unity-ads.aar
) từ Kho lưu trữ GitHub rồi thêm vào dự án của bạn.Chuyển đến Cấu phần phần mềm của bộ chuyển đổi Unity Ads trên Kho lưu trữ Maven của Google. Chọn phiên bản mới nhất, tải Unity xuống Tệp
.aar
của bộ chuyển đổi quảng cáo rồi thêm tệp này vào dự án của bạn.
Bước 4: Triển khai các chế độ cài đặt quyền riêng tư trên SDK quảng cáo Unity
Sự đồng ý của người dùng ở Liên minh Châu Âu và Quy định chung về việc bảo vệ dữ liệu (GDPR)
Theo Sự đồng ý của người dùng ở Liên minh Châu Âu của Google , bạn phải đảm bảo cung cấp một số thông tin công bố cho, và sự đồng ý của người dùng ở Khu vực kinh tế Châu Âu (EEA) đối với các vấn đề việc sử dụng mã nhận dạng thiết bị và dữ liệu cá nhân. Chính sách này phản ánh 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 Quy định (GDPR). Khi yêu cầu sự đồng ý, bạn phải xác định từng mạng quảng cáo trong chuỗi dàn xếp của mình để có thể thu thập, nhận hoặc sử dụng dữ liệu cá nhân và cung cấp thông tin về cách sử dụng của từng mạng. Hiện tại, Google không thể tự động chuyển lựa chọn đồng ý của người dùng tới các mạng đó.
Trong SDK phiên bản 2.0.0, Unity Ads đã thêm một API để hỗ trợ các chế độ cài đặt quyền riêng tư. Chiến lược phát hành đĩa đơn đoạn mã mẫu sau đây minh hoạ cách chuyển thông tin về sự đồng ý này đến Unity SDK quảng cáo. Bạn có nên chọn chuyển thông tin về sự đồng ý đến SDK quảng cáo Unity theo cách thủ công, bạn nên gọi mã này trước khi yêu cầu quảng cáo thông qua SDK quảng cáo trên thiết bị di động của Google.
Java
import com.unity3d.ads.metadata.MetaData;
// ...
MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
Kotlin
import com.unity3d.ads.metadata.MetaData
// ...
val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
Xem các quảng cáo Unity API dữ liệu và sự đồng ý về quyền riêng tư và Tuân thủ GDPR hướng dẫn để biết thêm thông tin chi tiết và các giá trị có thể được cung cấp trong mỗi phương pháp.
Luật về quyền riêng tư của các tiểu bang ở Hoa Kỳ
Hoa Kỳ luật về quyền riêng tư của các tiểu bang yêu cầu cấp cho người dùng quyền để chọn không tham gia "bán hàng" về "thông tin cá nhân" của họ (theo định nghĩa của luật các điều khoản đó), cùng với lựa chọn không tham gia được cung cấp thông qua thông báo "Không bán thông tin cá nhân của tôi" nổi bật Thông tin" trên trang "bán" của bên thứ ba đó. Chiến lược phát hành đĩa đơn Hoa Kỳ quyền riêng tư của các tiểu bang hướng dẫn tuân thủ luật pháp cung cấp khả năng cho phép xử lý dữ liệu bị hạn chế để phân phát quảng cáo của Google, nhưng Google không thể áp dụng cài đặt này cho mỗi quảng cáo trong chuỗi dàn xếp của mình. Do đó, bạn phải xác định từng mạng quảng cáo trong chuỗi dàn xếp của mình mà có thể tham gia vào việc bán và làm theo hướng dẫn của từng mạng đó để đảm bảo sự tuân thủ.
Trong SDK phiên bản 2.0.0, Unity Ads đã thêm một API để hỗ trợ các chế độ cài đặt quyền riêng tư. Chiến lược phát hành đĩa đơn đoạn mã mẫu sau đây minh hoạ cách chuyển thông tin về sự đồng ý này đến Unity SDK quảng cáo. Bạn có nên chọn chuyển thông tin về sự đồng ý đến SDK quảng cáo Unity theo cách thủ công, bạn nên gọi mã này trước khi yêu cầu quảng cáo thông qua SDK quảng cáo trên thiết bị di động của Google.
Java
import com.unity3d.ads.metadata.MetaData;
// ...
MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
Kotlin
import com.unity3d.ads.metadata.MetaData
// ...
val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
Xem các quảng cáo Unity API dữ liệu và sự đồng ý về quyền riêng tư và Tuân thủ CCPA hướng dẫn để biết thêm thông tin chi tiết và các giá trị có thể được cung cấp trong mỗi phương pháp.
Bước 5: Thêm mã bắt buộc
Bạn không cần thêm đoạn mã để tích hợp với Unity Ads.
Bước 6: Kiểm tra kết quả triển khai
Bật quảng cáo thử nghiệm
Hãy nhớ đăng ký thiết bị thử nghiệm cho Ad Manager và bật chế độ thử nghiệm trong Unity Ads giao diện người dùng.
Xác minh quảng cáo thử nghiệm
Để xác minh rằng bạn đang nhận quảng cáo thử nghiệm từ Unity Ads, 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ách sử dụng Unity Ads (Waterfall) (các) nguồn quảng cáo.
Mã lỗi
Nếu bộ chuyển đổi không nhận được quảng cáo từ Unity Ads,
nhà xuất bản có thể kiểm tra lỗi cơ bản trong nội dung phản hồi quảng cáo bằng cách sử dụng
ResponseInfo.getAdapterResponses()
thuộc các lớp sau:
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
Dưới đây là mã và thông báo đi kèm do bộ chuyển đổi UnityAds gửi khi không thể tải quảng cáo:
Mã lỗi | Lý do |
---|---|
0-10 | SDK UnityAds trả về một lỗi. Xem mã để biết thêm chi tiết. |
101 | Các tham số máy chủ UnityAds được định cấu hình trong Ad Manager giao diện người dùng bị thiếu/không hợp lệ. |
102 | UnityAds trả về một vị trí có trạng thái NO_FILL. |
103 | UnityAds trả về một vị trí có trạng thái TẮT. |
104 | UnityAds đã cố hiển thị một quảng cáo có ngữ cảnh rỗng. |
105 | Ngữ cảnh dùng để khởi chạy, tải và/hoặc hiển thị quảng cáo từ Unity Ads không phải là một phiên bản của Hoạt động. |
106 | UnityAds đã cố gắng hiển thị một quảng cáo chưa sẵn sàng hiển thị. |
107 | UnityAds không được hỗ trợ trên thiết bị này. |
108 | UnityAds chỉ có thể tải 1 quảng cáo cho mỗi vị trí tại một thời điểm. |
109 | UnityAds đã kết thúc với trạng thái LỖI. |
200-204 | Lỗi cụ thể đối với Biểu ngữ UnityAds. Xem mã để biết thêm chi tiết. |
Nhật ký thay đổi của bộ chuyển đổi dàn xếp Android cho Unity Ads
Phiên bản 4.12.2.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.12.2.
Được xây dựng 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 quảng cáo Unity phiên bản 4.12.2.
Phiên bản 4.12.1.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.12.1.
Được xây dựng 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 quảng cáo Unity phiên bản 4.12.1.
Phiên bản 4.12.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.12.0.
Được xây dựng 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.1.0.
- SDK quảng cáo Unity phiên bản 4.12.0.
Phiên bản 4.11.3.0
- Đã thêm tính năng hỗ trợ đặt giá thầu cho các định dạng quảng cáo biểu ngữ, quảng cáo xen kẽ và quảng cáo có tặng thưởng.
- Xác minh khả năng tương thích với SDK Unity Ads 4.11.3.
Được xây dựng 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.1.0.
- SDK Unity Ads phiên bản 4.11.3.
Phiên bản 4.11.2.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.11.2.
Được xây dựng 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.0.0.
- SDK quảng cáo Unity phiên bản 4.11.2.
Phiên bản 4.10.0.0
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 23.0.0.
- Xác minh khả năng tương thích với SDK Unity Ads 4.10.0.
Được xây dựng 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.0.0.
- SDK quảng cáo Unity phiên bản 4.10.0.
Phiên bản 4.9.3.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.9.3.
Được xây dựng 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 22.6.0.
- SDK Unity Ads phiên bản 4.9.3.
Phiên bản 4.9.2.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.9.2.
Được xây dựng 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 22.3.0.
- SDK quảng cáo Unity phiên bản 4.9.2.
Phiên bản 4.9.1.0
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 22.3.0.
- Xác minh khả năng tương thích với SDK Unity Ads 4.9.1.
Được xây dựng 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 22.3.0.
- SDK quảng cáo Unity phiên bản 4.9.1.
Phiên bản 4.8.0.0
- Báo cáo số lượt hiển thị quảng cáo khi SDK quảng cáo Unity gọi onBannerRequested() mới của nó phương thức gọi lại.
- Xác minh khả năng tương thích với SDK Unity Ads 4.8.0.
Được xây dựng 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 22.2.0.
- SDK quảng cáo Unity phiên bản 4.8.0.
Phiên bản 4.7.1.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.7.1.
Được xây dựng 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 22.1.0.
- SDK quảng cáo Unity phiên bản 4.7.1.
Phiên bản 4.7.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.7.0.
Được xây dựng 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 22.0.0.
- SDK quảng cáo Unity phiên bản 4.7.0.
Phiên bản 4.6.1.1
- Cập nhật trình 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 SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 22.0.0.
Được xây dựng 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 22.0.0.
- SDK quảng cáo Unity phiên bản 4.6.1.
Phiên bản 4.6.1.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.6.1.
Được xây dựng 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 21.5.0
- SDK quảng cáo Unity phiên bản 4.6.1.
Phiên bản 4.6.0.0
- Bổ sung tính năng hỗ trợ chuyển tiếp thông tin COPPA (Đạo luật bảo vệ quyền riêng tư của trẻ em trên mạng) đến SDK quảng cáo Unity.
- Xác minh khả năng tương thích với SDK Unity Ads 4.6.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 21.5.0.
Được xây dựng 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 21.5.0
- SDK quảng cáo Unity phiên bản 4.6.0.
Phiên bản 4.5.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.5.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 21.4.0.
Được xây dựng 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 21.4.0
- SDK quảng cáo Unity phiên bản 4.5.0.
Phiên bản 4.4.1.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.4.1.
Được xây dựng 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 21.2.0
- SDK quảng cáo Unity phiên bản 4.4.1.
Phiên bản 4.4.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.4.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 21.2.0.
Được xây dựng 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 21.2.0
- SDK quảng cáo Unity phiên bản 4.4.0.
Phiên bản 4.3.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.3.0.
- Lệnh gọi lại
onAdOpened()
hiện được chuyển tiếp khi quảng cáo xen kẽ và quảng cáo có tặng thưởng bắt đầu phát.
Được xây dựng 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 21.1.0
- SDK quảng cáo Unity phiên bản 4.3.0.
Phiên bản 4.2.1.1
- Cập nhật
compileSdkVersion
vàtargetSdkVersion
thành API 31. - Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 21.0.0.
Được xây dựng 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 21.0.0.
- SDK quảng cáo Unity phiên bản 4.2.1.
Phiên bản 4.2.1.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.2.1.
Được xây dựng 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 20.6.0.
- SDK quảng cáo Unity phiên bản 4.2.1.
Phiên bản 4.1.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.1.0.
Được xây dựng 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 20.6.0.
- SDK quảng cáo Unity phiên bản 4.1.0.
Phiên bản 4.0.1.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.0.1.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 20.6.0.
Được xây dựng 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 20.6.0.
- SDK quảng cáo Unity phiên bản 4.0.1.
Phiên bản 4.0.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 4.0.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 20.5.0.
Được xây dựng 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 20.5.0.
- SDK quảng cáo Unity phiên bản 4.0.0.
Phiên bản 3.7.5.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.7.5.
Được xây dựng 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 20.2.0.
- SDK quảng cáo Unity phiên bản 3.7.5.
Phiên bản 3.7.4.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.7.4.
Được xây dựng 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 20.2.0.
- SDK Unity Ads phiên bản 3.7.4.
Phiên bản 3.7.2.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.7.2.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 20.2.0.
Được xây dựng 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 20.2.0.
- SDK Unity Ads phiên bản 3.7.2.
Phiên bản 3.7.1.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.7.1.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 20.1.0.
Được xây dựng 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 20.1.0.
- SDK quảng cáo Unity phiên bản 3.7.1.
Phiên bản 3.6.2.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.6.2.
- Khắc phục vấn đề quảng cáo có tặng thưởng không chuyển tiếp lệnh gọi lại lượt nhấp.
- SDK UnityAds đã bị xoá khỏi bản dựng bộ chuyển đổi đi kèm. Giờ đây, nhà xuất bản phải thêm SDK UnityAds theo cách thủ công dưới dạng phần phụ thuộc bổ sung.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 19.8.0.
Được xây dựng 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 19.8.0.
- SDK Unity Ads phiên bản 3.6.2.
Phiên bản 3.6.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.6.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 19.6.0.
Được xây dựng 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 19.6.0.
- SDK quảng cáo Unity phiên bản 3.6.0.
Phiên bản 3.5.1.1
- Khắc phục vấn đề khi cố gắng yêu cầu nhiều quảng cáo xen kẽ và quảng cáo có tặng thưởng.
Được xây dựng 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 19.5.0.
- SDK quảng cáo Unity phiên bản 3.5.1.
Phiên bản 3.5.1.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.5.1.
- Đã khắc phục vấn đề khiến các yêu cầu quảng cáo biểu ngữ thông minh không thực hiện được.
Được xây dựng 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 19.5.0.
- SDK quảng cáo Unity phiên bản 3.5.1.
Phiên bản 3.5.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.5.0.
- Bổ sung tính năng hỗ trợ biểu ngữ thích ứng.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 19.5.0.
Được xây dựng 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 19.5.0.
- SDK quảng cáo Unity phiên bản 3.5.0.
Phiên bản 3.4.8.0
- Đã khắc phục lỗi
NullPointerException
xảy ra khi quảng cáo biểu ngữ bị huỷ. - Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 19.3.0.
Được xây dựng 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 19.3.0.
- SDK quảng cáo Unity phiên bản 3.4.8.
Phiên bản 3.4.6.1
- Đã tạo một bản dựng bộ chuyển đổi không bao gồm SDK quảng cáo Unity đi kèm.
Điều này cho phép nhà xuất bản sử dụng Dịch vụ quảng cáo của Unity khi dàn xếp trên
Unity để tránh các vấn đề xung đột về phần phụ thuộc.
- Nhà xuất bản có thể chọn sử dụng chỉ số này bằng cách thêm
Phần phụ thuộc
com.google.ads.mediation:unity-adapter-only:x.y.z.p
trên tệpbuild.gradle
cấp ứng dụng.
- Nhà xuất bản có thể chọn sử dụng chỉ số này bằng cách thêm
Phần phụ thuộc
Được xây dựng 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 19.1.0.
- SDK quảng cáo Unity phiên bản 3.4.6.
Phiên bản 3.4.6.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.4.6.
- Bây giờ, bộ chuyển đổi sẽ chuyển tiếp lệnh gọi lại
onAdOpened()
khi người dùng nhấp vào quảng cáo biểu ngữ.
Được xây dựng 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 19.1.0.
- SDK quảng cáo Unity phiên bản 3.4.6.
Phiên bản 3.4.2.3
- Thêm mã lỗi mô tả và lý do dẫn đến lỗi tải/hiển thị bộ chuyển đổi.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 19.1.0.
Được xây dựng 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 19.1.0.
- SDK Unity Ads phiên bản 3.4.2.
Phiên bản 3.4.2.2
- Khắc phục sự cố
ConcurrentModificationException
xảy ra khi Unity Ads trả về lỗi.
Được xây dựng 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 19.0.1.
- SDK Unity Ads phiên bản 3.4.2.
Phiên bản 3.4.2.1
- Cải thiện tính năng chuyển tiếp các lỗi của Unity để nhận diện sớm hơn các lỗi khởi động và tải quảng cáo, đồng thời giảm thời gian chờ.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 19.0.1.
Được xây dựng 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 19.0.1.
- SDK Unity Ads phiên bản 3.4.2.
Phiên bản 3.4.2.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.4.2.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 18.3.0.
Được xây dựng 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 18.3.0.
- SDK Unity Ads phiên bản 3.4.2.
Phiên bản 3.4.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.4.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 18.3.0.
Được xây dựng 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 18.3.0.
- SDK quảng cáo Unity phiên bản 3.4.0.
Phiên bản 3.3.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.3.0.
Được xây dựng 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 18.2.0.
- SDK quảng cáo Unity phiên bản 3.3.0.
Phiên bản 3.2.0.1
- Khắc phục sự cố ngoại lệ về con trỏ rỗng xảy ra khi gọi
loadAd()
trước khi gọiUnityAds.initialize()
. - Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 18.2.0.
Phiên bản 3.2.0.0
- Khắc phục vấn đề khiến yêu cầu Quảng cáo biểu ngữ không thực hiện được.
- Xác minh khả năng tương thích với SDK Unity Ads 3.2.0.
- 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 SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 18.1.1.
Phiên bản 3.1.0.0
- Đã thêm tùy chọn hỗ trợ cho kích thước quảng cáo biểu ngữ linh hoạt.
- Bộ chuyển đổi không thực hiện được yêu cầu quảng cáo nếu kích thước được yêu cầu không tương thích với mọi kích thước biểu ngữ của Unity Ads
- Xác minh khả năng tương thích với SDK Unity Ads 3.1.0.
Phiên bản 3.0.1.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.0.1.
- Khắc phục lỗi gây ra lỗi "NPE" trong khi hiển thị quảng cáo xen kẽ.
Phiên bản 3.0.0.2
- Cập nhật bộ chuyển đổi để hỗ trợ API quảng cáo có tặng thưởng mở (thử nghiệm) mới.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên phiên bản 17.2.0.
Phiên bản 3.0.0.1
- Bổ sung tính năng hỗ trợ cho Biểu ngữ quảng cáo Unity.
Phiên bản 3.0.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 3.0.0.
Phiên bản 2.3.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 2.3.0.
Phiên bản 2.2.1.1
- Cập nhật bộ chuyển đổi để gọi sự kiện quảng cáo
onRewardedVideoComplete()
.
Phiên bản 2.2.1.0
- Xác minh khả năng tương thích với SDK Unity Ads 2.2.1.
Phiên bản 2.2.0.0
- Xác minh khả năng tương thích với SDK Unity Ads 2.2.0.
Phiên bản 2.1.2.0
- Xác minh khả năng tương thích với SDK Unity Ads 2.1.2.
Phiên bản 2.1.1.0
- Xác minh khả năng tương thích với SDK Unity Ads 2.1.1.
Phiên bản 2.1.0.0
- Cập nhật bộ chuyển đổi để tương thích với SDK Unity Ads 2.1.0.
Phiên bản 2.0.8.0
- Xác minh khả năng tương thích với SDK Unity Ads 2.0.8.
Phiên bản 2.0.7.0
- Việc sử dụng tính năng báo cáo lượt nhấp của Unity Ads (số liệu thống kê về lượt nhấp của AdMob và Unity Ads sẽ khớp).
- Thêm tuỳ chọn hỗ trợ lệnh gọi lại onAdLeftApplication.
Phiên bản 2.0.6.0
- Xác minh khả năng tương thích với SDK Unity Ads 2.0.6.
Phiên bản 2.0.5.0
- Bạn hiện có thể thêm các bộ chuyển đổi dưới dạng phần phụ thuộc biên dịch bằng cách thêm đoạn mã sau đây
vào thẻ phần phụ thuộc của tệp build.gradle:
compile 'com.google.ads.mediation:unity:2.0.5.0'
- Đã chuyển sang phân phối bộ chuyển đổi dưới dạng aar thay vì tệp jar (xem phần README để biết thêm hướng dẫn).
Phiên bản 2.0.4.0
- Đã khắc phục lỗi khiến quảng cáo video có tặng thưởng không tải được khi quảng cáo xen kẽ đã được tải đầu tiên.
Phiên bản 2.0.2.0
- Đã thay đổi hệ thống đặt tên phiên bản thành [Phiên bản SDK quảng cáo Unity].[Phiên bản bản vá của bộ chuyển đổi].
- Cập nhật SDK quảng cáo Unity tối thiểu bắt buộc lên phiên bản 2.0.2.
- Cập nhật SDK Quảng cáo của Google trên thiết bị di động bắt buộc tối thiểu lên phiên bản 9.0.0.
- Các ứng dụng không còn bắt buộc phải gọi UnityAds.changeActivity(this) nữa.
Phiên bản 1.0.0
- Bản phát hành đầu tiên. Hỗ trợ quảng cáo dạng video dựa trên phần thưởng và quảng cáo xen kẽ.