Attribution-Reporting-Register-Trigger header

Cú pháp

Attribution-Reporting-Register-Trigger: <json-string>

Chỉ thị

<json-string>

Chuỗi JSON cung cấp dữ liệu có thể được đưa vào các báo cáo được tạo, chẳng hạn như ID của trigger, và các giá trị ưu tiên và loại bỏ trùng lặp. Các trường có sẵn như sau:

"aggregatable_trigger_data"

Mảng các đối tượng, mỗi đối tượng xác định một khóa tổng hợp để áp dụng cho các khóa nguồn khác nhau. Mỗi đối tượng chứa các thuộc tính sau:

"key_piece"

Giá trị thập lục phân đại diện cho một khóa.

"source_keys"

Mảng chứa một hoặc nhiều giá trị khóa cho dữ liệu.

"aggregatable_values"

Đối tượng chứa các thuộc tính đại diện cho giá trị cho mỗi điểm dữ liệu được xác định trong "aggregatable_trigger_data". Trong mỗi trường hợp, tên thuộc tính bằng tên được xác định trong "source_keys", và giá trị thuộc tính là bất kỳ giá trị tùy ý nào bạn yêu cầu.

"debug_key" Optional

Số đại diện cho khóa gỡ lỗi. Đặt giá trị này nếu bạn muốn tạo báo cáo gỡ lỗi cùng với báo cáo phân bổ liên quan.

"debug_reporting" Optional

Giá trị boolean. Nếu debug_key được đặt, đặt giá trị này thành true để chỉ định rằng báo cáo gỡ lỗi được tạo ra nên là báo cáo gỡ lỗi chi tiết.

"filters" Optional

Đối tượng chứa dữ liệu tùy chỉnh có thể được sử dụng để lọc trigger nào tạo ra báo cáo. Xem Filters để biết thêm chi tiết.

"event_trigger_data"

Đối tượng đại diện cho dữ liệu về trigger. Các trường con có sẵn như sau:

"trigger_data"

Chuỗi đại diện cho dữ liệu mô tả trigger, thường được sử dụng để chỉ ra các sự kiện như "người dùng thêm mặt hàng vào giỏ hàng" hoặc "người dùng đăng ký danh sách gửi thư". Giá trị này sẽ được đưa vào báo cáo cấp sự kiện được tạo ra, nếu có, mặc dù nó sẽ bị sửa đổi dựa trên trường "trigger_data_matching" của nguồn được phân bổ.

Note: Các giá trị được sử dụng để đại diện cho mỗi sự kiện và số lượng phần tử trong mảng là hoàn toàn tùy ý và do bạn là nhà phát triển xác định. Mảng có thể chứa các giá trị không được sử dụng, nhưng các giá trị phải có mặt trong mảng để được trình duyệt phân bổ cho nguồn khi một trigger được đăng ký.

"priority" Optional

Chuỗi đại diện cho giá trị ưu tiên cho trigger phân bổ. Theo mặc định, trigger được phân bổ cho nguồn khớp gần đây nhất. Đối với cả báo cáo cấp sự kiện và báo cáo tóm tắt, bạn đặt số ưu tiên cao hơn để khiến trigger khớp với các nguồn cũ hơn. Ví dụ, giá trị 2 có ưu tiên hơn giá trị mặc định là 1. Xem Ưu tiên và giới hạn báo cáo để biết thêm thông tin.

"deduplication_key" Optional

Chuỗi đại diện cho một khóa duy nhất có thể được sử dụng để ngăn chặn các phân bổ bị trùng lặp — ví dụ nếu người dùng thêm cùng một mặt hàng vào giỏ hàng nhiều lần. Xem Ngăn chặn trùng lặp trong báo cáo để biết thêm thông tin.

"filters" Optional

Đối tượng chứa các bộ lọc thực hiện lọc có chọn lọc để đặt "trigger_data", "priority" và "deduplication_key" dựa trên filter_data được đặt trong tiêu đề Attribution-Reporting-Register-Source tương ứng. Xem Filters để biết thêm thông tin.

Ví dụ

Đăng ký trigger cho báo cáo cấp sự kiện

Máy chủ Node.js có thể đặt tiêu đề phản hồi Attribution-Reporting-Register-Trigger như sau để đăng ký trigger nhằm khớp với nguồn phân bổ báo cáo cấp sự kiện:

res.set(
  "Attribution-Reporting-Register-Trigger",
  JSON.stringify({
    event_trigger_data: [
      {
        trigger_data: "4",
        priority: "1000000000000",
        deduplication_key: "2345698765",
      },
    ],
    debug_key: "1115698977",
  }),
);

Đăng ký trigger cho báo cáo tóm tắt

Khi đăng ký trigger nhằm khớp với nguồn phân bổ báo cáo tóm tắt, bạn cần bao gồm các trường sau:

res.set(
  "Attribution-Reporting-Register-Trigger",
  JSON.stringify({
    aggregatable_trigger_data: [
      {
        key_piece: "0x400",
        source_keys: ["campaignCounts"],
      },
      {
        key_piece: "0xA80",
        source_keys: ["geoValue", "nonMatchingKeyIdsAreIgnored"],
      },
    ],
    aggregatable_values: {
      campaignCounts: 32768,
      geoValue: 1664,
    },
    debug_key: "1115698977",
  }),
);

Thông số kỹ thuật

Khả năng tương thích trình duyệt

Xem thêm

• Attribution-Reporting-Eligible
• Attribution-Reporting-Register-Source
• Attribution Reporting API