Khi sử dụng công cụ kiểm tra quảng cáo, bạn có thể:
- Kiểm tra các đơn vị quảng cáo
- 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 các lỗi và xem thông tin về cách khắc phục các lỗi này
- Xem thông tin chi tiết về từng mạng quảng cáo đặt giá thầu 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 dạng thác nước hoặc thông tin đặ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 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:
- Xem hết Hướng dẫn bắt đầu sử dụng.
- Sử dụng dịch vụ Google SDK quảng cáo trên thiết bị di động phiên bản 8.10.0 trở lên.
- Bật thử nghiệm chế độ hoặc đường liên kết thiết bị của bạn sang Ad Manager. Công cụ kiểm tra quảng cáo chỉ khởi chạy trên các thiết bị thử nghiệm hoặc đã liên kết.
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:
- Sử dụng nút khởi chạy từ trình đơn gỡ lỗi.
- 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.
- 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 chỉnh sửa ứng dụng của mình để khởi chạy công cụ kiểm tra quảng cáo thông qua trình đơn gỡ lỗi; 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 2 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.
Nếu không liên kết thiết bị, bạn có thể phải đăng nhập vào tài khoản Ad Manager của mình.
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 và 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 phải sử dụng thông qua 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 bằng cách lập trình:
Swift
GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
// Error will be non-nil if there was an issue and the inspector was not displayed.
}
Objective-C
[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
completionHandler:^(NSError *error) {
// Error will be non-nil 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.
Đảm bảo rằng bộ điều khiển chế độ xem được chuyển đến API này đã hiển thị đầy đủ trên
màn hình (viewDidAppear: đã được gọi). Nếu bộ điều khiển chế độ xem được chuyển qua đang trong quá trình hiển thị, chẳng hạn như khi API được gọi trong hàm viewDidLoad của bộ điều khiển chế độ xem, thì bản trình bày của công cụ kiểm tra quảng cáo sẽ không chạy.
Xem và khắc phục sự cố với đơn vị quảng cáo
Sau khi công cụ kiểm tra quảng cáo chạy, màn hình chính của công cụ này sẽ xuất hiện kèm theo danh sách tất cả đơn vị quảng cáo thiết bị đã thực hiện 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 thời gian này phiên hoạt động của ứng dụng. 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, được sắp xếp theo thứ tự thời gian, trong đó các yêu cầu đã hoàn thành gần đây nhất được xếp trước, và những đơn vị quảng cáo không có yêu cầu quảng cáo nào đã hoàn thành (bị làm mờ):
Bạn nên khởi động 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 dạng 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. Nhật ký này cung cấp thông tin chi tiết về quy trình dàn xếp dạng thác nước cho đến khi quảng cáo đó được thực hiện (hoặc đến khi quy trình dàn xếp dạng thác nước kết thúc mà không thực hiện một quảng cáo) cho 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 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 đề nghị nguồn quảng cáo bên thứ ba của bạn cung cấp.
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 chiến lược đặt giá thầu, 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 những nguồn quảng cáo đặt giá thầu được gọi trong yêu cầu quảng cáo. Hãy 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 phiên đấu giá đặt giá thầu đó.
Kết quả đặt giá thầu được sắp xếp để đưa các mục có thể hành động đến gần hơn với đầu danh sách:
Mạng quảng cáo đã thắng phiên đấu giá sẽ xuất hiện ở trên cùng.
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 Câu hỏi thường gặp về hoạt động đặt giá thầu.
Sau đó, bạn sẽ thấy 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 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ở để hỗ trợ thêm.
Cuối cùng, ở cuối danh sách là những mạng quảng cáo không đặt giá thầu được 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 thắng phiên đấu giá đặt giá thầu 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 mười đố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 và tính năng dàn xếp cho thiết bị di động đối tác lợi nhuận ứng dụ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 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 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 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ả 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. Sau đó, hãy mở rộng các thẻ để xem trạng thái khởi động và phiên bản SDK của các bộ chuyển đổi đó. Ngoà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 mạng quảng cáo Ad Manager không hỗ trợ. Bạn có thể phân biệt sự kiện tuỳ chỉnh với bộ chuyển đổi chuẩn của bên thứ ba trong danh sách bộ chuyển đổi bằng tên lớp riêng biệt. Ngoài việc 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ác nhãn được chỉ định cho các sự kiện tuỳ chỉnh đó trong giao diện webAd Manager .
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 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.
Thử nghiệm đơn vị quảng cáo
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.
Thử nghiệm riêng một nguồn quảng cáo
Công cụ kiểm tra quảng cáo có một 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 đặt giá thầu hoặc dàn xếp dạng thác nước. Nhờ đó, bạn có thể xác minh rằng bạn đã triển khai đúng cách trình chuyển đổi 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 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:
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 riêng 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 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 ứng dụng phải khởi động lại khi áp dụng thử nghiệm riêng một nguồn quảng cáo để vô hiệu hoá việc phân phát bất kỳ quảng cáo nào đã được lưu vào bộ nhớ đệm 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ả vị trí đặt đơn vị quảng cáo sẽ chỉ hiển thị quảng cáo từ 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 đó. Khi xem nhật ký này, bạn có thể biết liệu nguồn quảng cáo đó có thực hiện những yêu cầu quảng cáo được gửi sau khi bạn bật chế độ 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 quy trình dàn xếp kiểu thác nước, thì 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 đến khi quy trình dàn xếp kiểu thác nước kết thúc mà không thực hiện quảng cáo.
Ngừ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
Trình 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ụ, bao gồm cả thông tin chi tiết về ứng dụngAd Manager , trạng thái khởi chạy bộ chuyển đổi và kết quả kiểm thử của tất cả cá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.