Tích hợp maio với Dàn xếp

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Hướng dẫn này dành cho những nhà xuất bản muốn sử dụng SDK quảng cáo trên thiết bị di động của Google để tải và hiển thị quảng cáo từ maio thông qua thác nước dàn xếp. Đồng thời, bạn sẽ tìm hiểu cách thêm quảng cáo 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 maio và bộ chuyển đổi vào Android ứng dụng.

Giao diện trang tổng quan cho maio sử dụng văn bản tiếng Nhật cho các nhãn, nút và mô tả của nó và ả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 này, các nhãn và nút sẽ được tham chiếu bằng các từ tương đương bằng tiếng Anh. "URL スキーム," ví dụ: là "Lược đồ URL," và cứ tiếp tục như vậy.

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

Bộ chuyển đổi AdMob dàn xếp cho maio 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
Gốc

Yêu cầu

  • Android API cấp 19 trở lên
  • SDK maio 1.0.7 trở lên
  • SDK quảng cáo trên thiết bị di động mới nhất của Google

Bước 1: Thiết lập mạng maio

Trước tiên, hãy đăng ký hoặc đăng nhập vào tài khoản maio của bạn. Nhấp vào nút Quản lý ứng dụng trên thanh bên trái và nhấp vào Ứng dụng mới.

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

Quảng cáo xen kẽ

Nhập Tên của ứng dụng, đặt nền tảngAndroid và cung cấp URL ứng dụng. Chọn Quảng cáo xen kẽ video làm Loại quảng cáo, sau đó nhấp vào Cập nhật.

Được thưởng

Nhập Tên của ứng dụng, đặt nền tảngAndroid và cung cấp URL ứng dụng. Chọn Phần thưởng video làm Loại quảng cáo, sau đó nhấp vào Cập nhật.

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 thiết lập AdMob đơn vị quảng cáo trong phần tiếp theo.

Trên trang Quản lý vùng, hãy ghi lại Mã vùng. Bạn cũng cần thiết lập đơn vị quảng cáo AdMob trong phần tiếp theo.

Ngoài Mã nhận dạng nội dung nghe nhìnMã vùng, bạn cũng cần có Mã APIKhoá API để thiết lập mã đơn vị quảng cáo Android cho tính năng dàn xếp.

Trong trang API API, hãy ghi lại Mã APIKhoá API.

Bước 2: Định cấu hình chế độ cài đặt dàn xếp AdMob cho đơn vị quảng cáo của bạn

Bạn cần thêm maio vào cấu hình dàn xếp cho đơn vị quảng cáo của mình. Trước tiên, hãy đăng nhập vào tài khoản AdMob của bạn.

Chuyển đến thẻ Dàn xếp. Nếu bạn có một nhóm dàn xếp hiện có mà bạn muốn sửa đổi, hãy nhấp vào tên của nhóm dàn xếp đó để chỉnh sửa và bỏ qua để đến bước Thêm maio làm nguồn quảng cáo.

Để tạo một nhóm dàn xếp mới, hãy chọn Tạo nhóm dàn xếp.

Nhập Định dạng quảng cáoNền tảng của bạn, rồi nhấp vào Tiếp tục.

Đặt Tên cho nhóm dàn xếp của bạn và chọn vị trí để nhắm đến. Tiếp theo, hãy đặt trạng thái nhóm dàn xếp thành Bật, sau đó nhấp vào Thêm đơn vị quảng cáo.

Liên kết nhóm dàn xếp này với một hoặc nhiều đơn vị quảng cáo AdMob hiện có. Sau đó, hãy nhấp vào Xong.

Bây giờ, bạn sẽ thấy thẻ đơn vị quảng cáo chứa các đơn vị quảng cáo mà mình đã chọn như dưới đây:

Thêm maio làm nguồn quảng cáo

Trong thẻ Nguồn quảng cáo, hãy chọn Thêm mạng quảng cáo. Chọn maio làm mạng quảng cáo rồi nhập API IDAPI KEY có được trong phần trước để thiết lập tính năng tối ưu hóa nguồn quảng cáo cho maio. Sau đó, hãy nhập một giá trị eCPM cho maio rồi nhấp vào Tiếp tục.

Nhập Media ID (Mã nội dung đa phương tiện) và Zone ID (Mã vùng) có được trong phần trước rồi nhấp vào Xong.

Sử dụng quảng cáo video có tặng thưởng

Trong phần cài đặt của đơn vị quảng cáo dạng video có tặng thưởng, hãy cung cấp giá trị cho số tiền thưởng và loại phần thưởng. Sau đó, để đảm bảo bạn cung cấp cùng một phần thưởng cho người dùng bất kể mạng quảng cáo nào được phân phát, hãy đánh dấu vào hộp Áp dụng cho tất cả các mạng trong Nhóm dàn xếp.

Nếu bạn không áp dụng chế độ cài đặt này, bộ chuyển đổi maio sẽ mặc định sử dụng phần thưởng loại "" (chuỗi trống) có giá trị là 1. SDK maio không cung cấp giá trị phần thưởng cụ thể cho quảng cáo video có tặng thưởng.

Để biết thêm thông tin về cách đặt giá trị phần thưởng cho các đơn vị quảng cáo AdMob, hãy xem bài viết Tạo đơn vị quảng cáo.

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

Thêm kho lưu trữ maio Maven và phần phụ thuộc triển khai sau bằng phiên bản mới nhất của SDK Firebase trong tệp build.gradle ở cấp ứng dụng:

repositories {
    google()
    mavenCentral()
    maven {
        url "https://imobile-maio.github.io/maven"
    }
}

...
dependencies {
   implementation 'com.google.android.gms:play-services-ads:21.2.0'
   implementation 'com.google.ads.mediation:maio:1.1.16.1'
}
...

Tích hợp thủ công

  • Tải phiên bản mới nhất của SDK Android ioio rồi thêm dự án đó vào dự án của bạn.
  • Chuyển đến cấu phần phần mềm chuyển đổiio trên Maven Repository (Kho lưu trữ Maven) của Google. Chọn phiên bản mới nhất, tải tệp "bộ chuyển đổi maio" xuống.Thêm nó vào dự án của bạn.

Bước 4: Cần có mã bổ sung

Bạn không cần nhập thêm mã để tích hợp Android maio.

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

Nhà xuất bản sử dụng SDK quảng cáo trên thiết bị di động của Google phiên bản 11.6.0 trở lên 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ý test devices khi đưa ra yêu cầu.

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ừ phản hồi quảng cáo bằng cách sử dụng ResponseInfo.getAdapterResponses() trong các lớp sau:

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

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:

Mã lỗi Lý do
0-10 maio trả về lỗi dành riêng cho SDK. Hãy xem tài liệu về và maio để biết thêm thông tin chi tiết.
101 Maio không có quảng cáo.
102 Thông số máy chủ không hợp lệ (ví dụ: thiếu Mã vị trí).
103 Ngữ cảnh dùng để tải quảng cáo không phải là bản sao `Hoạt động`.
0-10 maio trả về lỗi dành riêng cho SDK. Hãy xem của maio để biết thêm chi tiết.
101 maio chưa có quảng cáo nào.
102 Thông số máy chủ không hợp lệ (ví dụ: thiếu Mã vị trí).
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 bộ chuyển đổi dàn xếp Android maio

Phiên bản 1.1.16.1

  • Cập nhật compileSdkVersiontargetSdkVersion thành API 31.
  • Cập nhật phiên bản SDK quảng cáo trên thiết bị di động của Google tối thiểu lên phiên bản 21.0.0.
  • Cập nhật cấp độ API Android tối thiểu bắt buộc lên 19.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 21.0.0.
  • Maio SDK phiên bản 1.1.16.

Phiên bản 1.1.16.0

  • Cập nhật mã lỗi để phát hiện thêm các lỗi maio.
  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.16.
  • Cập nhật SDK quảng cáo trên thiết bị di động của Google phiên bản tối thiểu lên 20.4.0.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 20.4.0.
  • Maio SDK phiên bản 1.1.16.

Phiên bản 1.1.15.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.15.
  • Cập nhật SDK quảng cáo trên thiết bị di động của Google phiên bản tối thiểu lên 20.0.0.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 20.0.0.
  • Maio SDK phiên bản 1.1.15.

Phiên bản 1.1.14.0

  • Thêm các thông báo và mã lỗi bộ chuyển đổi được chuẩn hoá.
  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.14.
  • Cập nhật phiên bản SDK quảng cáo trên thiết bị di động của Google tối thiểu lên phiên bản 19.8.0.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 19.8.0.
  • Maio SDK phiên bản 1.1.14.

Phiên bản 1.1.13.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.13.
  • Cập nhật phiên bản SDK quảng cáo trên thiết bị di động của Google tối thiểu lên phiên bản 19.5.0.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 19.5.0.
  • Maio SDK phiên bản 1.1.13.

Phiên bản 1.1.12.0

  • Cập nhật phiên bản SDK quảng cáo trên thiết bị di động của Google tối thiểu lên phiên bản 19.4.0.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 19.4.0.
  • Maio SDK phiên bản 1.1.12.

Phiên bản 1.1.11.1

  • Giờ đây, các yêu cầu quảng cáo sẽ ngay lập tức không thành công nếu không có quảng cáo sẵn sàng hiển thị.
  • Cập nhật phiên bản SDK quảng cáo trên thiết bị di động của Google tối thiểu lên phiên bản 19.1.0.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 19.1.0.
  • Maio SDK phiên bản 1.1.11.

Phiên bản 1.1.11.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.11.
  • Cập nhật SDK quảng cáo trên thiết bị di động của Google phiên bản tối thiểu lên 18.3.0.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 18.3.0.
  • Maio SDK phiên bản 1.1.11.

Phiên bản 1.1.10.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.10.
  • Cập nhật phiên bản SDK quảng cáo trên thiết bị di động của Google tối thiểu lên phiên bản 18.2.0.

Phiên bản 1.1.8.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.8.
  • Cập nhật phiên bản SDK quảng cáo trên thiết bị di động của Google tối thiểu lên phiên bản 18.1.0.

Phiên bản 1.1.7.0

  • Sửa lỗi.
  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.7.

Phiên bản 1.1.6.1

  • Cập nhật bộ chuyển đổi để hỗ trợ API quảng cáo có tặng thưởng mới.
  • Cập nhật phiên bản SDK quảng cáo trên thiết bị di động của Google tối thiểu lên phiên bản 17.2.0.

Phiên bản 1.1.6.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.6.

Phiên bản 1.1.5.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.5.

Phiên bản 1.1.4.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.4.

Phiên bản 1.1.3.1

  • Cập nhật bộ chuyển đổi để hoạt động với lớp phiên bản thay vì singleton.

Phiên bản 1.1.3.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.3.

Phiên bản 1.1.2.1

  • Cập nhật bộ chuyển đổi bằng các hàm khởi chạy được cập nhật.

Phiên bản 1.1.2.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.2.

Phiên bản 1.1.1.1

  • Cập nhật bộ chuyển đổi để gọi sự kiện quảng cáo onRewardedVideoComplete().

Phiên bản 1.1.1.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.1.

Phiên bản 1.1.0.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.1.0.

Phiên bản 1.0.8.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.0.8.

Phiên bản 1.0.7.1

  • Khắc phục vấn đề có thể khiến NullPointerExceptions xảy ra khi không tải được quảng cáo.

Phiên bản 1.0.7.0

  • Thêm chức năng bật chế độ thử nghiệm bằng cách thêm mã thiết bị thử nghiệm vào AdRequest.
  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.0.7.

Phiên bản 1.0.6.0

  • Bản phát hành đầu tiên!
  • Đã thêm tùy chọn hỗ trợ cho quảng cáo xen kẽ và quảng cáo dạng video có tặng thưởng.