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

Chọn nền tảng: Android (beta) Mới Android iOS Unity Flutter

Hướng dẫn này sẽ cho bạn biết cách sử dụng Google Mobile Ads Flutter Plugin để tải và hiển thị quảng cáo từ maio bằng tính năng dàn xếp, bao gồm cả các hoạt động tích hợp theo kiểu thác nước. Tài liệu này trình bày cách thêm maio vào cấu hình dàn xếp của một đơn vị quảng cáo, cũng như cách tích hợp SDK và bộ chuyển đổi của maio vào một ứng dụng Flutter.

Giao diện trang tổng quan của maio sử dụng văn bản tiếng Nhật cho nhãn, nút và nội dung mô tả. Ả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 ở đây, nhãn và nút được gọi bằng các từ tương đương trong tiếng Anh. Ví dụ: "URL スキーム" là "URL Scheme".

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

Bộ chuyển đổi dàn xếp cho maio có các chức 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 trung gian
Được thưởng
Mã gốc

Yêu cầu

  • Mới nhất Google Mobile Ads Flutter Plugin
  • Flutter phiên bản 3.7.0 trở lên
  • Để triển khai trên Android
    • Android API cấp độ 23 trở lên
  • Để triển khai trên iOS
    • Mục tiêu triển khai iOS là 12.0 trở lên
  • Một dự án Flutter đang hoạt động được định cấu hình bằng Google Mobile Ads Flutter Plugin. Hãy xem phần Thiết lập Google Mobile Ads Flutter Plugin để biết thông tin chi tiết.
  • Thiết lập tính năng dàn xếp.

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

Trước tiên, đăng ký hoặc đăng nhập vào tài khoản maio. Nhấp vào nút Application management (Quản lý ứng dụng) trên thanh bên trái, rồi nhấp vào New app (Ứng dụng mới).

Chọn thẻ tương ứng với Ad Type (Loại quảng cáo) mà bạn muốn.

Quảng cáo xen kẽ

Nhập Name (Tên) của ứng dụng, chọn nền tảng và cung cấp App URL (URL ứng dụng). Chọn Video interstitial (Quảng cáo xen kẽ dạng video) làm Ad Type (Loại quảng cáo), sau đó nhấp vào Update (Cập nhật).

Android

iOS

Được thưởng

Nhập Name (Tên) của ứng dụng, chọn nền tảng và cung cấp App URL (URL ứng dụng). Chọn Video Rewards (Quảng cáo video có tặng thưởng) làm Ad Type (Loại quảng cáo), sau đó nhấp vào Update (Cập nhật).

Android

iOS

Trên trang Application Management (Quản lý ứng dụng), hãy ghi lại Media ID (Mã nội dung nghe nhìn). Bạn cần mã này để thiết lập đơn vị quảng cáo Ad Manager trong phần tiếp theo.

Android

iOS

Trên trang Zone Management (Quản lý vùng), hãy ghi lại Zone ID (Mã vùng). Bạn cũng cần mã này để thiết lập đơn vị quảng cáo Ad Manager trong phần tiếp theo.

Android

iOS

(Chỉ dành cho thác nước) Ngoài Media ID (Mã nội dung nghe nhìn) và Zone ID (Mã vùng), bạn cần có API ID (Mã API) và API KEY (Khoá API) để thiết lập mã đơn vị quảng cáo cho tính năng dàn xếp. Trên Reporting API page (Trang API báo cáo), hãy ghi lại API ID (Mã API) và API KEY (Khoá API).

Bước 2: Thiết lập nhu cầu về maio trong giao diện người dùng Ad Manager

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

Android

Để biết hướng dẫn, hãy xem bước 2 trong tài liệu về Android.

iOS

Để biết hướng dẫn, hãy xem bước 2 trong tài liệu về iOS.

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

Tích hợp thông qua pub.dev

Thêm phần phụ thuộc sau đây bằng các phiên bản mới nhất của SDK và bộ chuyển đổi maio trong tệp pubspec.yaml của gói:

dependencies:
  gma_mediation_maio: ^1.1.3

Tích hợp thủ công

Tải phiên bản mới nhất của trình bổ trợ dàn xếp Quảng cáo của Google trên thiết bị di động cho maio, trích xuất tệp đã tải xuống và thêm thư mục trình bổ trợ đã trích xuất (cùng nội dung của thư mục đó) vào dự án Flutter. Sau đó, tham chiếu đến trình bổ trợ trong tệp pubspec.yaml bằng cách thêm phần phụ thuộc sau:

dependencies:
  gma_mediation_maio:
    path: path/to/local/package

Bước 4: Thêm mã bắt buộc

Android

Bạn không cần thêm mã nào khác để tích hợp maio.

iOS

Tích hợp SKAdNetwork

Hãy làm theo tài liệu của maio để thêm các mã nhận dạng SKAdNetwork vào tệp Info.plist của dự án.

Bước 5: Kiểm thử việc triển khai

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

Đảm bảo rằng bạn đăng ký thiết bị thử nghiệm cho Ad Manager.

Các nhà xuất bản sử dụng phiên bản 7.26.0 trở lên của Google Mobile Ads Flutter Plugin sẽ tự động nhận được quảng cáo thử nghiệm từ maio trên điện thoại và máy tính bảng đã đăng ký làm thiết bị thử nghiệm khi đưa ra yêu cầu.

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

Để xác minh rằng bạn đang nhận được quảng cáo thử nghiệm từ maio, hãy bật tính năng 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 maio (Waterfall)(các) nguồn quảng cáo.

Mã lỗi

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

Android

Định dạng Tên lớp
Quảng cáo xen kẽ jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Được thưởng jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

Định dạng Tên lớp
Quảng cáo xen kẽ GADMMaioInterstitialAdapter
Được thưởng GADMMaioRewardedAdapter

Dưới đây là các mã và thông báo đi kèm do bộ chuyển đổi maio gửi khi quảng cáo không tải được:

Android

Mã lỗi Lý do
0-10 maio đã trả về một lỗi dành riêng cho SDK. Hãy xem mã và tài liệu của maio để biết thêm thông tin.
101 Maio không có quảng cáo.
102 Tham số máy chủ không hợp lệ (ví dụ: thiếu Mã vị trí đặt quảng cáo).
103 Ngữ cảnh dùng để tải quảng cáo không phải là một thực thể `Activity`.

iOS

Mã lỗi Lý do
0-10 maio đã trả về một lỗi dành riêng cho SDK. Hãy xem mã của maio để biết thêm thông tin.
101 maio chưa có quảng cáo.
102 Tham số máy chủ không hợp lệ (ví dụ: thiếu Mã vị trí đặt quảng cáo).
103 Bộ chuyển đổi maio không hỗ trợ định dạng quảng cáo đang được yêu cầu.
104 Một quảng cáo đã được tải cho cấu hình mạng này.

Nhật ký thay đổi của Bộ chuyển đổi dàn xếp Flutter cho maio

Phiên bản 1.1.4 (Đang tiến hành)

Phiên bản 1.1.3

Phiên bản 1.1.2

Phiên bản 1.1.1

Phiên bản 1.1.0

Phiên bản 1.0.3

Phiên bản 1.0.2

Phiên bản 1.0.1

Phiên bản 1.0.0