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

Công cụ kiểm tra quảng cáo là một lớp phủ trong ứng dụng cho phép những thiết bị được uỷ quyền tiến hành phân tích theo thời gian thực các yêu cầu quảng cáo thử nghiệm ngay trong ứng dụng di động. Bạn có thể bật tính năng này mà không cần lập trình.

Khi sử dụng công cụ kiểm tra quảng cáo, bạn có thể:

  • Kiểm tra đơn vị quảng cáo của bạn
  • 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 chi tiết về từng mạng quảng cáo Đặt giá thầu mở theo mỗi yêu cầu
  • 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 kiểu thác nước hoặc Đặt giá thầu mở 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 Đặt giá thầu mở và quy trình 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 trong công cụ kiểm tra quảng cáo.

Đ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 trình bổ trợ Unity Quảng cáo trên thiết bị di động phiên bản 7.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 nút khởi chạy từ trình đơn gỡ lỗi.
  2. Sử dụng thao tác mà bạn đã chọn trong phần cài đặt công cụ kiểm tra quảng cáo.
  3. Theo phương thức lập trình bằng cách sử dụng API được cung cấp.

Khởi chạy bằng trình đơn gỡ lỗi

Bạn không cần thay đổi ứng dụng của mình để chạy công cụ kiểm tra quảng cáo thông qua trình đơn gỡ lỗi; bạn chỉ cần tìm một quảng cáo do mạng Ad Manager phân phát rồi chạm và giữ quảng cáo bằng hai ngón tay để mở trình đơn gỡ lỗi. Sau đó, hãy chọn Mở công cụ kiểm tra quảng cáo.

Bạn cũng có thể chọn Cài đặt công cụ kiểm tra quảng cáo trong phần cài đặt gỡ lỗi, rồi chọn một thao tác có thể mở công cụ kiểm tra quảng cáo trong tương lai mà không cần dùng trình đơn gỡ lỗi.

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:

public void OnButtonClick() {
  MobileAds.OpenAdInspector(error => {
    // Error will be set if there was an issue and the inspector was not displayed.
  });
}

API này hoạt động trên những thiết bị thử nghiệm được đăng ký theo phương thức lập trình.

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

Sau khi bạn chạy công cụ kiểm tra quảng cáo, 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 đơn vị quảng cáo thiết bị đã thực hiện các yêu cầu quảng cáo kể từ khi công cụ kiểm tra quảng cáo được bật trong phiên ứng dụng này. Danh sách này cũng chứa những đơn vị quảng cáo đã bật tính năng Đặt giá thầu mở, sắp xếp theo thứ tự thời gian với các yêu cầu được hoàn thành nhiều nhất trước và những đơn vị quảng cáo không có yêu cầu quảng cáo nào được hoàn thành (bị làm mờ):

Bạn nên khởi chạy SDK quảng cáo trên thiết bị di động của Google 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

Hãy nhấn vào một đơn vị quảng cáo để xem nhật ký yêu cầu SDK. Nhật ký này cung cấp thông tin chi tiết về quy trình 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 đến thời điểm thác nước kết thúc mà không thực hiện quảng cáo) đối với những 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 những 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

Nếu bạn mới sử dụng tính năng Đặt giá thầu mở, hãy đọc bài viết Giới thiệu về tính năng Đặt giá thầu mở.

Trong nhật ký yêu cầu SDK, bạn có thể thấy 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 để đưa các mục có thể xử lý lên 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 đề ở cuối phần bidding Câu hỏi thường gặp.

  • 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. Đây có thể là một chỉ báo về nhiều vấn đề với nguồn quảng cáo vì nguồn quảng cáo đó có thể đã không đặt giá thầu do chế độ thiết lập hoặc việc đưa ra quyết định. Bạn có thể tham khảo hướng dẫn thiết lập của nguồn quảng cáo hoặc Các câu hỏi thường gặp về tính năng Đặt giá thầu mở để được hỗ trợ thêm.

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

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

Quy trình dàn xếp kiểu thác nước là kết quả của việc nhiều nhóm lợi nhuận cạnh tranh cho cùng một khoảng không quảng cáo. Bạn có thể thêm tối đa 10 đối tác lợi nhuận bên thứ ba vào một nhóm lợi nhuận, bao gồm cả đối tác lợi nhuận Đặt giá thầu mở và tính năng dàn xếp cho đối tác lợi nhuận trên ứng dụng dành cho thiết bị di động.

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 vị trí lỗi hoặc chia sẻ với Nhóm hỗ trợ Google để hỗ trợ gỡ lỗi. Nhấn vào biểu tượng trình đơn ở đầu chuỗi thác nước rồi chọn Chia sẻ yêu cầu và phản hồi quảng cáo để xuất toàn bộ yêu cầu và phản hồi quảng cáo. Điều này giúp bạn không phải chạy dấu vết mạng trên ứng dụng của riêng mình.

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 tuỳ 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 chuỗi yêu cầu. Trang này cung cấp thông tin chi tiết về các thông số đặt giá thầu của bên thứ ba có thể đang gặp vấn đề, giúp bạn gỡ lỗi ứng dụng hoặc xác thực rằng một mạng đang thu thập tín hiệu thành công.

Android
iOS

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ủa bên thứ ba được liên kết 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 bộ chuyển đổi đó. 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 các bộ chuyển đổi sự kiện tuỳ chỉnh. Sự kiện tuỳ chỉnh cho phép nhà xuất bản sử dụng các mạng quảng cáo mà Ad Managerkhông hỗ trợ. Bạn có thể phân biệt các sự kiện tuỳ chỉnh với các bộ chuyển đổi chuẩn của bên thứ ba trong danh sách bộ chuyển đổi dựa vào tên lớp riêng biệt của các sự kiện đó. Ngoài việc cung cấp thông tin về tên lớp và trạng thái, công cụ kiểm tra quảng cáo còn hiển thị các nhãn được chỉ định cho các sự kiện tuỳ chỉnh đó trong giao diện web Ad Manager .

Trong trường hợp không tìm thấy bộ chuyển đổi hoặc không khởi chạy được, hãy xem bài viết Kiểm tra quá trình phân phối quảng cáo trên ứng dụng di động để biết thêm thông tin.

Android
iOS

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 chuyển đến đơn vị đó trong giao diện người dùng của ứng dụng, thì công cụ kiểm tra quảng cáo sẽ hỗ trợ việc này ngay trên màn hình 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 và xem không đồng bộ các yêu cầu quảng cáo thử nghiệm và thậm chí là thực hiện thử nghiệm riêng 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 mục này là một công cụ tuyệt vời để xác minh trải nghiệm quảng cáo cơ bản và để xác thực cấu hình dàn xếp khi được 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 ở đầ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. Sau đó, kết quả kiểm thử sẽ xuất hiện trong nhật ký yêu cầu SDK bên dưới tiêu đề Requested from ad Inspector (Yêu cầu từ 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 của bạn

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 nguồn quảng cáo bidding hoặc dàn xếp kiểu thác nước. Điều này giúp bạn xác minh rằng bạn đã triển khai đúng cách bộ chuyển đổi của bên thứ ba 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 bậ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 động SDK quảng cáo trên thiết bị di động của Google thì mới có thể sử dụng 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 bạn chọn một nguồn quảng cáo, màn hình sau sẽ 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 trong tương lai mà bạn thực hiện trong cùng một phiên. Tuy nhiên, quy tắc này không áp dụng cho bất kỳ quảng cáo nào trước đây đã lưu vào bộ nhớ đệm trong phiên hoạt động 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 vì nguồn quảng cáo nhận được 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ẽ chỉ cố hiển thị quảng cáo từ mạng đã chọn. Việc khởi chạy công cụ kiểm tra quảng cáo khi một thử nghiệm nguồn quảng cáo đang hoạt động sẽ cho thấy nguồn quảng cáo thử nghiệm đang hoạt động:

Ở chế độ thử nghiệm riêng một nguồn quảng cáo, tất cả yêu cầu quảng cáo đều cố gắng thực hiện bằng nguồn quảng cáo đã chọn, bất kể nguồn quảng cáo đó có được định cấu hình để đặt giá thầu hoặc dàn xếp cho đơn vị quảng cáo được yêu cầu hay không. Nếu nguồn quảng cáo mà bạn đang thử nghiệm không có 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ẽ nhận được thông báo lỗ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 khi bạn bật tính năng thử nghiệm riêng một nguồn quảng cáo hay không. 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 đó.

Nếu đã thêm nhiều phiên bản của nguồn quảng cáo đã chọn vào một thác nước dàn xếp, 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 một 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 thử nghiệm để 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 một chuỗi JSON chứa toàn bộ đầu ra gỡ lỗi từ công cụ này, bao gồm cả thông tin chi tiết về ứng dụng Ad Manager của bạn, trạng thái khởi chạy bộ chuyển đổi và kết quả thử nghiệm của tất cả các đơn vị quảng cáo.

Để thực hiện việc nà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 Đã sao chép JSON của công cụ kiểm tra quảng cáo vào bảng nhớ tạm.