Trang này được dịch bởi Cloud Translation API.

Tích hợp quảng cáo Unity với tính năng Dàn xếp

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 quy 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).

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

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ậpAd Manager 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 chế độ thử nghiệm cho ứng dụng của mình bằng cách nhấp vào nút chỉnh sửa bên cạnh Cửa hàng Google Play , đánh dấu vào 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ả cá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 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 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 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.2.0")
    implementation("com.unity3d.ads:unity-ads:4.12.1")
    implementation("com.google.ads.mediation:unity:4.12.1.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 Unity Ads SDK

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

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