Bắt đầu

Trình bổ trợ Unity dành cho quảng cáo trên thiết bị di động của Google cho phép nhà phát triển Unity phân phát quảng cáo trên thiết bị di động của Google trên các ứng dụng Android và iOS mà không cần phải viết mã Java hoặc Objective-C. Trình bổ trợ này cung cấp giao diện C# để yêu cầu các quảng cáo mà tập lệnh C# sử dụng trong dự án Unity của bạn.

Hướng dẫn này dành cho những nhà xuất bản muốn kiếm tiền từ ứng dụng Unity.

Điều kiện tiên quyết

• Sử dụng Unity 2019.4 trở lên
• Để triển khai cho iOS
  • Xcode 15.3 trở lên
  • Nhắm đến iOS 12.0 trở lên
  • CocoaPods
• Cách triển khai cho Android
  • Cấp độ API Android tối thiểu là 21 trở lên
  • Nhắm đến API Android cấp 31 trở lên

Cấp độ API của Android được đặt trong phần Cài đặt dự án > Trình phát > Android > Cài đặt khác > Chế độ cài đặt khác.

Nhập trình bổ trợ Quảng cáo trên thiết bị di động cho Unity

OpenUPM-CLI

Nếu bạn có OpenUPM CLI , bạn có thể cài đặt sổ đăng ký OpenUPM bằng :

openupm add com.google.ads.mobile

Xoá thành phần trình bổ trợ .unitypackage

Nếu bạn chuyển từ sử dụng .unitypackage sang sử dụng OpenUPM, bạn phải gỡ cài đặt tài sản khỏi vị trí cũ theo cách thủ công. Xoá các thư mục sau đã được nhập từ .unitypackage:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. Mở phần cài đặt trình quản lý gói bằng cách chọn tuỳ chọn trình đơn Unity Chỉnh sửa > Cài đặt dự án > Package Manager (Trình quản lý gói).

2. Thêm OpenUPM làm sổ đăng ký có giới hạn vào cửa sổ Trình quản lý gói:

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. Mở trình đơn trình quản lý gói bằng cách chọn tuỳ chọn trình đơn Unity Window > Package Manager (Cửa sổ > Trình quản lý gói).

4. Đặt trình đơn thả xuống phạm vi người quản lý để chọn Sổ đăng ký của tôi.

   

5. Chọn gói Google Mobile Ads cho Unity trong danh sách gói rồi nhấn Install (Cài đặt).

Xoá .unitypackage thành phần trình bổ trợ

Nếu bạn chuyển từ sử dụng .unitypackage sang sử dụng OpenUPM, bạn phải gỡ cài đặt tài sản khỏi vị trí cũ theo cách thủ công. Xoá các thư mục sau đã được nhập từ .unitypackage:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

Nhập từ GitHub

1. Tải bản phát hành .unitypackage mới nhất xuống từ GitHub.
2. Nhập tệp .unitypackage bằng cách chọn lựa chọn trình đơn Unity Thành phần > Nhập gói > Custom Package (Gói tuỳ chỉnh) và nhập tất cả các mục.

Bao gồm các phần phụ thuộc bên ngoài

Trình bổ trợ Unity dành cho quảng cáo trên thiết bị di động của Google được phân phối cùng với thư viện Trình phân giải dịch vụ Play dành cho Unity. Thư viện này dành cho trình bổ trợ Unity bất kỳ yêu cầu quyền truy cập vào các thư viện dành riêng cho Android, chẳng hạn như AAR hoặc iOS CocoaPods. Thư viện này cho phép các trình bổ trợ Unity khai báo các phần phụ thuộc. Sau đó, hệ thống sẽ tự động phân giải các phần phụ thuộc này rồi sao chép vào dự án Unity của bạn.

Lưu ý quan trọng: Hãy sử dụng SDK quảng cáo trên thiết bị di động mới nhất của Google để có quyền sử dụng tất cả các tính năng tuân thủ quyền riêng tư.

Hãy làm theo các bước sau để đảm bảo dự án của bạn có tất cả các phần phụ thuộc:

Android

Chuyển đến Project Settings > Player > Android > Publishing Settings > Build (Cài đặt dự án > Trình phát > Android > Cài đặt phát hành > Bản dựng) rồi chọn:

• Mẫu Gradle chính tuỳ chỉnh
• Mẫu thuộc tính Gradle tuỳ chỉnh

Trong trình chỉnh sửa Unity, hãy chọn Tài sản > Trình quản lý phần phụ thuộc bên ngoài > Trình phân giải Android > Phân giải để thư viện Trình quản lý phần phụ thuộc bên ngoài của Unity sao chép các phần phụ thuộc đã khai báo vào thư mục Assets/Plugins/Android của ứng dụng Unity.

iOS

Unity dành cho iOS sử dụng CocoaPods để xác định và quản lý các phần phụ thuộc. Hãy tham khảo tài liệu về CocoaPods để biết các yêu cầu cụ thể hoặc các bước khắc phục sự cố liên quan đến các phần phụ thuộc iOS.

Bạn có thể tìm thấy danh sách các phần phụ thuộc của trình bổ trợ Unity quảng cáo trên thiết bị di động của Google trong Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

Đặt mã ứng dụng Ad Manager của bạn

Trong trình chỉnh sửa Unity, hãy chọn Tài sản > Quảng cáo trên thiết bị di động của Google > Cài đặt từ trình đơn.

Nhập Mã ứng dụng Ad Manager trên Android và iOS vào từng trường.

Khởi chạy SDK

Trước khi tải quảng cáo, hãy để ứng dụng của bạn khởi chạy SDK Quảng cáo của Google trên thiết bị di động bằng cách gọi MobileAds.Initialize(). Bạn chỉ cần thực hiện việc này một lần, tốt nhất là khi khởi chạy ứng dụng.

Cảnh báo: SDK quảng cáo của Google trên thiết bị di động hoặc SDK của đối tác dàn xếp có thể tải trước quảng cáo khi gọi MobileAds.Initialize(). Nếu bạn cần có được sự đồng ý của người dùng ở Khu vực kinh tế Châu Âu (EEA), hãy đặt mọi cờ dành riêng cho yêu cầu, chẳng hạn như dưới dạng tagForChildDirectedTreatment hoặc tag_for_under_age_of_consent, hoặc hãy thực hiện hành động trước khi tải quảng cáo. Hãy nhớ thực hiện việc này trước khởi chạy SDK Quảng cáo của Google trên thiết bị di động.

Dưới đây là ví dụ về cách gọi Initialize() trong phương thức Start() của tập lệnh được đính kèm vào GameObject:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

Nếu bạn đang sử dụng tính năng dàn xếp, hãy đợi cho đến khi lệnh gọi lại xảy ra trước khi tải quảng cáo đảm bảo rằng tất cả các bộ chuyển đổi dàn xếp đã được khởi chạy.

Chọn định dạng quảng cáo

SDK Quảng cáo của Google trên thiết bị di động hiện được đưa vào ứng dụng Unity khi triển khai cho nền tảng Android hoặc iOS. Giờ thì bạn đã sẵn sàng để triển khai quảng cáo. AdMob cung cấp nhiều định dạng quảng cáo để bạn có thể chọn một định dạng phù hợp nhất với trải nghiệm người dùng.

Biểu ngữ

Đơn vị quảng cáo biểu ngữ hiển thị quảng cáo hình chữ nhật chiếm một phần của bạn. Những đơn vị quảng cáo này có thể tự động làm mới sau một khoảng thời gian nhất định. Điều này có nghĩa là người dùng sẽ thấy một quảng cáo mới theo định kỳ, ngay cả khi họ vẫn đang xem cùng một màn hình trong ứng dụng của bạn. Đây cũng là định dạng quảng cáo dễ triển khai nhất.

Triển khai quảng cáo biểu ngữ

Quảng cáo xen kẽ

Đơn vị quảng cáo xen kẽ hiển thị quảng cáo toàn trang trong ứng dụng của bạn. Hãy đặt các quảng cáo này tại các điểm ngắt và điểm chuyển tiếp tự nhiên trong giao diện ứng dụng của bạn, chẳng hạn như sau khi người dùng hoàn thành một cấp độ trong một ứng dụng trò chơi.

Triển khai quảng cáo xen kẽ

Mã gốc

Quảng cáo gốc là quảng cáo mà bạn có thể tuỳ chỉnh cách thức các thành phần như dòng tiêu đề và lời kêu gọi hành động hiển thị trong ứng dụng của bạn. Bằng cách tự tạo kiểu cho quảng cáo, bạn có thể tạo bố cục quảng cáo tự nhiên, không phô trương và có thể làm phong phú trải nghiệm người dùng.

Triển khai quảng cáo gốc

Được thưởng

Đơn vị quảng cáo có tặng thưởng cho phép người dùng chơi trò chơi, làm bài khảo sát hoặc xem video để nhận phần thưởng trong ứng dụng, chẳng hạn như tiền xu, thêm mạng hoặc điểm. Bạn có thể đặt các phần thưởng khác nhau cho các đơn vị quảng cáo khác nhau, đồng thời chỉ định giá trị phần thưởng và các mục mà người dùng đã nhận được.

Triển khai quảng cáo có tặng thưởng