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

Chọn nền tảng: Android (beta) Mới chọn Android iOS Unity Flutter

Hướng dẫn này trình bày cách sử dụng GMA Next-Gen SDK để tải và hiển thị quảng cáo từ Unity Ads bằng tính năng dàn xếp, bao gồm cả các hoạt động tích hợp theo kiểu đặt giá thầu và thác nước. Tài liệu này trình bày cách thêm Unity Ads 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 của Unity Ads vào một ứng dụng Android.

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

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

Tích hợp
Đặt giá thầu
Thác nước  1
Đị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 độ 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 Unity phiên bản 4.16.0.1 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 Unity Ads

Đăng ký hoặc đăng nhập vào Unity Ads.

Tạo dự án

Trên trang tổng quan Unity Ads, hãy chuyển đến mục Projects rồi nhấp vào New.

Điền thông tin vào biểu mẫu rồi nhấp vào Create (Tạo) để thêm dự án.

Chuyển đến mục Unity Ads Monetization (Kiếm tiền từ Unity Ads), rồi nhấp vào Get started (Bắt đầu).

Trong cửa sổ New Project (Dự án mới), hãy chọn I will use Mediation (Tôi sẽ sử dụng tính năng dàn xếp) và Google Admob cho Mediation Partner (Đối tác dàn xếp), rồi nhấp vào Next (Tiếp theo).

Chọn tuỳ chọn cho chế độ cài đặt quảng cáo, rồi nhấp vào Next (Tiếp theo).

Chọn chế độ thiết lập vị trí, rồi nhấp vào Next (Tiếp theo).

Đặt giá thầu

Thác nước

Điền thông tin vào biểu mẫu rồi nhấp vào Add project (Thêm dự án).

Ghi lại Game ID (Mã trò chơi).

Tạo đơn vị quảng cáo và vị trí

Chuyển đến mục Unity Ads Monetization (Kiếm tiền từ Unity Ads) > Placements (Vị trí), rồi chọn dự án và nhấp vào Add ad unit (Thêm đơn vị quảng cáo).

Nhập Ad unit name (Tên đơn vị quảng cáo), rồi chọn Platform (Nền tảng) và Ad format (Định dạng quảng cáo).

Chuyển đến mục Monetization (Kiếm tiền) > Placements (Vị trí), rồi nhấp vào Add Ad Unit (Thêm đơn vị quảng cáo).

Nhập Ad Unit Name (Tên đơn vị quảng cáo), rồi chọn Platform (Nền tảng) và Ad Format (Định dạng quảng cáo).

Chọn Waterfall (Thác nước) cho phần Setup (Thiết lập). Trong phần Placement (Vị trí), hãy nhập Placement name (Tên vị trí), GEO Tagging (Gắn thẻ vị trí địa lý) và Target (Mục tiêu).

Ghi lại Placement ID (Mã vị trí).

Cuối cùng, hãy nhấp vào Add ad unit (Thêm đơn vị quảng cáo) để lưu đơn vị quảng cáo và vị trí.

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

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

Chuyển đến mục Unity Ads Monetization (Kiếm tiền từ Unity Ads) > API management (Quản lý API) rồi ghi lại API Key (Khoá API) trong phần Monetization Stats API Access (Quyền truy cập API thống kê kiếm tiền).

Sau đó, hãy chuyển đến mục Unity Ads Monetization (Kiếm tiền từ Unity Ads) > Organization Settings (Cài đặt tổ chức) rồi ghi lại Organization core ID (Mã nhận dạng chính của tổ chức).

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 tạo tệp app-ads.txt cho Ad Manager.

Để triển khai app-ads.txt cho Unity Ads, hãy xem bài viết thiết lập tệp app-ads.txt lần đầu tiên.

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

Bạn có thể bật chế độ thử nghiệm trên trang tổng quan Unity Ads. Chuyển đến mục Unity Ads Monetization (Kiếm tiền từ Unity Ads) > Testing (Thử nghiệm).

Bạn có thể buộc ứng dụng chuyển sang chế độ thử nghiệm bằng cách nhấp vào nút chỉnh sửa bên cạnh Cửa hàng Google Play , bật Ghi đè chế độ thử nghiệm của ứng dụng và chọn Buộc bật chế độ thử nghiệm (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 Add Test Device (Thêm thiết bị thử nghiệm).

Nhập thông tin chi tiết về thiết bị thử nghiệm, rồi nhấp vào Save (Lưu).

Bước 2: Thiết lập nhu cầu về Unity Ads trong giao diện người dùng Ad Manager

Đăng nhập vào tài khoản Ad Manager.

Thêm Unity Ads trong phần Công ty

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

Chuyển đến mục Admin (Quản trị) > Companies (Công ty), rồi nhấp vào nút New company (Công ty mới) trong thẻ All companies (Tất cả công ty). Chọn Ad network (Mạng quảng cáo).

Chọn Unity Ads làm Ad network (Mạng quảng cáo), nhập Name (Tên) duy nhất và bật Mediation (Dàn xếp). Bật Automatic data collection (Thu thập dữ liệu tự động) và nhập API Key (Khoá API) và Organization core ID (Mã nhận dạng chính của tổ chức) đã nhận được trong phần trước.

Bạn không cần nhập Username (Tên người dùng) hoặc Password (Mật khẩu). Nhấp vào Save (Lưu) khi hoàn tất.

Bật tính năng chia sẻ tín hiệu an toàn

Đặt giá thầu

Chuyển đến mục Admin (Quản trị) > Global settings (Cài đặt chung). Chuyển đến thẻ Ad Exchange account settings (Cài đặt tài khoản Ad Exchange) rồi xem xét và bật Secure signal sharing (Chia sẻ tín hiệu an toàn). Nhấp vào Save (Lưu).

Thác nước

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 theo kiểu thác nước.

Chia sẻ tín hiệu an toàn trong yêu cầu giá thầu

Đặt giá thầu

Chuyển đến mục Inventory (Khoảng không quảng cáo) > Secure Signals (Tín hiệu an toàn). Trong phần Secure signals (Tín hiệu an toàn), hãy tìm Unity Ads rồi bật Enable app integration (Bật tính năng tích hợp ứng dụng).

Nhấp vào Save (Lưu).

Thác nước

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 theo kiểu thác nước.

Cho phép chia sẻ tín hiệu an toàn cho tính năng Đặt giá thầu qua SDK

Đặt giá thầu

Chuyển đến mục Delivery (Phân phối) > Demand channel settings (Cài đặt kênh nhu cầu). Trong thẻ Default settings (Cài đặt mặc định), hãy bật Allow secure signal sharing (Cho phép chia sẻ tín hiệu an toàn) cho SDK Bidding (Đặt giá thầu qua SDK).

Nhấp vào Save (Lưu).

Thác nước

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 theo kiểu thác nước.

Định cấu hình tính năng đặt giá thầu của Unity Ads

Đặt giá thầu

Chuyển đến mục Delivery (Phân phối) > Bidders (Bên đặt giá thầu), rồi nhấp vào Go to SDK Bidding (Chuyển đến tính năng Đặt giá thầu qua SDK).

Nhấp vào New bidder (Bên đặt giá thầu mới).

Chọn Unity Ads làm bên đặt giá thầu.

Nhấp vào Continue (Tiếp tục) để cho phép bên đặt giá thầu này đặt giá thầu qua SDK.

Nhấp vào Xong.

Thác nước

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 theo kiểu thác nước.

Định cấu hình mối liên kết với đơn vị quảng cáo

Đặt giá thầu

Chuyển đến mục Delivery (Phân phối) > Bidders (Bên đặt giá thầu), rồi nhấp vào Go to SDK Bidding (Chuyển đến tính năng Đặt giá thầu qua SDK).

Chọn công ty cho Unity Ads.

Chuyển đến thẻ Ad unit mapping (Liên kết đơn vị quảng cáo) rồi nhấp vào New ad unit mapping (Liên kết đơn vị quảng cáo mới).

Chọn Specific ad unit (Đơn vị quảng cáo cụ thể). Chọn một đơn vị quảng cáo và định dạng, Mobile app (Ứng dụng dành cho thiết bị di động) làm Inventory type (Loại khoảng không quảng cáo) và Mobile application (Ứng dụng dành cho thiết bị di động). Sau đó, hãy nhập Game ID (Mã trò chơi) và Placement ID (Mã vị trí) đã nhận được trong phần trước.

Cuối cùng, hãy nhấp vào Save (Lưu).

Thác nước

Chuyển đến mục Delivery (Phân phối) > Yield groups (Nhóm lợi nhuận) rồi nhấp vào nút New yield group (Nhóm lợi nhuận mới). Chọn Mobile application (Ứng dụng dành cho thiết bị di động).

Di chuyển xuống rồi nhấp vào Add yield partner (Thêm đối tác lợi nhuận).

Chọn công ty mà bạn đã tạo cho Unity Ads trong phần trước. Chọn Mobile SDK mediation (Dàn xếp SDK trên thiết bị di động) làm Integration type (Loại tích hợp), Android (Android) làm Platform (Nền tảng) và Active (Đang hoạt động) làm Status (Trạng thái).

Nhập Game ID (Mã trò chơi) và Placement ID (Mã vị trí) đã nhận được trong phần trước, cũng như giá trị Default CPM (CPM mặc định). Nhấp vào Save (Lưu).

Lưu ý: Tính năng thu thập dữ liệu tự động cần một vài ngày để thu thập dữ liệu trước khi có thể tính toán chính xác giá trị CPM linh động cho mạng dàn xếp. Sau khi có thể tính eCPM (chi phí hiệu quả trên mỗi nghìn lượt hiển thị), giá trị này sẽ tự động được cập nhật thay cho bạn.

Thêm Unity Ads 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 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 Unity Ads 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 Ad Manager.

Bước 3: Nhập SDK và bộ chuyển đổi của Unity Ads

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.unity3d.ads:unity-ads:4.16.5")
    implementation("com.google.ads.mediation:unity:4.17.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.unity3d.ads:unity-ads:4.16.5'
    implementation 'com.google.ads.mediation:unity:4.17.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Tích hợp thủ công

  1. Tải SDK Unity Ads mới nhất (unity-ads.aar) xuống từ kho lưu trữ GitHub của họ rồi thêm vào dự án.

  2. Chuyển đến các 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 tệp .aar của bộ chuyển đổi Unity Ads xuống rồi thêm vào dự án.

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

Để 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 họ đồng ý cho sử dụng cookie hoặc bộ nhớ cục bộ khác khi pháp luật yêu cầu, cũng như đối với việc thu thập, chia sẻ và sử dụng dữ liệu cá nhân để 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. Google không thể tự động truyền lựa chọn về sự đồng ý của người dùng đến các mạng như vậy.

Trong SDK phiên bản 2.0.0, Unity Ads đã thêm một API để hỗ trợ chế độ cài đặt quyền riêng tư. Mã mẫu sau đây cho thấy cách truyền thông tin về sự đồng ý này đến SDK của Unity Ads. Nếu bạn chọn truyền thông tin về sự đồng ý đến SDK của Unity Ads theo cách thủ công, thì bạn nên gọi mã này trước khi yêu cầu quảng cáo thông qua GMA Next-Gen SDK.

Java

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
UnityAdsMediationSnippets.java

Kotlin

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
UnityAdsMediationSnippets.kt

Hãy xem bài viết Unity Ads' Tuân thủ GDPR để 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 thức.

Luật về quyền riêng tư của các bang tại Hoa Kỳ

Luật về quyền riêng tư của các bang tại Hoa Kỳ yêu cầu bạn phải cung cấp cho người dùng quyền từ chối việc "bán" "thông tin cá nhân" của họ (theo định nghĩa của các thuật ngữ này trong luật), trong đó quyền từ chối đượ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.

Trong SDK phiên bản 2.0.0, Unity Ads đã thêm một API để hỗ trợ chế độ cài đặt quyền riêng tư. Mã mẫu sau đây cho thấy cách truyền thông tin về sự đồng ý này đến SDK của Unity Ads. Nếu bạn chọn truyền thông tin về sự đồng ý đến SDK của Unity Ads theo cách thủ công, thì bạn nên gọi mã này trước khi yêu cầu quảng cáo thông qua GMA Next-Gen SDK.

Java

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
UnityAdsMediationSnippets.java

Kotlin

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
UnityAdsMediationSnippets.kt

Hãy xem bài viết Unity Ads' Tuân thủ Đạo luật về quyền riêng tư của người tiêu dùng để 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 thức.

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

Tải quảng cáo bằng ngữ cảnh Hoạt động

Truyền ngữ cảnh Activity khi tải các định dạng quảng cáo Biểu ngữ, Quảng cáo xen kẽ và Quảng cáo gốc. Nếu không có ngữ cảnh hoạt động, thì lượt tải quảng cáo sẽ không thành công.

Bước 6: Kiểm thử việc 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 giao diện người dùng Unity Ads.

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ừ 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 Unity Ads (Đặt giá thầu) và Unity Ads (Thác nước)(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 lượt phản hồi quảng cáo bằng ResponseInfo.getAdSourceResponses() trong các lớp sau:

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

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

Mã lỗi Lý do
0-10 SDK UnityAds trả về lỗi. Xem mã để biết thêm thông tin chi tiết.
101 Các tham số máy chủ UnityAds được định cấu hình trong giao diện người dùng Ad Manager 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 DISABLED.
104 UnityAds đã cố gắng hiển thị một quảng cáo có ngữ cảnh rỗng.
105 Ngữ cảnh dùng để khởi động, tải và/hoặc hiển thị quảng cáo từ Unity Ads không phải là một thực thể 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 Thiết bị không hỗ trợ UnityAds.
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 đã hoàn tất với trạng thái ERROR.
200-204 Lỗi cụ thể của biểu ngữ UnityAds. Xem mã để biết thêm thông tin chi tiết.