Thiết lập trình bổ trợ Google 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á .unitypackage thành phần trình bổ trợ

Nếu đang chuyển từ .unitypackage sang OpenUPM, bạn phải gỡ cài đặt các thành phầ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
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM có giao diện người dùng

1. Mở package manager settings (cài đặt trình quản lý gói) bằng cách chọn mục Edit > Project Settings > Package Manager (Chỉnh sửa > Cài đặt dự án > Trình quản lý gói) trong trình đơn Unity.

2. Thêm OpenUPM làm sổ đăng ký trong phạm vi 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 mục Window > Package Manager (Cửa sổ > Trình quản lý gói) trong trình đơn Unity.

4. Đặt trình đơn thả xuống phạm vi của trình quản lý để chọn My Registries (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 vào Install (Cài đặt).

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

Nếu đang chuyển từ .unitypackage sang OpenUPM, bạn phải gỡ cài đặt các thành phầ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
• 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. Tìm nạp thẻ phiên bản của bản phát hành gần đây nhất. Thẻ được trả về, không bao gồm tiền tố v, là phiên bản Google Mobile Ads Unity Plugin.

   • macOS và Linux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. Sửa đổi tệp Packages/manifest.json để thêm sổ đăng ký và phần phụ thuộc trong phạm vi OpenUPM bằng cách sử dụng phiên bản lấy từ lệnh trước đó:

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.6.0"
     }
   }
   

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

Nếu đang chuyển từ .unitypackage sang OpenUPM, bạn phải gỡ cài đặt các thành phầ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
• 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 xuống từ GitHub.
2. Nhập tệp .unitypackage bằng cách chọn mục trong trình đơn Unity Assets > Import package > Custom Package (Nội dung > Nhập gói > Tuỳ chỉnh gói) và nhập tất cả các mục.

Không bắt buộc: Tắt Trình quản lý phần phụ thuộc bên ngoài

Nếu quản lý thư viện Android và iOS bằng công cụ xây dựng của riêng mình, bạn có thể tắt gói com.unity.external-dependency-manager:

Trong Trình chỉnh sửa Unity, hãy chọn Window > Package Manager (Cửa sổ > Trình quản lý gói) rồi xoá gói External Dependency Manager (Trình quản lý phần phụ thuộc bên ngoài) (com.unity.external-dependency-manager). Việc xoá gói này sẽ xoá Enable External Dependency Manager (Bật Trình quản lý phần phụ thuộc bên ngoài) trong Assets > Google Mobile Ads > Settings (Tài sản > Quảng cáo của Google trên thiết bị di động > Cài đặt).

Cài đặt Trình quản lý phần phụ thuộc bên ngoài cũ

Nếu dự án của bạn sử dụng Unity 2022.2 trở xuống, bạn có thể cài đặt gói com.google.external-dependency-manager cũ của Google sau khi tắt gói của Unity:

• Tải tệp .unitypackage mới nhất xuống từ trang phát hành Trình quản lý phần phụ thuộc bên ngoài cho Unity rồi chọn Assets > Import Package > Custom Package (Tài sản > Nhập gói > Gói tuỳ chỉnh).

• Chạy lệnh OpenUPM CLI sau:

  openupm add com.google.external-dependency-manager

Định cấu hình phần phụ thuộc gốc theo cách thủ công

Nếu bạn không sử dụng gói Trình quản lý phần phụ thuộc bên ngoài, hãy thêm các thư viện bắt buộc từ tệp Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml và Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml vào tệp bản dựng:

• Đối với Android, hãy chọn Edit > Project Settings > Player > Android > Publishing Settings > Build (Chỉnh sửa > Cài đặt dự án > Trình phát > Android > Cài đặt phát hành > Bản dựng) rồi bật Custom Main Gradle Template (Mẫu Gradle chính tuỳ chỉnh). Thêm các thư viện bắt buộc từ tệp GoogleMobileAdsDependencies.xml và GoogleUmpDependencies.xml vào khối dependencies trong tệp Assets/Plugins/Android/mainTemplate.gradle:

  implementation 'com.google.android.gms:play-services-ads:25.5.0'
  implementation 'com.google.android.ump:user-messaging-platform:4.0.0'
  

  Ngoài ra, hãy thêm các gói androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process và androidx.fragment:fragment bằng cách sử dụng các phiên bản trong tệp GoogleMobileAdsDependencies.xml.

• Đối với iOS, hãy xuất dự án Xcode của bạn. Thêm các nhóm bắt buộc từ tệp GoogleMobileAdsDependencies.xml và GoogleUmpDependencies.xml vào tệp Podfile trong thư mục dự án đã xuất:

  pod 'Google-Mobile-Ads-SDK'
  pod 'GoogleUserMessagingPlatform'
  

  Sau đó, hãy chạy lệnh sau trong thư mục dự án iOS đã xuất:

  pod install --repo-update