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 tính nă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 một Flutter ứng dụng.
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 AdMob cho Unity Ads có các khả năng sau:
| Tích hợp | ||
|---|---|---|
| Đặt giá thầu | 1 | |
| Thác nước | ||
| Định dạng | ||
| Biểu ngữ | ||
| Quảng cáo xen kẽ | ||
| Được thưởng | ||
Yêu cầu
- SDK Quảng cáo của Google trên thiết bị di động mới nhất
- Flutter 3.7.0 trở lên
- Cách triển khai trên Android
- Android API cấp 21 trở lên
- Cách triển khai trên iOS
- Mục tiêu triển khai iOS phiên bản 12.0 trở lên
- Một dự án Flutter đang hoạt động được định cấu hình với Google SDK quảng cáo trên thiết bị di động. Xem Bắt đầu để biết thông tin chi tiế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 tính năng Dàn xếp và Google AdMob cho Đối tác dàn xếp, rồi 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 tới 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).
Android
iOS
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í
Đặt giá thầu
Hãy liên hệ với người quản lý tài khoản Unity Ads của bạn để tạo các vị trí đặt giá thầu.
Thác nước
Sau khi tạo dự án, hãy chuyển đến mục Kiếm tiền > Vị trí. Để 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í.
Android
iOS
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ã nhận dạng trò chơi và Mã vị trí, bạn cũng cần có Khoá API và Mã nhận dạng chính của tổ chức Unity Ads để thiết lậpAdMob Mã đơn vị quảng cáo.
Chuyển đến phần Kiếm tiền > Thiết lập > Quản lý API rồi ghi lại Khoá truy cập API Thống kê kiếm tiền.
Sau đó, chuyển đến phần Kiếm tiền > Cài đặt tổ chức và ghi lại 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 trên trang tổng quan Unity Ads. Trong phần cài đặt của dự án, hãy chọn thẻ Testing (Kiểm thử).
Bạn có thể buộc áp dụng chế độ thử nghiệm cho ứng dụng bằng cách nhấp vào nút chỉnh sửa của từng nền tảng, kiểm tra Ghi đè chế độ thử nghiệm ứng dụng khách 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ả các thiết bị.
Android
iOS
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 Add Test Device (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 AdMob 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
Android
Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho Android.
iOS
Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho iOS.
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 AdMob giao diện người dùng.
Bước 3: Nhập SDK Unity Ads và bộ chuyển đổi
Tích hợp thông qua pub.dev
Thêm phần phụ thuộc sau đây với các phiên bản mới nhất của
Unity Ads SDK và bộ chuyển đổi trong
Tệp pubspec.yaml:
dependencies:
gma_mediation_unity: ^1.0.0
Tích hợp thủ công
Tải phiên bản mới nhất của trình bổ trợ dàn xếp Quảng cáo trên thiết bị di động của Google cho
Unity Ads!
giải nén tệp đã tải xuống và thêm thư mục trình bổ trợ đã giải nén
(và nội dung trong đó) vào dự án Flutter của bạn. Sau đó, tham chiếu trình bổ trợ trong
pubspec.yaml bằng cách thêm phần phụ thuộc sau:
dependencies:
gma_mediation_unity:
path: path/to/local/package
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 đó.
Trình bổ trợ dàn xếp Quảng cáo trên thiết bị di động của Google cho Unity Ads
bao gồm
GmaMediationUnity.setGDPRConsent()
. Mã mẫu sau đây cho biết cách chuyển thông tin về sự đồng ý đến
SDK quảng cáo Unity. 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 SDK Quảng cáo của Google trên thiết bị di động.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setGDPRConsent(true);
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 cụm từ đó), kèm theo 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ủ.
Trình bổ trợ dàn xếp Quảng cáo trên thiết bị di động của Google cho Unity Ads
bao gồm
GmaMediationUnity.setCCPAConsent()
. Mã mẫu sau đây cho biết cách chuyển thông tin về sự đồng ý đến
SDK quảng cáo Unity. 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 SDK Quảng cáo của Google trên thiết bị di động.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setCCPAConsent(true);
Bước 5: Thêm mã bắt buộc
Android
Bạn không cần thêm đoạn mã để tích hợp với Unity Ads trên Android.
iOS
Tích hợp SKAdNetwork
Theo dõi Unity Ads' tài liệu
để 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
Hãy nhớ đăng ký thiết bị thử nghiệm cho AdMob 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 từ phản hồi quảng cáo bằng cách sử dụng
ResponseInfo trong
các lớp sau:
Android
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
iOS
GADMAdapterUnity
GADMediationAdapterUnity
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:
Android
| 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 thông số máy chủ UnityAds được định cấu hình trong giao diện người dùng AdMob 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 | Biểu ngữ UnityAds một lỗi cụ thể. Xem mã để biết thêm chi tiết. |
iOS
| 0-9 | SDK UnityAds trả về một lỗi. Xem tài liệu của Unity để biết thêm chi tiết. |
| 101 | Các thông số máy chủ UnityAds được định cấu hình trong giao diện người dùng AdMob bị thiếu/không hợp lệ. |
| 102 | Thiết bị không được UnityAds hỗ trợ. |
| 103 | UnityAds đã hoàn tất việc trình bày với trạng thái lỗi kUnityAdsFinishStateError. |
| 104 | Đối tượng quảng cáo Unity là giá trị rỗng sau khi gọi trình khởi chạy. |
| 105 | Không hiển thị được Quảng cáo Unity do quảng cáo chưa sẵn sàng. |
| 106 | UnityAds đã gọi lệnh gọi lại đã thay đổi vị trí với trạng thái vị trí là kUnityAdsLocationsStateNoFill. |
| 107 | UnityAds đã gọi lệnh gọi lại đã thay đổi vị trí với trạng thái vị trí là kUnityAdsPlacementStateDisabled. |
| 108 | Một quảng cáo đã được tải cho vị trí này. SDK UnityAds không hỗ trợ việc tải nhiều quảng cáo cho cùng một vị trí. |
Nhật ký thay đổi về bộ chuyển đổi dàn xếp Flutter đối với quảng cáo Unity
Phiên bản 1.0.0
- Bản phát hành đầu tiên.
- Đã xác minh khả năng tương thích với bộ chuyển đổi Android Unity phiên bản 4.10.0.0
- Đã xác minh khả năng tương thích với bộ điều hợp iOS Unity phiên bản 4.10.0.0