Tích hợp i-mobile 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ừ i-mobile thông qua quy trình dàn xếp. Bài này trình bày cách thêm i-mobile vào cấu hình dàn xếp của một đơn vị quảng cáo, cách thiết lập tối ưu hoá nguồn quảng cáo, và cách tích hợp SDK i-mobile và bộ chuyển đổi vào ứng dụngAndroid .

Giao diện trang tổng quan cho i-mobile sử dụng văn bản tiếng Nhật cho các 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 này, các nhãn và nút sẽ được dịch bằng các từ 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ợ

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

Yêu cầu

  • Android API cấp 19 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 i-mobile

Đăng ký hoặc đăng nhập vào tài khoản i-mobile của bạn.

Thêm ứng dụng của bạn vào trang tổng quan dành cho thiết bị di động bằng cách nhấp vào thẻ サ giọng nói/アプお管理 (Quản lý trang web/ứng dụng) rồi nhấp vào Port規Androidアプル (New Android App)

Đăng ký ứng dụng của bạn bằng cách cung cấp SYMBOL称 (Tên)マーケとmọi URL (URL thị trường). Sau đó, nhấp vào nút -登録 (Đăng ký) sau khi điền các bước còn lại của biểu mẫu.

Để tạo một vị trí mới có tên là Quảng cáo, hãy chọn ứng dụng của bạn trong thẻ サננ/アプお管理 (Quản lý trang web/ứng dụng).

Chuyển đến thẻ 広告スポRATINGと管理 (Quản lý vị trí quảng cáo) rồi nhấp vào nút "菏広告スポとと (New Ad Spot).

tạo_quảng_cáo_quảng_cáo

Tiếp theo, hãy điền vào biểu mẫu bằng cách cung cấp 広告スポRATINGとム (Tên điểm quảng cáo), 広告スポとシサねズ (Kích thước vị trí quảng cáo) và các thông tin chi tiết khác. Sau đó, hãy nhấp vào nút "登録 (Đăng ký).

new_ad_spot_form

Vị trí quảng cáo mới của bạn đã sẵn sàng. Để xem thông tin chi tiết về yêu cầu tích hợp, hãy nhấp vào nút アプおお定取得 (Get App settings).

ad_spot_list

Hãy lưu ý đến パブルーシャーID (Mã nhà xuất bản), ಠデアID (Mã nội dung đa phương tiện)スポとscrollID (Mã nhận dạng). Bạn sẽ cần các thông số này sau khi định cấu hình i-mobile để dàn xếp trong giao diện người dùng AdMob .

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ây giờ, bạn sẽ cần thêm i-mobile vào cấu hình dàn xếp cho đơn vị quảng cáo. Để làm như vậy, trước tiên, hãy đăng nhập vào tài khoản AdMob của bạn.

Tiếp theo, hãy chuyển đến thẻ Dàn xếp. Nếu bạn có 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 để chuyển sang bước Thêm i-mobile 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.

Thẻ dàn xếp AdMob

Nhập định dạng quảng cáo và nền tảng, sau đó nhấp vào Tiếp tục.

Đặt tên cho nhóm dàn xếp, rồi chọn các vị trí để nhắm đến. Tiếp theo, hãy đặt trạng thái nhóm dàn xếp thành Enabled (Bật). Sau đó, hãy 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 các đơn vị quảng cáo AdMob hiện có của bạn. 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à bạn đã chọn.

Thêm i-mobile 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 i-mobile và bật tính năng Optimize. Nhập Tên đăng nhậpMật khẩu API của tài khoản i-mobile để thiết lập tính năng tối ưu hoá nguồn quảng cáo cho i-mobile. Sau đó, hãy nhập một giá trị eCPM cho i-mobile rồi nhấp vào Tiếp tục.

Nhập Mã nhà xuất bản, Mã nội dung nghe nhìnMã vị trí mà bạn có được trước đó.

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

Thêm các phần phụ thuộc triển khai sau với các phiên bản mới nhất của SDK i-mobile và bộ chuyển đổi trong tệp build.gradle cấp ứng dụng:

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

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

Tích hợp thủ công

  1. Tải phiên bản mới nhất của i-mobile SDK xuống và giải nén android-ad-sdk.aar trong thư mục sdk rồi thêm vào dự án của bạn.

  2. Chuyển đến các cấu phần phần mềm bộ chuyển đổi i-mobile 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 .aar của bộ chuyển đổi i-mobile lên và thêm tệp này vào dự án của bạ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 i-mobile.

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

Để kiểm tra tích hợp của bạn, i-mobile cung cấp Mã nhận dạng điểm, Mã nội dung đa phương tiện thử nghiệm, và Mã nhà xuất bản cho tất cả định dạng quảng cáo. Bạn có thể tìm thấy các tệp này tại đây.

Các bước không bắt buộc

Sử dụng quảng cáo gốc

Hiển thị quảng cáo

Bộ chuyển đổi i-mobile điền sẵn nội dung mô tả trường nâng cao của Quảng cáo gốc cho NativeAd.

Trường Nội dung luôn được bộ chuyển đổi i-mobile thêm vào
Dòng tiêu đề
Hình ảnh
Nội dung
Biểu tượng ứng dụng 1
Lời kêu gọi hành động
Điểm xếp hạng theo sao
Cửa hàng
Giá

1 Đối với quảng cáo gốc, SDK i-mobile không cung cấp thành phần biểu tượng ứng dụng. Thay vào đó, bộ chuyển đổi i-mobile sẽ điền một hình ảnh trong suốt vào biểu tượng ứng dụng.

Mã lỗi

Nếu bộ chuyển đổi không thể nhận 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.getAdapterResponse() trong các lớp sau:

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

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

Mã lỗi Lý do
0-99 SDK i-mobile đã trả về lỗi. Hãy xem để biết thêm chi tiết.
101 i-mobile yêu cầu ngữ cảnh Activity để tải quảng cáo.
102 Thông số máy chủ i-mobile được định cấu hình trong AdMob giao diện người dùng bị thiếu/không hợp lệ.
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 i-mobile hỗ trợ.
104 Lệnh gọi lại thành công khi tải quảng cáo gốc của i-mobile\39; đã trả về danh sách quảng cáo gốc trống.
0-10 SDK i-mobile đã trả về lỗi. Hãy xem để biết thêm chi tiết.
101 Thông số máy chủ i-mobile được định cấu hình 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 i-mobile hỗ trợ.
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 i-mobile không thể tải xuống nội dung quảng cáo gốc.
106 i-mobile không hỗ trợ yêu cầu cho nhiều quảng cáo xen kẽ bằng cách sử dụng cùng một mã Spot.

Thay đổi bộ chuyển đổi dàn xếp Android i-mobile

Phiên bản 2.0.23.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.
  • IMobile SDK phiên bản 2.0.23.

Phiên bản 2.0.23.0

  • Khả năng tương thích đã xác minh với i-mobile SDK phiên bản 2.0.23.
  • 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 20.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 20.5.0.
  • IMobile SDK phiên bản 2.0.23.

Phiên bản 2.0.22.2

  • Thêm các thông báo và mã lỗi bộ chuyển đổi được chuẩn hoá.
  • 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 20.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 20.1.0.
  • IMobile SDK phiên bản 2.0.22.

Phiên bản 2.0.22.1

  • 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.
  • IMobile SDK phiên bản 2.0.22.

Phiên bản 2.0.22.0

  • Khả năng tương thích đã xác minh với i-mobile SDK phiên bản 2.0.22.
  • Cập nhật bộ chuyển đổi để hỗ trợ các yêu cầu biểu ngữ thích ứng cùng dòng.

Đượ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.
  • IMobile SDK phiên bản 2.0.22.

Phiên bản 2.0.21.0

  • Khả năng tương thích đã xác minh với SDK i-mobile v2.0.21.
  • 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.
  • Thêm tùy chọn hỗ trợ cho việc mở rộng quảng cáo biểu ngữ thích ứng.

Đượ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.
  • IMobile SDK phiên bản 2.0.21.

Phiên bản 2.0.20.2

  • Thêm tùy chọn hỗ trợ cho kích thước quảng cáo biểu ngữ linh hoạt.
  • 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.
  • IMobile SDK phiên bản 2.0.20.

Phiên bản 2.0.20.1

  • Bộ chuyển đổi hiện trả về tỷ lệ khung hình mediaContent khác 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.2.0.
  • IMobile SDK phiên bản 2.0.20.

Phiên bản 2.0.20.0

  • Bản phát hành đầu tiên!
  • Đã thêm tùy chọn hỗ trợ cho quảng cáo biểu ngữ, quảng cáo xen kẽ và quảng cáo gốc.