Protected Audience cung cấp một loạt API để kết hợp và rời khỏi đối tượng tuỳ chỉnh trong gói android.adservices.customaudience. Để gỡ lỗi, bạn có thể dùng các lệnh CLI để liệt kê và xem đối tượng tuỳ chỉnh. Hướng dẫn này trình bày các bước mà nhà phát triển công nghệ quảng cáo cần thực hiện để kiểm tra trạng thái của đối tượng tuỳ chỉnh đã tham gia.
Thiết lập
Vì lý do bảo mật và quyền riêng tư, các đối tượng tuỳ chỉnh không hiển thị theo mặc định và chỉ có thể kiểm tra trực tiếp cho mục đích gỡ lỗi. Các lệnh này chỉ hiển thị bằng các lệnh này nếu đáp ứng các yêu cầu sau:
- Đã bật tuỳ chọn cho nhà phát triển trên toàn hệ thống
android:debuggable="true"
được khai báo trong tệp AndroidManifest.xml của ứng dụng màCustomAudience
được liên kết (sử dụngjoinCustomAudience
hoặcfetchAndJoinCustomAudience
)- Chế độ đồng ý đối với quảng cáo do ứng dụng gợi ý đang bật
Bật các lệnh shell của dịch vụ quảng cáo
- Khởi động lại thiết bị để chấm dứt quá trình
adservices
. - Xác nhận
adservices
hiện không chạy. Kết quả đầu ra dự kiến sẽ trống cho lệnh sau.
adb shell ps -A | grep adservices
Sau đó, để bật các lệnh shell adservices
, hãy chạy các lệnh sau:
adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true
Liệt kê đối tượng tùy chỉnh
Để xem một đối tượng tuỳ chỉnh cụ thể, hãy chạy lệnh sau chỉ định owner
làm gói đã tạo đối tượng và buyer
làm giá trị nhận dạng cho mạng quảng cáo quản lý đối tượng:
adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>
Dữ liệu đầu ra sẽ là một đối tượng JSON chứa một mảng custom_audiences
.
Cấu trúc của các phần tử trong mảng này khớp với kết quả của lệnh đối tượng tuỳ chỉnh của khung hiển thị được mô tả tiếp theo.
Xem một đối tượng tuỳ chỉnh cụ thể
Để xem một đối tượng tuỳ chỉnh cụ thể, hãy chạy lệnh sau chỉ định owner
làm gói đã tạo đối tượng, buyer
làm giá trị nhận dạng cho mạng quảng cáo quản lý đối tượng và name
làm tên của đối tượng:
adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>
Làm mới một đối tượng tuỳ chỉnh cụ thể
Để xem nội dung cập nhật hằng ngày của điều kiện kích hoạt cho một đối tượng tuỳ chỉnh cụ thể, hãy chạy lệnh sau đây, chỉ định owner
làm gói đã tạo đối tượng, buyer
làm giá trị nhận dạng cho mạng quảng cáo quản lý đối tượng và name
làm tên của đối tượng:
adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.