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 Target-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 các 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
• Cách 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

• Đề xuất: Tạo tài khoản AdMob và đăng ký ứng dụng Android hoặc iOS

Cấp độ API của Android được thiết lập trong phần Project Settings > Player > Android > Other Settings > Other Settings (Cài đặt dự án > Trình phát > Android > Cài đặt khác > 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 đã 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á .unitypackage thành phần trình bổ trợ

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

• Tài sản/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ở 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 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 dưới dạng 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 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á .unitypackage thành phần trình bổ trợ

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

• Tài sản/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 (Thành phần > Nhập gói > Gói tuỳ chỉnh) rồi nhập tất 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 các dịch vụ của Google 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 cung cấp cho các trình bổ trợ Unity khả năng khai báo các phần phụ thuộc. Sau đó, các phần phụ thuộc này sẽ được tự động phân giải và sao chép vào dự án Unity.

Lưu ý quan trọng: Hãy dùng SDK Quảng cáo của Google trên thiết bị di động phiên bản mới nhất để có thể 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 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 Assets > External Dependency Manager > Android Resolver > Resolve (Thành phầ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

Bạn không cần thực hiện thêm bước nào để đưa SDK Quảng cáo của Google trên thiết bị di động vào dự án Unity.

Các phần phụ thuộc iOS được xác định bằng CocoaPods. CocoaPods được chạy ở dạng bước trong quy trình sau xây dựng.

• Khi bạn sử dụng Unity 5.6 trở lên, hệ thống sẽ tạo một xcworkspace có chứa các thư viện phần phụ thuộc bắt buộc. Hãy sử dụng xcworkspace đã tạo thay vì dự án Xcode chuẩn.
• Khi sử dụng các phiên bản Unity cũ, các phần phụ thuộc được đưa vào dự án Xcode tiêu chuẩn.

Các phần phụ thuộc của trình bổ trợ Unity dành cho quảng cáo trên thiết bị di động của Google được liệt kê trong Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

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

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

Nhập Mã ứng dụng AdMob cho 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 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 bắt đầu 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ư tagForChildDirectedTreatment hoặc tag_for_under_age_of_consent, hoặc thực hiện thao tác trước khi tải quảng cáo. Hãy nhớ thực hiện việc này trước khi 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ớ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. Giờ thì 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 một định dạng giúp mang lại trải nghiệm tốt nhất cho 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 bố cục của ứng dụng. Những 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ẽ 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 quảng cáo vào các điểm ngắt và chuyển tiếp tự nhiên trong giao diện của ứng dụng, chẳng hạn như sau khi hoàn thành cấp độ trong ứ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 hiển thị các thành phần (như dòng tiêu đề và lời kêu gọi hành động) trong ứng dụng của mình. Bằng cách tự tạo kiểu cho quảng cáo, bạn có thể tạo ra một bản trình bày quảng cáo tự nhiên, không phô trương, mang lại trải nghiệm phong phú cho 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, thực hiện bản 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à vật phẩm mà người dùng nhận được.

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

Quảng cáo xen kẽ có tặng thưởng

Quảng cáo xen kẽ có tặng thưởng là một loại định dạng quảng cáo có trả thưởng mới, cho phép bạn tặng phần thưởng (chẳng hạn như tiền xu hoặc thêm mạng) cho những quảng cáo tự động xuất hiện tại các điểm chuyển tiếp tự nhiên của ứng dụng.

Không giống như quảng cáo có tặng thưởng, người dùng không bắt buộc phải chọn xem quảng cáo xen kẽ có tặng thưởng.

Thay vì lời nhắc chọn xem trong quảng cáo có tặng thưởng, quảng cáo xen kẽ có tặng thưởng cần có màn hình giới thiệu để thông báo về phần thưởng và cho phép người dùng chọn không xem nếu họ muốn làm như vậy.

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

Quảng cáo khi mở ứng dụng

Quảng cáo khi mở ứng dụng là định dạng quảng cáo xuất hiện khi người dùng mở hoặc quay lại ứng dụng của bạn. Quảng cáo sẽ phủ lên màn hình tải.

Triển khai quảng cáo khi mở ứng dụng