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

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 đặt giá thầu và 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 iOS ứ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

  • Mục tiêu triển khai iOS 10.0 trở lên
  • [Đối với tính năng đặt giá thầu]: bộ chuyển đổi maio 1.5.8.0 trở lên (nên dùng phiên bản mới nhất)
  • 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ảngiOS 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ảngiOS 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.

[Chỉ có thác nước] Nhận mã API và khoá API

Ngoài Mã nhận dạng nội dung đa phương tiệnMã vùng, bạn cũng cần có Mã APIKhoá API để thiết lập mã đơn vị quảng cáo iOS 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

Đặt giá thầu

Trong thẻ Đặt giá thầu ở mục Nguồn quảng cáo, hãy chọn Thêm nguồn quảng cáo. Sau đó, chọn maio.

Tiếp theo, nhập ID nhà xuất bản nhận được trong phần trước và nhấp vào Xong.

Cuối cùng, hãy nhấp vào Lưu.

Thác nước

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 và nhập API IDAPI KEY được lấy 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 dòng sau vào Podfile của dự án:

    pod 'GoogleMobileAdsMediationMaio'
    
  • Trên dòng lệnh, hãy chạy:

    pod install --repo-update

Tích hợp thủ công

  • Tải phiên bản mới nhất của SDK maio.
  • Tải phiên bản mới nhất của bộ chuyển đổi maio xuống từ đường liên kết tải xuống trong Nhật ký thay đổi và liên kết maioAdapter.framework trong dự án.

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

Bạn không cần phải có mã bổ sung để tích hợp maio trên iOS.

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 7.26.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 GADResponseInfo.adNetworkInfoArray trong các lớp sau:

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

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.

Thay đổi bộ chuyển đổi dàn xếp iOS maio

Phiên bản tiếp theo

  • Cập nhật bộ chuyển đổi để sử dụng API didRewardUser.
  • Giờ đây, bạn cần có SDK quảng cáo trên thiết bị di động của Google phiên bản 9.8.0 trở lên.

Phiên bản 1.6.2.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.6.2 và SDK maioOB phiên bản 2.0.0-alpha.

Đượ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 9.5.0.
  • Maio SDK phiên bản 1.6.2.
  • MaioOB SDK phiên bản 2.0.0-alpha.

Phiên bản 1.6.1.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.6.1 và SDK maioOB phiên bản 2.0.0-alpha.

Đượ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 9.2.0.
  • Maio SDK phiên bản 1.6.1.
  • MaioOB SDK phiên bản 2.0.0-alpha.

Phiên bản 1.6.0.1

  • Khả năng tương thích đã xác minh với SDK quảng cáo trên thiết bị di động của Google phiên bản 9.0.0.
  • Hiện tại yêu cầu SDK quảng cáo trên thiết bị di động của Google phiên bản 9.0.0 trở lên

Đượ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 9.0.0.
  • Maio SDK phiên bản 1.6.0.
  • MaioOB SDK phiên bản 2.0.0-alpha.

Phiên bản 1.6.0.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.6.0 và SDK maioOB phiên bản 2.0.0-alpha.

Đượ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 8.13.0.
  • Hiện yêu cầu phiên bản iOS tối thiểu 10.0.
  • Maio SDK phiên bản 1.6.0.
  • MaioOB SDK phiên bản 2.0.0-alpha.

Phiên bản 1.5.8.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.5.8 và SDK maioOB phiên bản 2.0.0-alpha.
  • Đã thêm khả năng đặt giá thầu vào bộ chuyển đổi cho các định dạng quảng cáo xen kẽ và quảng cáo có tặng thưởng.
  • Đã nới lỏng phần phụ thuộc vào SDK quảng cáo trên thiết bị di động của Google phiên bản 8.0.0 trở lên.

Đượ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 8.7.0.
  • Maio SDK phiên bản 1.5.8.
  • MaioOB SDK phiên bản 2.0.0-alpha.

Phiên bản 1.5.6.1

  • Thêm các thông báo và mã lỗi bộ chuyển đổi được chuẩn hoá.
  • Cập nhật bộ chuyển đổi để sử dụng định dạng .xcframework.
  • Đã khắc phục lỗi mà các sự kiện quảng cáo có tặng thưởng đôi khi không được chuyển tiếp.
  • Giờ đây, bạn cần có SDK quảng cáo trên thiết bị di động của Google phiên bản 8.3.0 trở lên.

Đượ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 8.3.0.
  • Maio SDK phiên bản 1.5.6.

Phiên bản 1.5.6.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.5.6.
  • Giờ đây, bạn cần có SDK quảng cáo trên thiết bị di động của Google phiên bản 7.68.0 trở lên.

Đượ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 7.68.0.
  • Maio SDK phiên bản 1.5.6.

Phiên bản 1.5.5.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.5.5.
  • Giờ đây, bạn cần có SDK quảng cáo trên thiết bị di động của Google phiên bản 7.64.0 trở lên.

Đượ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 7.64.0.
  • Maio SDK phiên bản 1.5.5.

Phiên bản 1.5.4.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.5.4.
  • Hiện yêu cầu SDK quảng cáo trên thiết bị di động của Google phiên bản 7.60.0 trở lên.

Đượ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 7.60.0.
  • Maio SDK phiên bản 1.5.4.

Phiên bản 1.5.3.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ị.
  • Xoá tính năng hỗ trợ cho kiến trúc i386.

Đượ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 7.58.0.
  • Maio SDK phiên bản 1.5.3.

Phiên bản 1.5.3.0

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

Đượ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 7.55.1.
  • Maio SDK phiên bản 1.5.3.

Phiên bản 1.5.2.1

  • Khắc phục vấn đề trình chuyển đổi không gọi lệnh gọi lại -rewardedAdDidPresent:.

Đượ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 7.53.1.
  • Maio SDK phiên bản 1.5.2.

Phiên bản 1.5.2.0

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

Đượ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 7.53.1.
  • Maio SDK phiên bản 1.5.2.

Phiên bản 1.5.1.0

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

Đượ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 7.52.0.
  • Maio SDK phiên bản 1.5.1.

Phiên bản 1.5.0.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.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 7.51.0.
  • SDK quảng cáo Maio phiên bản 1.5.0.

Phiên bản 1.4.8.0

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

Phiên bản 1.4.6.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.4.6.
  • Cập nhật bộ chuyển đổi để sử dụng API quảng cáo có tặng thưởng mới.
  • Giờ đây, bạn cần có SDK quảng cáo trên thiết bị di động của Google phiên bản 7.42.2 trở lên.

Phiên bản 1.4.2.0

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

Phiên bản 1.4.1.0

  • Khả năng tương thích đã xác minh với SDK maio phiên bản 1.4.1.
  • Khắc phục vấn đề bộ chuyển đổi maio có thể không thành công nếu nhiều mã nhận dạng đa phương tiện được cung cấp từ AdMob.

Phiên bản 1.4.0.0

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

Phiên bản 1.3.2.0

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

Phiên bản 1.3.1.1

  • Thêm lệnh gọi lại adapterDidCompletePlayingRewardBasedVideoAd: vào trình chuyển đổi.

Phiên bản 1.3.1.0

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

Phiên bản 1.3.0.0

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

Phiên bản 1.2.19.0

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

Phiên bản 1.2.18.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.