Tích hợp i-mobile với tính năng 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.

Tài liệu hướng dẫn này trình bày cách 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 bằng cách sử dụng tính năng dàn xếp, bao gồm việc tích hợp thác nước. 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 và cách tích hợp SDK và bộ chuyển đổi i-mobile vào ứng dụng Android .

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 nội dung mô tả và hướng dẫn của 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 tiếng Anh trong dấu ngoặc đơn.

Các 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 tính 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

  • API Android 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ẻ サカカ/アプカ管理 (Quản lý trang web/ứng dụng) rồi nhấp vào菏Androidアプカ (Ứng dụng Android mới) .

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

Để tạo hơn một Quảng cáo mới, 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ẻ 広告スポッカ管理 (Quản lý vị trí quảng cáo) rồi nhấp vào nút Proxy規広告スポッカ (New Spot).

create_ad_spot (tạo quảng cáo)

Tiếp theo, điền thông tin vào biểu mẫu bằng cách cung cấp 広告スポッカカ (tên Vị trí quảng cáo), 広告スポッカサUNSUPPORTEDズ (Kích thước vị trí quảng cáo) và các thông tin chi tiết khác. Sau đó, nhấp vào nút Proxy規登録 (Đăng ký).

ad_spot_biểu mẫu mới

Vị trí quảng cáo mới của bạn đã sẵn sàng. Để xem thông tin chi tiết về quá trình tích hợp, hãy nhấp vào nút アプカ善定取得 (Tải chế độ cài đặt ứng dụng).

ad_spot_list

Hãy lưu ý đến các mã パブ高ッカャーID (Mã nhà xuất bản), 六デをアID (Media ID)スポッカID (Mã nhận dạng). Bạn sẽ cần những thông số này sau khi định cấu hình i-mobile để dàn xếp trong AdMob Giao diện người dùng.

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

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 của mình. Để đăng nhập, 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 hiện có một nhóm dàn xếp 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à chuyển đến 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 của bạn, rồi nhấp vào Tiếp tục.

Đặt tên cho nhóm dàn xếp và chọn các vị trí để nhắm đến. Tiếp theo, hãy đặt trạng thái của 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 được điền sẵn những đơ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 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ã điểm mà bạn nhận được trước đó.

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

Thêm các phần phụ thuộc triển khai sau với phiên bản mới nhất của SDK dành cho thiết bị di động 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.3.0'
    implementation 'com.google.ads.mediation:imobile:2.3.0.0'
}
...

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à trích xuất android-ad-sdk.aar trong thư mục sdk rồi thêm vào dự án.

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

Bước 4: Yêu cầu thêm mã

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

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

Để kiểm tra việc tích hợp, i-mobile cung cấp Mã nhận dạng, Mã nội dungMã nhà xuất bản thử nghiệm cho tất cả định dạng quảng cáo. Bạn có thể tìm thấy các tính năng đó 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 sẽ điền các trường sau: Quảng cáo gốc nâng cao vào trường cho NativeAd.

Trường Thành phần luôn được bộ chuyển đổi i-mobile bao gồm
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 dành cho thiết bị di động 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 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 nhận được quảng cáo từ i-mobile, nhà xuất bản có thể kiểm tra lỗi cơ bản từ nội dung 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 dựng.imobile.IMobileAdapter
Quảng cáo xen kẽ com.google.ads.dàn dựng.imobile.IMobileAdapter
Gốc com.google.ads.dàn dựng.imobile.IMobileDànAdapter

Dưới đây là các mã và thông báo đi kèm do bộ chuyển đổi i-mobile hiển thị 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 thông tin.
101 i-mobile yêu cầu ngữ cảnh Activity để tải quảng cáo.
102 Tham 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 đã yêu cầu không khớp với kích thước biểu ngữ được hỗ trợ i-mobile.
104 Lệnh gọi lại tải quảng cáo gốc thành công của i-mobile đã 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 thông tin.
101 Tham 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 đã yêu cầu không khớp với kích thước biểu ngữ được hỗ trợ i-mobile.
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 nhiều quảng cáo xen kẽ sử dụng cùng một mã Spot.

Nhật ký thay đổi bộ chuyển đổi dàn xếp Android i-mobile

Phiên bản 2.3.0.0

  • Khả năng tương thích đã được xác minh với SDK dành cho thiết bị di động phiên bản 2.3.0.
  • Cập nhật phiên bản tối thiểu bắt buộc của SDK quảng cáo trên thiết bị di động của Google lên phiên bản 21.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 21.3.0.
  • SDK IMobile phiên bản 2.3.0.

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 21.0.0.
  • Cập nhật cấp độ API tối thiểu bắt buộc trên Android lên cấp 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.
  • SDK IMobile phiên bản 2.0.23.

Phiên bản 2.0.23.0

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

Được tạo 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.
  • SDK IMobile phiên bản 2.0.23.

Phiên bản 2.0.22.2

  • Thêm thông báo và mã lỗi bộ chuyển đổi đã chuẩn hoá.
  • Cập nhật phiên bản tối thiểu bắt buộc của SDK quảng cáo trên thiết bị di động của Google lên phiên bản 20.1.0.

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

Phiên bản 2.0.22.1

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

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

Phiên bản 2.0.22.0

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

Phiên bản 2.0.21.0

  • Khả năng tương thích đã được xác minh với SDK i-mobile v2.0.21.
  • Cập nhật phiên bản tối thiểu bắt buộc của SDK quảng cáo trên thiết bị di động của Google lên phiên bản 19.1.0.
  • Hỗ trợ thêm tính năng điều chỉnh tỷ lệ cho quảng cáo biểu ngữ thích ứng.

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

Phiên bản 2.0.20.2

  • Hỗ trợ thêm các kích thước quảng cáo biểu ngữ linh hoạt.
  • Cập nhật phiên bản tối thiểu bắt buộc của SDK quảng cáo trên thiết bị di động của Google lên phiên bản 18.3.0.

Được tạo 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.
  • SDK dành cho thiết bị di động 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 khác 0 mediaContent.

Được tạo 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.
  • SDK dành cho thiết bị di động 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.