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 đố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ụ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. 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.