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

Hướng dẫn này cho bạn biết cách sử dụng Google Mobile Ads SDK for React Native để 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 maio vào một ứng dụng React Native.

Giao diện trang tổng quan của maio sử dụng văn bản tiếng Nhật cho các nhãn, nút và nội dung mô tả, đồng thời ả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, các nhãn và nút được gọi bằng tên tiếng Anh tương đương. "URL スキーム," for example, is "URL Scheme,".

Các định dạng quảng cáo và công cụ 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
Mở ứng dụng
Biểu ngữ
Quảng cáo xen kẽ
Quảng cáo có tặng thưởng
Quảng cáo xen kẽ có tặng thưởng
Mã gốc

Điều kiện tiên quyết

Trước khi tiếp tục, hãy xác minh những thông tin sau:

Bước 1: Thiết lập cấu hình trong giao diện người dùng của 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 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 Loại quảng cáo mà bạn muốn.

Quảng cáo xen kẽ

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

Android

iOS

Được thưởng

Nhập Tên ứng dụng, chọn nền tảng và cung cấp URL ứng dụng. Chọn Phần thưởng video làm Loại quảng cáo, rồi nhấp vào 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ã nhận dạng nội dung đa phương tiện). Bạn cần có mã này để thiết lập đơn vị quảng cáo AdMob 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 AdMob trong phần tiếp theo.

Android

iOS

(Chỉ dành cho Thác nước) Ngoài Mã nội dung nghe nhìn và Mã vùng, bạn sẽ cần Mã API và KHOÁ API để thiết lập mã đơn vị quảng cáo cho tính năng dàn xếp. Trong trang API Báo cáo, hãy ghi lại MÃ API và KHOÁ API.

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

Đị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 maio

Trong thư mục gốc của dự án, hãy cài đặt bộ chuyển đổi dàn xếp Google Mobile Ads SDK for React Native cho maio. Hãy hoàn tất các bước sau:

  1. Sao chép tệp tar của bộ chuyển đổi Google Mobile Ads SDK for React Native từ thư mục gma-sdk-react-native/adapters/maio/ vào thư mục local_packages/ của dự án. Nếu bạn không có thư mục adapters, hãy xem phần Điều kiện tiên quyết.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/maio/gma-mediation-maio-0.1.0.tgz local_packages/

    Thay thế EXTRACT_DIR bằng đường dẫn đến thư mục mà bạn đã giải nén tệp lưu trữ.

  2. Cài đặt gói bộ chuyển đổi bằng trình quản lý gói mà bạn muốn:

    npm

    npm install ./local_packages/gma-mediation-maio-0.1.0.tgz

    chỉ len

    yarn add ./local_packages/gma-mediation-maio-0.1.0.tgz

  3. Nếu bạn đang xây dựng cho Android, hãy thêm kho lưu trữ sau vào tệp build.gradle trong thư mục android của dự án:

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

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

Android

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

iOS

Tích hợp SKAdNetwork

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

Bước 5: Kiểm thử kết quả 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 AdMob.

Những nhà xuất bản sử dụng phiên bản 7.26.0 trở lên của Google Mobile Ads SDK for React Native 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 gửi 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 (các) nguồn quảng cáo maio (Thác nước).

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 trong 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 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 Bối 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 chi tiết.
101 maio chưa 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 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.

Phiên bản 0.1.0

  • Bản phát hành đầu tiên.