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

Hướng dẫn này chỉ cho bạn cách sử dụng SDK Quảng cáo của Google trên thiết bị di động để tải và hiển thị quảng cáo từ i-mobile sử dụng tính năng dàn xếp, bao gồm việc tích hợp thác nước. Tài liệu này trình bày cách thêm i-mobile vào cấu hình dàn xếp của đơn vị quảng cáo và cách tích hợp SDK i-mobile và bộ chuyển đổi vào ứng dụng Unity.

Giao diện trang tổng quan của i-mobile sử dụng văn bản tiếng Nhật cho nhãn, các nút và phần mô tả. Các ảnh chụp màn hình trong hướng dẫn này chưa được đã dịch. Tuy nhiên, trong phần mô tả và hướng dẫn của hướng dẫn này, các nhãn và nút được dịch cùng với nội dung tương đương bằng tiếng Anh trong dấu ngoặc đơn.

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

Bộ chuyển đổi dàn xếp AdMob dành cho i-mobile có các khả năng sau:

Tích hợp
Đặt giá thầu
Thác nước
Định dạng
Biểu ngữ
Quảng cáo xen kẽ
Được thưởng

Yêu cầu

  • Unity 5.6 trở lên
  • SDK Quảng cáo của Google trên thiết bị di động mới nhất
  • Cách triển khai trên Android
    • API Android cấp 21 trở lên
  • Cách triển khai trên iOS
    • Mục tiêu triển khai iOS phiên bản 12.0 trở lên
  • Một dự án Unity đang hoạt động được định cấu hình bằng SDK quảng cáo trên thiết bị di động của Google. Hãy xem phần Bắt đầu để biết thông tin chi tiết.
  • Hoàn tất quá trình dàn xếp Hướng dẫn bắt đầu sử dụng

Bước 1: Thiết lập cấu hình trong giao diện người dùng i-mobile

Bước 2: Thiết lập nhu cầu i-mobile trong AdMob giao diện người dùng

Định cấu hình cài đặt dàn xếp cho đơn vị quảng cáo của bạn

Android

Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho Android.

iOS

Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho iOS.

Bước 3: Nhập SDK và bộ chuyển đổi i-mobile

OpenUPM-CLI

Nếu bạn có tệp OpenUPM-CLI bạn có thể cài đặt i-mobile Quảng cáo trên thiết bị di động của Google Trình bổ trợ dàn xếp dành cho Unity vào dự án của bạn bằng cách chạy lệnh sau từ thư mục gốc của dự án:

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

Trong trình chỉnh sửa dự án Unity, hãy chọn Edit (Chỉnh sửa) > Cài đặt dự án > Package Manager (Trình quản lý gói) để mở Cài đặt Trình quản lý gói Unity.

Trong thẻ Scoped Registries (Sổ đăng ký có giới hạn), hãy thêm OpenUPM làm sổ đăng ký có giới hạn với các thông tin chi tiết sau:

  • Tên: OpenUPM
  • URL: https://package.openupm.com
  • (Các) phạm vi: com.google

Chi tiết OpenUPM

Sau đó, điều hướng đến Window (Cửa sổ) > Package Manager (Trình quản lý gói) để mở Trình quản lý gói Unity và chọn Sổ đăng ký của tôi từ trình đơn thả xuống.

Tổ chức quản lý tên miền thống nhất

Chọn gói Google Mobile Ads i-mobile Mediation rồi nhấp vào Install (Cài đặt).

Cài đặt từ OpenUPM

Gói Unity

Tải phiên bản mới nhất của trình bổ trợ dàn xếp Quảng cáo trên thiết bị di động của Google xuống cho i-mobile từ đường liên kết tải xuống trong thời gian Nhật ký thay đổi và trích xuất GoogleMobileAdsIMobileMediation.unitypackage so với mã zip .

Trong trình chỉnh sửa dự án Unity, hãy chọn Assets (Tài sản) > Nhập gói > Custom Package (Gói tuỳ chỉnh) rồi tìm GoogleMobileAdsIMobileMediation.unitypackage tệp bạn đã tải xuống. Hãy đảm bảo rằng tất cả các tệp đã được chọn và nhấp vào Nhập.

Nhập từ Unity

Sau đó, chọn Thành phần > Trình phân giải các dịch vụ của Google Play > Trình phân giải Android > Buộc giải quyết. Trình phân giải dịch vụ của Google Play cho Unity thư viện sẽ thực hiện phân giải phần phụ thuộc từ đầu và 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.

Buộc giải quyết

Bước 4: Cần có thêm mã

Android

Không yêu cầu mã bổ sung khi tích hợp i-mobile.

iOS

Tích hợp SKAdNetwork

Làm theo tài liệu của i-mobile để thêm giá trị nhận dạng SKAdNetwork vào tệp Info.plist của dự án.

Bước 5: Kiểm tra kết quả triển khai

Bật quảng cáo thử nghiệm

Hãy nhớ đăng ký thiết bị thử nghiệm cho AdMob. i-mobile cung cấp mã vị trí, mã nội dung đa phương tiện và mã nhà xuất bản để kiểm thử. Bạn có thể tìm thấy các mã này tại đây.

Xác minh quảng cáo thử nghiệm

Để xác minh rằng bạn đang nhận quảng cáo thử nghiệm từ i-mobile, 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 cách sử dụng i-mobile (Waterfall) (các) nguồn quảng cáo.

Mã lỗi

Nếu trình chuyển đổi không nhận được quảng cáo từ i-mobile, nhà xuất bản có thể kiểm tra lỗi cơ bản từ phản hồi quảng cáo bằng cách sử dụng ResponseInfo trong các lớp sau:

Android

Định dạng Tên lớp
Biểu ngữ com.google.ads.mediation.imobile.IMobileAdapter
Quảng cáo xen kẽ com.google.ads.mediation.imobile.IMobileAdapter
Mã gốc com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

Định dạng Tên lớp
Biểu ngữ IMobileAdapter
Quảng cáo xen kẽ IMobileAdapter
Mã gốc GADMediationAdapterIMobile

Đây là các mã và tin nhắn đi kèm do bộ điều hợp i-mobile gửi khi quảng cáo không tải được:

Android

Mã lỗi Lý do
0-99 SDK i-mobile trả về một lỗi. Hãy xem mã để biết thêm thông tin chi tiết.
101 i-mobile yêu cầu ngữ cảnh Activity để tải quảng cáo.
102 Thiếu/không hợp lệ các thông số máy chủ i-mobile được định cấu hình trong giao diện người dùng AdMob .
103 Kích thước quảng cáo được yêu cầu không khớp với kích thước biểu ngữ được hỗ trợ trên i-mobile.
104 Lệnh gọi lại tải quảng cáo gốc thành công của i-mobile đã trả về danh sách quảng cáo gốc trống.

iOS

Mã lỗi Lý do
0-10 SDK i-mobile trả về một lỗi. Xem mã để biết thêm chi tiết.
101 Các tham số máy chủ i-mobile được thiết lập trong AdMob giao diện người dùng bị thiếu/không hợp lệ.
102 Kích thước quảng cáo được yêu cầu không khớp với kích thước biểu ngữ được hỗ trợ trên i-mobile.
103 i-mobile không thể hiển thị quảng cáo.
104 i-mobile trả về một mảng quảng cáo gốc trống.
105 Không thể tải nội dung quảng cáo gốc xuống i-mobile.
106 i-mobile không hỗ trợ yêu cầu nhiều quảng cáo xen kẽ bằng cách sử dụng cùng một ID Spot.

Nhật ký thay đổi của trình bổ trợ dàn xếp Unity i-mobile

Phiên bản 1.3.5

Phiên bản 1.3.4

Phiên bản 1.3.3

Phiên bản 1.3.2

Phiên bản 1.3.1

Phiên bản 1.3.0

Phiên bản 1.2.2

Phiên bản 1.2.1

Phiên bản 1.2.0

Phiên bản 1.1.0

Phiên bản 1.0.2

Phiên bản 1.0.1

Phiên bản 1.0.0