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 phương thức gọi API chỉ định danh sách các chuỗi trong quá trình đăng ký nguồn và trình kích hoạt 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. Tính năng này cũng hỗ trợ việc 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ả 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à các 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, trong đó chứa hai tham số bắt buộc: values và limit; và một tham số không bắt buộc: max_event_states.

  • limit (giới hạn): Thể hiện tổng số phạm vi riêng biệt được phép cho mỗi đích đến của nguồn gốc báo cáo. Mọi nguồn đã đăng ký hiện có có cùng nguồn gốc và đích báo cáo, nhưng có giới hạn nhỏ hơn sẽ bị xoá.
  • values:Đại diện cho danh sách 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 trạng thái sự kiện tối đa mà 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 gốc và đích báo cáo nhưng có max_event_states value khác sẽ bị xoá. Giá trị mặc định cho 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ố attribution_scopes không bắt buộc đượ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à danh sách các chuỗi đại diện cho phạm vi của điều kiện kích hoạt. Điều kiện kích hoạt sẽ chỉ so 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, nếu được chỉ định.

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 #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 xảy ra, API sẽ chọn các nguồn được xem xét để phân bổ có giá trị attribution_scopes giao nhau 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ổ 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ó vẻ tương tự nhau, nhưng điểm khác biệt là vị trí áp dụng các phạm vi và bộ lọc đó 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à giảm nhóm các 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 giao nhau với phạm vi tìm thấy trong điều kiện kích hoạt. Tuy nhiên, bộ lọc cấp cao nhất được áp dụng sau khi một điều 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ì hệ thống sẽ không tạo báo cá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 đích, nguồn gốc báo cáo và chưa hết hạn. Chúng ta sẽ thảo luận ngắn gọn về cách sử dụng các bộ lọc và phạm vi phân bổ, cũng như liệu 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 hiện có hay không.

<img "activewear"="" "attribution="" "casualwear"="" "casualwear",="" "outerwear"="" "outerwear".="" "outerwear"."="" #1".the="" 1.="" 2.="" alt="An image showing 4 boxes labelled sources numbered 1 through 4 and a single box labelled " and="" attributes="" filter:="" first="" following="" fourth="" has="" priority:="" scope":="" second="" source="" src="/static/assets/images/attribution-scopes-example-1.png" the="" third="" title="Example on how attribution works with attribution scopes and filters" trigger="" />

Trước khi phân bổ

  • Nguồn #1 bị lọc ra vì phạm vi phân bổ của nguồn không khớp với phạm vi của điều kiện kích hoạt là casualwear. 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 việc nguồn đó bị lọc ra vì hoạt động lọc trước khi phân bổ diễn ra trước khi kiểm tra mức độ ưu tiên.
  • Nguồn #2 cũng bị lọc ra 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ó bộ lọc giống như điều kiện kích hoạt, nhưng bộ lọc cấp cao sẽ không được áp dụng cho đến sau khi phân bổ.

Trong quá trình phân bổ

  • Nguồn #3 không được chọn để phân bổ vì có mức độ ưu tiên thấp hơn Nguồn #4.
  • Nguồn #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ổ.

Mô hình phân bổ bài đăng

  • Không có báo cáo nào được tạo vì bộ lọc cấp cao cho nguồn đã chọn (nguồn #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:

Cùng một hình ảnh có 4 hộp được gắn nhãn nguồn được đánh số từ 1 đến 4 và một hộp duy nhất được gắn nhãn

Trong quá trình phân bổ

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

Mô hình phân bổ bài đăng

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

Phạm vi phân bổ làm 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. Nhóm nguồn này có thể tạo ra 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 chọn một nguồ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 khoảng thời gian 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.

<img "attribution="" "attribution",="" "deactivation="" "filters="" "report="" "source="" "trigger="" alt="Hình ảnh cho thấy phiên bản đơn giản của quy trình phân bổ, trong đó mỗi bước được biểu thị bằng một hình vuông được liên kết với bước tiếp theo bằng một mũi tên. Các bước theo thứ tự là " and="" check",="" checks"="" generation"."="" matching",="" of="" other="" registration",="" scopes="" source="" sources",="" src="/static/assets/images/attribution-scopes-attribution-flow.png" title="Simplified attribution flow diagram" />

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

Sau đây là thông tin 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ý. Thiết bị sẽ gửi một yêu cầu khác đến nguồn báo cáo. Yêu cầu này sẽ phản hồi bằng một tiêu đề chứa dữ liệu sự kiện kích hoạt.
  • So khớp nguồn: Thiết bị so khớp sự kiện nguồn và sự 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 giao điểm giữa giá trị source và trigger attribution_scopes.
  • 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 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 các bộ lọc đó có khớp 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 bộ lọc của nguồn đã chọn khớp, thiết bị sẽ tắt các nguồn đã khớp trong giai đoạn So khớp nguồn. Những nguồn đã huỷ kích hoạt sẽ bao gồm các 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.
  • Kiểm tra sau khi phân bổ: Thiết bị thực hiện thêm các bước kiểm tra đối với mô hình phân bổ đã chọn, chẳng hạn như kiểm tra xem nguồn có bị báo cáo giả mạo làm nhiễu hay không, kiểm tra các mô hình 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 tốc độ.
  • 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 báo cáo.

Các bước tiếp theo