Lọc nguồn trước khi phân bổ bằng cách sử dụng phạm vi phân bổ

Phạm vi phân bổ cho phép các đối tượng gọi API chỉ định một danh sách các chuỗi trong quá trình đăng ký nguồn và trình kích hoạt. Danh sách này có thể dùng để lọc trước khi quá trình phân bổ diễn ra. Điều này cho phép lọc chi tiết hơn để tăng hiệu quả của API và mang lại tính linh hoạt cao hơn. Ví dụ: tính năng này cho phép theo dõi riêng biệt các nhà quảng cáo trên cùng một trang web. Điều này cũng giúp bạn dễ dàng theo dõi nhiều chiến dịch hoặc sản phẩm trong một biểu ngữ quảng cáo.

Phạm vi phân bổ là các trường không bắt buộc mà bạn có thể đặt trong quá trình đăng ký nguồn và điều kiện kích hoạt. Trong quá trình phân bổ, chỉ những nguồn có giá trị phạm vi phân bổ chứa ít nhất một trong các giá trị phạm vi phân bổ của điều kiện kích hoạt mới được xem xét để phân bổ. Nếu bạn không chỉ định phạm vi trong điều kiện kích hoạt thì tất cả các nguồn sẽ được xem xét. Trước khi tiếp tục, bạn nên làm quen với API Báo cáo phân bổ và bộ lọc cấp cao.

Trong quá trình đăng ký nguồn

Một tham số không bắt buộc attribution_scopes được thêm vào tiêu đề Attribution-Reporting-Register-Source chứa 2 tham số bắt buộc: giá trị và giới hạn; và một tham số không bắt buộc: max_event_states.

• limit: Biểu thị tổng số phạm vi riêng biệt được phép cho mỗi đích đến đối với nguồn gốc báo cáo nguồn. Mọi nguồn đã đăng ký hiện có có cùng nguồn và đích báo cáo, nhưng có giới hạn nhỏ hơn, sẽ bị xoá.
• values: Biểu thị danh sách các phạm vi phân bổ cho một nguồn cụ thể. Các giá trị này phải là chuỗi có độ dài tối đa là 50.
• max_event_states (không bắt buộc): Biểu thị số lượng tối đa các trạng thái sự kiện mà một phương thức gọi API dự định sử dụng trên tất cả các lượt đăng ký nguồn sự kiện tiếp theo. Xin lưu ý rằng mọi nguồn đã đăng ký hiện có có cùng nguồn và đích báo cáo nhưng có max_event_states value khác sẽ bị xoá. Giá trị mặc định của trường không bắt buộc này là 3.

Mẫu đăng ký nguồn

  Attribution-Reporting-Register-source: {
  //optional
  "attribution_scopes":{
  "limit": <int>,
  "values": <list of strings>,
  // optional
  "max_event_states": <int>
    },
  ...
  }

Trong quá trình đăng ký điều kiện kích hoạt

Một tham số không bắt buộc attribution_scopes được thêm vào tiêu đề Attribution-Reporting-Register-Trigger trong quá trình đăng ký trình kích hoạt. Đảm bảo giá trị tham số là một danh sách các chuỗi đại diện cho các phạm vi của điều kiện kích hoạt. Nếu được chỉ định, điều kiện kích hoạt sẽ chỉ khớp với những nguồn có thông số giá trị attribution_scopes chứa ít nhất một trong các attribution_scopes của điều kiện kích hoạt.

Mẫu đăng ký điều kiện kích hoạt

Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}

Ví dụ về phạm vi phân bổ

Ví dụ sau đây cho thấy trường hợp một điều kiện kích hoạt được phân bổ cho một nguồn trong khi sử dụng phạm vi phân bổ.

Đăng ký nguồn #1

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser1"],
  "max_event_states": 3
  },
  ...
  }

Đăng ký nguồn lần 2

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser2"],
  "max_event_states": 3
  },
  ...
  }

Đăng ký điều kiện kích hoạt

  Attribution-Reporting-Register-Trigger: {
  "attribution_scopes": ["advertiser1"],
  ...
  }

Khi quá trình đăng ký điều kiện kích hoạt diễn ra, API sẽ chọn những nguồn được xem xét để phân bổ có các giá trị attribution_scopes giao với các giá trị trong quá trình đăng ký điều kiện kích hoạt. Các lượt đăng ký nguồn trùng khớp sẽ tiếp tục với phần còn lại của quy trình phân bổ. Trong ví dụ này, phương thức gọi API sẽ nhận được một báo cáo phân bổ, trong đó phân bổ lượt đăng ký điều kiện kích hoạt cho lượt đăng ký nguồn đầu tiên.

Phạm vi phân bổ so với bộ lọc

Mặc dù chức năng của phạm vi phân bổ và bộ lọc có thể tương tự nhau, nhưng yếu tố phân biệt là vị trí mà chúng được áp dụng trong quy trình đăng ký điều kiện kích hoạt. Quá trình lọc phạm vi phân bổ diễn ra trước khi phân bổ. Điều này có nghĩa là nó sẽ giảm số lượng nguồn đề xuất chưa hết hạn có cùng trang web đích và nguồn gốc báo cáo, dựa trên những nguồn có phạm vi trùng với phạm vi có trong điều kiện kích hoạt. Tuy nhiên, các bộ lọc cấp cao nhất sẽ được áp dụng sau khi một sự kiện kích hoạt được phân bổ cho một nguồn duy nhất. Nếu bộ lọc nguồn và bộ lọc điều kiện kích hoạt không giao nhau, thì sẽ không có báo cáo nào được tạo.

Hình ảnh sau đây cho thấy một nhóm nguồn và một điều kiện kích hoạt có cùng trang web đích và nguồn báo cáo, đồng thời chưa hết hạn. Chúng ta sẽ nói ngắn gọn về cách sử dụng các phạm vi và bộ lọc phân bổ, cũng như việc báo cáo có được tạo dựa trên các nguồn và điều kiện kích hoạt có sẵn hay không.

Trước khi phân bổ

• Nguồn số 1 bị lọc vì phạm vi phân bổ của nguồn này không khớp với phạm vi casualwear của điều kiện kích hoạt. Việc có mức độ ưu tiên cao nhất trong số tất cả các nguồn có sẵn không ngăn được việc nguồn đó bị lọc ra vì quá trình lọc trước khi phân bổ xảy ra trước khi các mức độ ưu tiên được kiểm tra.
• Nguồn số 2 cũng bị lọc bỏ do không có cùng phạm vi với điều kiện kích hoạt. Nguồn này cũng có cùng bộ lọc với điều kiện kích hoạt, nhưng các bộ lọc cấp cao không được áp dụng cho đến sau khi phân bổ.

Trong quá trình phân bổ

• Nguồn số 3 không được chọn để phân bổ vì có mức độ ưu tiên thấp hơn Nguồn số 4.
• Nguồn số 4 được chọn vì có phạm vi phân bổ phù hợp với điều kiện kích hoạt và có mức độ ưu tiên cao nhất. Bộ lọc cấp cao được áp dụng sau khi phân bổ nên không được tính đến trong quá trình phân bổ.

Phân bổ giá trị đóng góp cho bài đăng

• Không có báo cáo nào được tạo vì các bộ lọc cấp cao cho nguồn đã chọn (nguồn số 4) và điều kiện kích hoạt không giao nhau.

Ví dụ trước không tạo ra báo cáo. Tuy nhiên, nếu nguồn thứ tư bị xoá hoàn toàn:

Trong quá trình phân bổ

• Nguồn số 3 được chọn vì có phạm vi phân bổ giao nhau với điều kiện kích hoạt.

Phân bổ giá trị đóng góp cho bài đăng

• Nguồn số 3 không bị từ chối vì bộ lọc của nguồn này giao với bộ lọc trong điều kiện kích hoạt. Sau đó, hoạt động phân bổ sẽ trải qua các bước kiểm tra phân bổ sau khi đăng còn lại, kết thúc bằng việc tạo báo cáo nếu hoạt động phân bổ vượt qua tất cả các bước kiểm tra.

Phạm vi phân bổ giúp giảm số lượng nguồn được xem xét để phân bổ. Sau đó, các bước phân bổ còn lại sẽ được áp dụng cho nhóm nguồn nhỏ hơn này, có thể dẫn đến một báo cáo.

Vị trí của phạm vi phân bổ trong luồng phân bổ

Phạm vi phân bổ được áp dụng trước khi một nguồn được chọn để phân bổ. Điều này cũng xảy ra trước bộ lọc cấp cao nhất và bộ lọc cửa sổ báo cáo tuỳ chỉnh. Sơ đồ sau đây cho thấy phiên bản đơn giản hoá của quy trình phân bổ tổng thể, trong đó phạm vi phân bổ diễn ra trước khi phân bổ và các bước kiểm tra phân bổ còn lại.

Các thao tác trong quy trình phân bổ

Sau đây là nội dung tóm tắt về các thao tác được thực hiện trong quy trình phân bổ:

• Đăng ký nguồn: Khi người dùng tương tác với một quảng cáo trên trang web của nhà quảng cáo, một sự kiện nguồn sẽ được đăng ký. Sau đó, thiết bị sẽ gửi một yêu cầu đến điểm cuối của nguồn báo cáo. Điểm cuối này sẽ phản hồi bằng một tiêu đề chứa dữ liệu sự kiện nguồn.
• Đăng ký điều kiện kích hoạt: Khi một lượt chuyển đổi xảy ra trên trang web của nhà quảng cáo, một sự kiện kích hoạt sẽ được đăng ký. Một yêu cầu khác được thiết bị gửi đến nguồn báo cáo. Nguồn này sẽ phản hồi bằng một tiêu đề chứa dữ liệu sự kiện lệnh kích hoạt.
• So khớp nguồn: Thiết bị so khớp các sự kiện nguồn và điều kiện kích hoạt dựa trên các tiêu chí như trang web đích, nguồn gốc báo cáo và thời gian hết hạn.
• Kiểm tra phạm vi phân bổ: Các nguồn được lọc dựa trên điểm giao nhau giữa các giá trị attribution_scopes của nguồn và điều kiện kích hoạt.
• Phân bổ: Thiết bị sẽ chọn nguồn có mức độ ưu tiên cao nhất để phân bổ nếu có nhiều nguồn trùng khớp. Nếu các mức độ ưu tiên bằng nhau, thì mức độ ưu tiên gần đây nhất sẽ được chọn.
• Kiểm tra bộ lọc: Thiết bị so sánh bộ lọc nguồn và bộ lọc điều kiện kích hoạt để xác định xem chúng có khớp nhau hay không. Nếu các bộ lọc không khớp thì mô hình phân bổ sẽ bị loại bỏ.
• Tắt các nguồn khác: Nếu các bộ lọc của nguồn đã chọn khớp, thì thiết bị sẽ tắt các nguồn khớp trong giai đoạn So khớp nguồn. Các nguồn bị huỷ kích hoạt sẽ bao gồm những nguồn có phạm vi phân bổ không khớp với phạm vi điều kiện kích hoạt.
• Các bước kiểm tra sau phân bổ: Thiết bị thực hiện thêm các bước kiểm tra đối với hoạt động phân bổ đã chọn, chẳng hạn như kiểm tra xem nguồn có bị nhiễu bằng các báo cáo giả mạo hay không, kiểm tra các hoạt động phân bổ trùng lặp bằng khoá loại bỏ trùng lặp, kiểm tra xem điều kiện kích hoạt có nằm trong khoảng thời gian báo cáo của nguồn hay không và kiểm tra giới hạn số lượng yêu cầu.
• Tạo báo cáo: Nếu tất cả các bước kiểm tra đều thành công, thiết bị sẽ tạo và lên lịch gửi báo cáo phân bổ đến điểm cuối của nguồn gốc báo cáo.

Các bước tiếp theo

• Đọc thêm về các phạm vi phân bổ trong Giải thích về việc lọc trước khi phân bổ trên GitHub.
• Đọc thêm về bộ lọc trong bài viết Xác định quy tắc cho khách hàng bằng bộ lọc.