Bắt đầu

Trình bổ trợ Unity 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 Object-C. Trình bổ trợ cung cấp giao diện C# để yêu cầu 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 mục tiêu phiên bả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 34 trở lên

Cấp độ API Android được đặt trong phần Project Settings (Cài đặt dự án) > Player (Trình phát) > Android > Other Settings (Cài đặt khác) > Other Settings (Cài đặt khác).

Nhập trình bổ trợ Mobile Ads cho Unity

OpenUPM-CLI

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

openupm add com.google.ads.mobile

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

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

  • Assets/ExternalDependencyManager
  • Thành phần/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ở chế độ cài đặt trình quản lý gói bằng cách chọn tuỳ chọn trình đơn Unity Edit > Project Settings > Package Manager (Chỉnh sửa > Cài đặt dự án > 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 Tổ chức đăng ký của tôi.

  5. Chọn gói Quảng cáo trên thiết bị di động của Google dành cho Unity từ danh sách gói rồi nhấn vào Cài đặt.

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

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

  • Assets/ExternalDependencyManager
  • Thành phần/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 tuỳ chọn trình đơn Unity Assets > Import package > Custom Package (Tài sản > Nhập gói > Gói tuỳ chỉnh) rồi 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 mọi trình bổ trợ Unity 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 sử dụng. 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.

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 xuất bản > 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 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

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.

Dưới đây là ví dụ về cách gọi Initialize() bên trong phương thức Start() của tập lệnh được đính kèm với một 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 đều đượ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. Bây giờ, bạn đã sẵn sàng triển khai quảng cáo. AdMob cung cấp một số định dạng quảng cáo để bạn có thể chọn định dạng giúp mang lại trải nghiệm tốt nhất cho người dùng.

Đơn vị quảng cáo biểu ngữ hiển thị những quảng cáo hình chữ nhật chiếm một phần bố cục của ứng dụng. Quảng cáo 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ẽ xem một quảng cáo mới định kỳ, ngay cả khi họ ở trên 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 đơn giản nhất để triển khai.

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 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. 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, cũng như chỉ định giá trị phần thưởng và vật phẩm mà người dùng nhận được.

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