Công cụ kiểm tra quảng cáo

Công cụ kiểm tra quảng cáo là lớp phủ trong ứng dụng cho phép các thiết bị được uỷ quyền thực hiện theo thời gian thực bạn có thể phân tích các yêu cầu quảng cáo thử nghiệm ngay trong ứng dụng dành cho thiết bị di động. Có sẵn trong phiên bản SDK Quảng cáo của Google trên thiết bị di động 20.0.0 trở lên và có thể bật mà không cần lập trình là bắt buộc.

Sử dụng công cụ kiểm tra quảng cáo trong phiên bản SDK Quảng cáo trên thiết bị di động thấp hơn 20.2.0, bạn có thể:

  • Kiểm tra đơn vị quảng cáo của bạn
  • Kiểm tra bộ chuyển đổi của bên thứ ba
  • Kiểm tra xem quảng cáo của bạn có được thực hiện như dự kiến không
  • Xác định lỗi và xem thông tin chi tiết về cách khắc phục
  • Xem thông tin về quy trình dàn xếp cho từng mạng quảng cáo đối với mỗi yêu cầu
  • Thử nghiệm từng nguồn quảng cáo dàn xếp của bên thứ ba
  • Xác minh rằng bạn đã định cấu hình đúng cách từng đơn vị quảng cáo cho tính năng dàn xếp kiểu thác nước
  • Thử nghiệm chế độ tích hợp sự kiện tuỳ chỉnh

Đối với SDK quảng cáo trên thiết bị di động phiên bản 20.2.0 trở lên, bạn cũng có thể:

  • Xem thông tin đặt giá thầu cho từng mạng quảng cáo đối với mỗi yêu cầu
  • Xem thông tin chi tiết về quy trình đặt giá thầu và quy trình dàn xếp kiểu thác nước cho mỗi quảng cáo mạng cho mỗi yêu cầu
  • Thử nghiệm từng nguồn quảng cáo dàn xếp kiểu thác nước hoặc đặt giá thầu của bên thứ ba
  • Xác minh rằng bạn đã định cấu hình chính xác từng đơn vị quảng cáo cho tính năng đặt giá thầu và dàn xếp kiểu thác nước

Hướng dẫn này trình bày cách khởi chạy và sử dụng các tính năng khác nhau trong quảng cáo Trình kiểm tra.

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

Để sử dụng công cụ kiểm tra quảng cáo, bạn cần phải:

  • Sử dụng SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.0.0 trở lên.

Khởi chạy công cụ kiểm tra quảng cáo

Bạn có thể khởi chạy công cụ kiểm tra quảng cáo từ bất kỳ vị trí nào trong ứng dụng của mình theo các cách sau:

  1. Sử dụng cử chỉ đã chọn trong giao diện người dùng AdMob khi đăng ký thiết bị thử nghiệm.
  2. Theo phương thức lập trình bằng cách sử dụng API được cung cấp.
  3. Sử dụng nút khởi chạy từ trình đơn gỡ lỗi.

Khởi chạy bằng cử chỉ

Bạn không cần thực hiện thay đổi nào đối với ứng dụng của mình để khởi chạy công cụ kiểm tra quảng cáo chỉ bằng một thao tác; chỉ thực hiện cử chỉ (xoay cổ tay hoặc lắc hai lần) mà bạn đã thiết lập trong AdMob cho thiết bị thử nghiệm đó. Tìm hiểu thêm

Sau khi thiết lập một cử chỉ trong giao diện người dùng AdMob (và đợi 15 phút để thao tác này tuyên bố), ứng dụng của bạn cần tạo yêu cầu quảng cáo cho Quảng cáo trên thiết bị di động của Google SDK để tìm hiểu về chế độ cài đặt cử chỉ. Nếu cử chỉ bạn đã chỉ định không phải là đang hoạt động, hãy thử tải một quảng cáo, khởi động lại ứng dụng rồi thử nghiệm lại cử chỉ.

Khởi chạy theo phương thức lập trình

Bạn cũng có thể khởi chạy công cụ kiểm tra quảng cáo theo phương thức lập trình:

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

API này dùng được cho các thiết bị thử nghiệm đã đăng ký theo phương thức lập trình hoặc trong giao diện người dùng AdMob.

Xem và khắc phục sự cố với đơn vị quảng cáo

Sau khi chạy, màn hình chính của công cụ kiểm tra quảng cáo sẽ xuất hiện, chứa danh sách tất cả các quảng cáo đơn vị trong giao diện người dùng AdMob được liên kết với mã ứng dụng AdMob có tính năng đặt giá thầu hoặc dàn xếp cấu hình:

Bạn nên khởi chạy Quảng cáo trên thiết bị di động của Google SDK trước khi sử dụng công cụ kiểm tra quảng cáo.

Xem thông tin về quy trình dàn xếp kiểu thác nước cho một đơn vị quảng cáo

Nhấn vào một đơn vị quảng cáo để xem nhật ký yêu cầu SDK của đơn vị quảng cáo đó. Nhật ký này cung cấp thông tin chi tiết về dàn xếp kiểu thác nước cho đến thời điểm quảng cáo được thực hiện (hoặc thác nước kết thúc mà không thực hiện) cho các yêu cầu quảng cáo mới nhất.

Bạn có thể mở rộng từng yêu cầu bằng cách sử dụng chỉ báo thông tin công bố để hiển thị kết quả của quy trình dàn xếp kiểu thác nước cho yêu cầu đó, cùng với mọi lỗi và độ trễ có thể áp dụng cho yêu cầu đó.

Đối với các nguồn quảng cáo của bên thứ ba, thông báo lỗi được gửi trực tiếp từ nguồn quảng cáo. Nếu bạn cần thêm thông tin, hãy tham khảo nguồn quảng cáo của bên thứ ba.

Xem thông tin đặt giá thầu cho một đơn vị quảng cáo

Điều kiện tiên quyết: SDK Quảng cáo của Google trên thiết bị di động 20.2.0 hoặc cao hơn

Nếu bạn mới sử dụng tính năng đặt giá thầu, hãy đọc Overview (Tổng quan).

Trong nhật ký yêu cầu SDK, bạn có thể xem bidding các nguồn quảng cáo được gọi trong yêu cầu quảng cáo. Nhấn vào một đơn vị quảng cáo trong nhật ký yêu cầu SDK để xem thông tin chi tiết về từng nguồn quảng cáo trong bidding phiên đấu giá.

Kết quả bidding được sắp xếp để mang lại các mục có thể hành động ở gần đầu danh sách:

  • Ở trên cùng là mạng quảng cáo đã thắng phiên đấu giá.

  • Tiếp theo là những mạng quảng cáo có vấn đề. Bạn có thể làm theo các bước khắc phục vấn đề.

  • Tiếp đến là những mạng quảng cáo không có quảng cáo nào được trả về hoặc không đặt giá thầu. Chiến dịch này có thể là một chỉ báo cho thấy nhiều vấn đề về nguồn quảng cáo có thể không có giá thầu do thiết lập hoặc quyết định của chiến dịch. Bạn có thể tham khảo quảng cáo hướng dẫn thiết lập của nguồn hoặc liên hệ trực tiếp với nguồn quảng cáo cho support.

  • Cuối cùng, ở cuối danh sách là các mạng quảng cáo mất bidding phiên đấu giá.

Quy trình dàn xếp kiểu thác nước có thể đặt nguồn quảng cáo giành được bidding phiên đấu giá theo giá trị eCPM.

Khi được gọi trong quy trình dàn xếp kiểu thác nước, một nguồn quảng cáo có thể phân phát quảng cáo. Để tìm hiểu thêm về cách hoạt động của tính năng đặt giá thầu thông qua quy trình dàn xếp kiểu thác nước, hãy xem ví dụ 2ví dụ 3 về chiến lược đặt giá thầu và nguồn quảng cáo dạng thác nước trong một nhóm dàn xếp.

Gỡ lỗi đơn vị quảng cáo nâng cao

Khi khắc phục sự cố về đơn vị quảng cáo, bạn nên xem xét kỹ yêu cầu quảng cáo đó và phản hồi để xác định lỗi hoặc để chia sẻ với Google Hỗ trợ gỡ lỗi. Nhấn vào biểu tượng trình đơn ở đầu thác nước rồi chọn Chia sẻ yêu cầu quảng cáo và phản hồi để xuất toàn bộ yêu cầu quảng cáo và phản hồi. Điều này giúp bạn tiết kiệm công sức khi phải chạy dấu vết mạng trên ứng dụng của riêng bạn.

Ngoài ra, bạn có thể xem các thông số đặt giá thầu đã được giải mã của bên thứ ba bằng cách nhấn vào lựa chọn Thông số đặt giá thầu của bên thứ ba trên cùng một trình đơn với yêu cầu . Mục này cung cấp thông tin chi tiết về những thông số đặt giá thầu của bên thứ ba có thể gặp sự cố, giúp bạn gỡ lỗi ứng dụng hoặc xác thực rằng mạng đang thu thập thành công tín hiệu của mạng di động.

Xem các bộ chuyển đổi có sẵn

Nhấp vào thẻ Bộ chuyển đổi để xem danh sách tất cả các bộ chuyển đổi được liên kết của bên thứ ba với các nguồn quảng cáo trong cấu hình đặt giá thầu hoặc dàn xếp trong ứng dụng của bạn. Sau đó, hãy mở rộng các thẻ để xem trạng thái khởi chạy và phiên bản SDK của các thẻ đó. Cùng với các bộ chuyển đổi được hỗ trợ của bên thứ ba, bạn cũng có thể xem sự kiện tuỳ chỉnh bộ chuyển đổi. Sự kiện tuỳ chỉnh cho phép nhà xuất bản sử dụng mạng quảng cáo AdMob không hỗ trợ. Sự kiện tuỳ chỉnh khác với sự kiện chuẩn của bên thứ ba bộ chuyển đổi trong danh sách bộ chuyển đổi theo tên lớp duy nhất của chúng. Ngoài cung cấp tên lớp và thông tin trạng thái, công cụ kiểm tra quảng cáo cũng hiển thị được gán cho các sự kiện tùy chỉnh đó trong AdMob giao diện web.

Trong trường hợp không tìm thấy bộ chuyển đổi hoặc bộ chuyển đổi không khởi chạy được, hãy xem Khắc phục các vấn đề phát hiện được khi sử dụng công cụ kiểm tra quảng cáo để biết thêm thông tin.

Thử nghiệm đơn vị quảng cáo của bạn

Nếu bạn muốn thử nghiệm đơn vị quảng cáo của mình mà không phải điều hướng đến đơn vị quảng cáo đó trong trên giao diện người dùng của ứng dụng, công cụ kiểm tra quảng cáo sẽ hỗ trợ việc này ngay từ màn hình thông tin chi tiết về đơn vị quảng cáo. Ngoài ra, bạn có thể thử nghiệm nhiều đơn vị quảng cáo cùng một lúc, tải không đồng bộ và xem các yêu cầu quảng cáo thử nghiệm, cũng như thậm chí thực hiện các thử nghiệm với một nguồn quảng cáo.

Thử nghiệm quảng cáo

Các thử nghiệm quảng cáo của công cụ kiểm tra quảng cáo được nêu trong phần này là một công cụ hữu hiệu để xác minh trải nghiệm quảng cáo cơ bản và để xác thực tính năng dàn xếp khi được sử dụng cùng với thử nghiệm riêng một nguồn quảng cáo.

Khi bạn đã sẵn sàng thử nghiệm đơn vị quảng cáo, hãy nhấn vào nút Yêu cầu quảng cáo thử nghiệm trên đầu màn hình công cụ kiểm tra quảng cáo để kích hoạt thử nghiệm quảng cáo của công cụ kiểm tra quảng cáo. Thử nghiệm kết quả thì xuất hiện trong nhật ký yêu cầu SDK bên dưới tiêu đề Được yêu cầu thông qua công cụ kiểm tra quảng cáo.

Tìm hiểu cách sử dụng công cụ kiểm tra quảng cáo trong ứng dụng

Thử nghiệm một nguồn quảng cáo

Công cụ kiểm tra quảng cáo có tính năng hạn chế các yêu cầu quảng cáo trong ứng dụng của bạn chỉ phân phát quảng cáo từ một quảng cáo dàn xếp bidding hoặc thác nước nguồn. Điều này cho phép bạn xác minh rằng bạn đã triển khai bên thứ ba một cách chính xác bộ chuyển đổi và nguồn quảng cáo đang phân phát như mong đợi.

Để bật tính năng này, hãy gạt nút chuyển Thử nghiệm một nguồn quảng cáo ở cuối màn hình. Thao tác này sẽ hiển thị hộp thoại lựa chọn nguồn quảng cáo sau đây:

Bạn phải khởi chạy Quảng cáo trên thiết bị di động của Google SDK trước khi có thể thử nghiệm riêng một nguồn quảng cáo.

Sau đó, bạn có thể chọn một nguồn quảng cáo duy nhất để thử nghiệm. Sau khi chọn một nguồn quảng cáo, màn hình sau đây xuất hiện:

Chế độ cài đặt thử nghiệm một nguồn quảng cáo sẽ áp dụng cho mọi yêu cầu quảng cáo mà bạn thực hiện trong tương lai phiên hoạt động đó. Tuy nhiên, chính sách này không áp dụng cho bất kỳ quảng cáo nào được lưu vào bộ nhớ đệm trước đây ở mà chưa được hiển thị. Bạn nên buộc khởi động lại ứng dụng khi áp dụng thử nghiệm riêng một nguồn quảng cáo để vô hiệu hoá mọi quảng cáo được lưu vào bộ nhớ đệm có thể được phân phát thay cho nguồn quảng cáo nhận yêu cầu mà bạn đã chọn.

Sau khi khởi động lại ứng dụng, tất cả các vị trí đơn vị quảng cáo sẽ cố hiển thị quảng cáo từ chỉ mạng đã chọn. Khởi chạy công cụ kiểm tra quảng cáo khi thử nghiệm riêng một nguồn quảng cáo đang hoạt động cho biết nguồn quảng cáo thử nghiệm đang hoạt động:

Ở chế độ thử nghiệm một nguồn quảng cáo, tất cả các yêu cầu quảng cáo đều cố gắng thực hiện bằng những quảng cáo đã chọn nguồn quảng cáo, bất kể nguồn quảng cáo đó đã được định cấu hình để đặt giá thầu hay cho đơn vị quảng cáo được yêu cầu. Nếu nguồn quảng cáo mà bạn đang thử nghiệm không nằm trong quy trình dàn xếp kiểu thác nước cho một đơn vị quảng cáo, thì bạn sẽ thấy trạng thái "Không thực hiện" .

Khi thử nghiệm riêng một nguồn quảng cáo, bạn có thể nhấn vào một đơn vị quảng cáo để xem nhật ký yêu cầu SDK của đơn vị quảng cáo đó. Điều này cho bạn biết liệu nguồn quảng cáo có thực hiện các yêu cầu quảng cáo được đưa ra sau đó hay không bạn đã bật tính năng thử nghiệm riêng một nguồn quảng cáo. Nếu nguồn quảng cáo không thể tải quảng cáo, một thông báo lỗi sẽ xuất hiện mô tả lỗi đó.

Trường hợp bạn đã thêm nhiều phiên bản của nguồn quảng cáo đã chọn vào một quy trình dàn xếp thác nước, bạn sẽ thấy từng phiên bản của lệnh gọi đến nguồn quảng cáo trong thác nước cho đến khi quảng cáo được thực hiện hoặc cho đến khi thác nước kết thúc mà không thực hiện quảng cáo.

Dừng thử nghiệm riêng một nguồn quảng cáo

Để dừng thử nghiệm, hãy tắt nút chuyển:

Sau đó, một thông báo xác nhận sẽ xuất hiện trên màn hình khởi động lại sau đây:

Bạn nên buộc ứng dụng khởi động lại sau khi dừng kiểm thử để vô hiệu hoá mọi quảng cáo được lưu vào bộ nhớ đệm đối với nguồn quảng cáo đã được thử nghiệm.

Sao chép toàn bộ kết quả gỡ lỗi

Công cụ kiểm tra quảng cáo hỗ trợ sao chép chuỗi JSON chứa toàn bộ quy trình gỡ lỗi kết quả đầu ra từ công cụ, bao gồm cả thông tin chi tiết về AdMob ứng dụng, trạng thái khởi chạy bộ chuyển đổi và kết quả thử nghiệm của tất cả đơn vị quảng cáo.

Để làm như vậy, hãy nhấn 7 lần vào biểu tượng ứng dụng cho đến khi bạn thấy thông báo Quảng cáo đã sao chép JSON của trình kiểm tra vào bảng nhớ tạm.