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 để kết hợp và rời khỏi các tuỳ chỉnh đối tượng như một phần của gói android.adservices.customaudience. Cho cho mục đích gỡ lỗi, có 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 làm theo để 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. Chúng chỉ hiển thị bằng các lệnh này nếu các yêu cầu sau đây đều đáp ứng:

  • Đã 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à từ đó CustomAudience được liên kết (sử dụng joinCustomAudience hoặc fetchAndJoinCustomAudience)
  • 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

  1. Khởi động lại thiết bị để chấm dứt quá trình adservices.
  2. Xác nhận adservices hiện không chạy. Dữ liệu đầu ra dự kiến sẽ không có dữ liệu sau đây.
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à gói tạo đối tượng và buyer là giá trị nhận dạng của 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 khung hiển thị lệnh đối tượng tuỳ chỉnh sẽ được mô tả trong phần 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à 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 đóng vai trò 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 bản cập nhật hằng ngày của điều kiện 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 hàm lệnh sau đây chỉ định owner làm gói đã tạo thì buyer là giá trị nhận dạng cho mạng quảng cáo quản lý 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.