Bộ thử nghiệm dàn xếp

Bộ thử nghiệm dàn xếp AdMob cho phép bạn kiểm tra xem bạn đã định cấu hình chính xác ứng dụng và đơn vị quảng cáo để có thể hiển thị quảng cáo từ các mạng bên thứ ba thông qua nền tảng dàn xếp AdMob hay chưa.

Hướng dẫn này trình bày cách sử dụng Bộ thử nghiệm dàn xếp AdMob trong ứng dụng Android. Bước đầu tiên là tích hợp công cụ này vào ứng dụng của bạn.

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

  • SDK Android 4.1 (API cấp 16) trở lên.

  • Các dịch vụ của Google Play phiên bản 9.8.0 trở lên.

Cài đặt

Sử dụng Gradle

Sao chép các phần phụ thuộc bắt buộc sau vào tệp build.gradle của ứng dụng:

dependencies {
    // You should already have the ads dependency in your app.
    implementation 'com.google.android.gms:play-services-ads:19.3.0'
    implementation 'com.google.android.ads:mediation-test-suite:1.4.0'
}

Bao gồm kho lưu trữ google() trong tệp build.gradle cấp cao nhất của bạn:

// Top-level build file where you can add configuration options common to all
// sub-projects/modules.

buildscript {

   repositories {
       google()
       jcenter()
   }
   dependencies {
       classpath 'com.android.tools.build:gradle:3.2.1'

       // NOTE: Do not place your application dependencies here; they belong
       // in the individual module build.gradle files
   }
}

allprojects {
   repositories {
       google()
       jcenter()
   }
}

Khởi chạy Bộ thử nghiệm dàn xếp

Sử dụng dòng mã sau đây để khởi chạy Bộ thử nghiệm dàn xếp:

MediationTestSuite.launch(MainActivity.this);

Xin lưu ý rằng bạn phải nhập chính xác mã ứng dụng AdMob trong AndroidManifest.xml của mình.

Công cụ này sẽ mở ra kèm theo lời tuyên bố từ chối trách nhiệm sau:

Đánh dấu vào hộp và nhấn vào Đồng ý để tiếp tục.

Sau đó, bạn sẽ nhìn thấy một danh sách đơn vị quảng cáo cho tài khoản của mình. Danh sách này được chia thành 2 thẻ: Đơn vị quảng cáo không hoạt độngĐơn vị quảng cáo đang hoạt động.

Danh sách Đơn vị quảng cáo không hoạt động được tách thành Các thành phần bị thiếuCác lỗi cấu hình:

Sau khi thử nghiệm thành công tất cả các mạng của một đơn vị quảng cáo, đơn vị quảng cáo đó sẽ chuyển từ thẻ Không hoạt động sang thẻ Đang hoạt động. Nếu bạn không thấy danh sách các đơn vị quảng cáo, thì có thể là do lệnh gọi mạng không thành công hoặc không tìm thấy đơn vị quảng cáo.

Nếu bạn muốn tìm kiếm danh sách các đơn vị quảng cáo, hãy nhấn vào biểu tượng tìm kiếm ở trên cùng và nhập chuỗi mã đơn vị quảng cáo. Bạn cũng có thể tìm kiếm theo tên mạng hoặc theo định dạng quảng cáo.

Đối với mỗi đơn vị quảng cáo, màn hình này sẽ đưa ra cảnh báo nếu:

  • SDK nguồn quảng cáo chưa được cài đặt
  • Bộ chuyển đổi nguồn quảng cáo chưa được cài đặt
  • Nguồn quảng cáo yêu cầu các mục nhập tệp kê khai chưa được định cấu hình

Nếu có thể thử nghiệm, màn hình cũng hiển thị trạng thái kết quả thử nghiệm tổng thể cho tất cả các nguồn quảng cáo.

Chọn một đơn vị quảng cáo để chuyển sang màn hình Thông tin về đơn vị quảng cáo.

Thông tin về đơn vị quảng cáo

Màn hình này hiển thị thông tin chi tiết về đơn vị quảng cáo (bao gồm mã đơn vị quảng cáo và định dạng quảng cáo) và quy trình dàn xếp dạng thác nước được định cấu hình cho đơn vị quảng cáo đó:

Lưu ý các khía cạnh sau đây trên màn hình này:

Nội dung tóm tắt nguồn quảng cáo

Đối với mỗi nguồn quảng cáo, chúng tôi có các chỉ báo cho biết bạn đã cài đặt SDK và bộ chuyển đổi hay chưa, đã tìm thấy mọi mục bắt buộc của tệp kê khai hay chưa và kết quả của lần thử nghiệm gần đây nhất cho cấu hình này trong phiên hoạt động này.

Hãy lưu ý rằng các sự kiện tùy chỉnh sẽ sử dụng nhãn Sự kiện tùy chỉnh: custom event . Chỉ báo trạng thái của bộ chuyển đổi cho một sự kiện tùy chỉnh sẽ là số dương nếu hệ thống tìm thấy lớp mà bạn chỉ định cho sự kiện tùy chỉnh đó. Bạn có thể tải và xem quảng cáo cho các sự kiện tùy chỉnh theo cách tương tự như các mạng khác.

Tìm kiếm

Khi nhấn vào biểu tượng tìm kiếm, màn hình tìm kiếm sẽ hiển thị để bạn có thể tìm kiếm các nguồn quảng cáo theo tên.

Thử nghiệm theo lô

Bạn có thể chọn từng nguồn quảng cáo để thử nghiệm theo lô bằng cách đánh dấu vào hộp ở bên trái tên nguồn quảng cáo đó. Sau đó, một tùy chọn mới sẽ xuất hiện trong thanh điều hướng:

Nhấn vào nút Tải quảng cáo ở trên cùng bên phải để tải quảng cáo cho các nguồn quảng cáo đã chọn theo thứ tự. Chỉ báo tiến trình sẽ hiển thị trong thời gian diễn ra thử nghiệm. Khi bạn nhấn vào biểu tượng quay lại ở góc trên cùng bên trái, lựa chọn sẽ bị xóa.

Tải và hiển thị quảng cáo

Nhấn vào một mục nhập nguồn quảng cáo để xem màn hình thông tin chi tiết về nguồn quảng cáo đó:

Đối với một nguồn quảng cáo nhất định, màn hình sẽ cho biết:

  • SDK đã được cài đặt hay chưa và phiên bản của SDK (nếu có).
  • Bộ chuyển đổi đã được cài đặt hay chưa và phiên bản của bộ chuyển đổi (nếu có).
  • Mọi mục nhập tệp kê khai bắt buộc đều đã được định cấu hình đúng cách hay chưa.
  • Trạng thái khởi tạo bộ chuyển đổi (nếu có).
  • Các thông số cho cấu hình đã được nhập trong bảng điều khiển AdMob.

Sau khi đã cài đặt tất cả các thành phần bắt buộc, bạn có thể tiến hành thử nghiệm việc tải quảng cáo. Hãy nhấn vào Tải quảng cáo để gửi một yêu cầu quảng cáo đến SDK của nguồn quảng cáo. Sau khi hoàn tất yêu cầu quảng cáo, bạn sẽ nhìn thấy một thông báo cho biết liệu yêu cầu đã thành công hay không thành công.

Nếu yêu cầu không thành công, hãy kiểm tra thông báo từ SDK được thử nghiệm trong nhật ký bảng điều khiển.

Nếu yêu cầu thành công:

  • Đối với quảng cáo biểu ngữ, quảng cáo sẽ hiển thị nội tuyến.
  • Đối với quảng cáo xen kẽ hoặc quảng cáo có tặng thưởng, bạn có thể hiển thị quảng cáo bằng cách nhấn vào Hiển thị quảng cáo.

    Quảng cáo sẽ mở trong một màn hình mới, ví dụ:

Khi bạn quay lại màn hình Thông tin về đơn vị quảng cáo, kết quả của lần thử nghiệm quảng cáo gần đây nhất của bạn sẽ hiển thị trong màn hình danh sách đơn vị quảng cáo. Các nguồn quảng cáo đã tải thành công sẽ được chuyển đến cuối danh sách hiển thị các nguồn quảng cáo cần thử nghiệm thêm. Xin lưu ý rằng các kết quả này chỉ được lưu trữ trong suốt thời gian của phiên hoạt động này.

Cho phép thử nghiệm trong quá trình sản xuất

Theo mặc định, bộ thử nghiệm dàn xếp sẽ chỉ khởi chạy trong các bản dựng có thể gỡ lỗi . Điều này nhằm ngăn người dùng cuối vô tình khởi chạy bộ thử nghiệm.

Nếu cần chạy bộ thử nghiệm dàn xếp trên một thiết bị khi ứng dụng của bạn đang trong quá trình sản xuất, thì bạn nên đăng ký thiết bị của mình làm thiết bị thử nghiệm thông qua SDK.

Khi đưa bộ thử nghiệm dàn xếp vào trong ứng dụng đang tạo, bạn cần có một cách khởi chạy bộ thử nghiệm dàn xếp mà chỉ mình bạn biết (ví dụ: một thao tác bí mật hoặc trình đơn gỡ lỗi ẩn). Sau đó, bạn sẽ có thể khởi chạy bộ thử nghiệm trên bất kỳ thiết bị nào nằm trong danh sách cho phép của bản dựng.

Định cấu hình yêu cầu quảng cáo bằng cách sử dụng thông số bổ sung cho mạng (không bắt buộc)

Một số mạng dàn xếp nhất định (chẳng hạn như Vungle) yêu cầu hoặc có tùy chọn cung cấp gói bổ sung tùy chỉnh cho mạng để cung cấp thêm thông tin cho các yêu cầu tới mạng dàn xếp đó. Nếu cần cung cấp thông số bổ sung cho mạng để yêu cầu dàn xếp, thì bạn có thể thiết lập một yêu cầu quảng cáo để bộ thử nghiệm sử dụng bằng cách dùng phương thức tĩnhMediationTestSuite.setAdRequest():

Java

AdRequest requestBuilder = new AdRequest.Builder();
...
// Set your network extras for your chosen networks here.
// I.e., for each network extras bundle, call
// 'requestBuilder.addNetworkExtrasBundle(<network adapter class>,
// <network extras bundle>)'
...
MediationTestSuite.setAdRequest(requestBuilder.build());

Kotlin

val requestBuilder = AdRequest.Builder()
...
// Set your network extras for your chosen networks here.
// I.e., for each network extras bundle, call
// 'requestBuilder.addNetworkExtrasBundle(<network adapter class>,
// <network extras bundle>)'
...
MediationTestSuite.setAdRequest(requestBuilder.build())

Bạn hãy nhớ thực hiện thao tác này trước khi khởi chạy bộ thử nghiệm dàn xếp.

Việc này cho phép bạn nhanh chóng khởi tạo và định cấu hình một yêu cầu quảng cáo bằng cách sử dụng mọi thông số bổ sung bắt buộc, mà sau đó bộ thử nghiệm có thể sử dụng trong yêu cầu cho mạng được dàn xếp.

Câu hỏi thường gặp

Lời tuyên bố từ chối trách nhiệm có hiển thị mọi lúc không?
Có, chúng tôi cố ý thực hiện việc này để nhắc bạn nên bật chế độ thử nghiệm cho các nguồn quảng cáo dàn xếp của mình.
Tại sao tôi thấy AdMob nhiều lần trên trang Thông tin về đơn vị quảng cáo?
Nếu nhiều nhóm dàn xếp nhắm mục tiêu cùng một đơn vị quảng cáo, chúng tôi sẽ kết hợp tất cả các nhóm đó lại với nhau. Ví dụ: bạn có thể thấy nhiều mục nhập AdMob và nhiều nguồn quảng cáo khác có thể có. Ngay cả trong cùng một nhóm dàn xếp, chúng tôi có thể xác định một đối tác dàn xếp tối đa 3 lần.
Bộ thử nghiệm dàn xếp hỗ trợ các mạng/nguồn quảng cáo nào?
Bộ thử nghiệm tương thích với tất cả các bộ chuyển đổi nguồn mở với các phiên bản khác nhau cũng như các bộ chuyển đổi sự kiện tùy chỉnh. Bạn có thể xem danh sách các mạng quảng cáo trong giải pháp nguồn mở trên trang dàn xếp của chúng tôi.