Kiểm tra đối tượng tuỳ chỉnh trên dòng lệnh

Protected Audience cung cấp một loạt API để tham gia 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 các đối tượng tuỳ chỉnh đã kết hợp.

Thiết lập

Vì lý do bảo mật và quyền riêng tư, theo mặc định, đối tượng tuỳ chỉnh sẽ không hiển thị và chỉ có thể được kiểm tra trực tiếp cho mục đích gỡ lỗi. Bạn chỉ có thể thấy các tệp này bằng những lệnh này nếu đáp ứng các yêu cầu sau:

• Đã bật các 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 kết hợp (bằng cách sử dụng joinCustomAudience hoặc fetchAndJoinCustomAudience)
• Đã bật chế độ cài đặt về sự đồng ý đối với quảng cáo do ứng dụng đề xuất

Bật các lệnh shell của dịch vụ quảng cáo

1. Khởi động lại thiết bị để kết thúc quy trình adservices.
2. Xác nhận rằng adservices không chạy. Bạn nên nhận được đầu ra 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 tuỳ chỉnh

Để xem một đối tượng tuỳ chỉnh cụ thể, hãy chạy lệnh sau đây, trong đó chỉ định owner là gói đã tạo đối tượng và buyer là 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>

Đầ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 đầu ra của lệnh đối tượng tuỳ chỉnh theo lượt xem đượ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 đây, trong đó chỉ định owner là gói đã tạo đối tượng, buyer là giá trị nhận dạng cho mạng quảng cáo quản lý đối tượng và name là 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 trình kích hoạt theo cách thủ công cho một đối tượng tuỳ chỉnh cụ thể, hãy chạy lệnh sau đây, trong đó chỉ định owner là gói đã tạo đối tượng, buyer là giá trị nhận dạng cho mạng quảng cáo quản lý đối tượng và name là 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.