Quy cách đánh giá

Mục đích chính của evaluation_spec trong một quy tắc là xác định đối tượng mà quy tắc đó sẽ thực thi hành động. evaluation_type xác định loại phương thức đánh giá và có những tùy chọn sau đây:

evaluation_spec có chứa mảng filters, giúp bạn thu hẹp hơn nữa danh sách các đối tượng trùng khớp. Ví dụ: bạn có thể tạo bộ lọc dựa trên siêu dữ liệu của quảng cáo, nhóm quảng cáo và chiến dịch quảng cáo, cũng như số liệu Thông tin chi tiết. Tất cả bộ lọc được đánh giá cùng nhau bằng toán tử AND.

Mảng filters có chứa danh sách các đối tượng bộ lọc. Những đối tượng này là các từ điển có khóa field, value và operator:

Mỗi bộ lọc có một danh sách các toán tử logic được hỗ trợ. Sau đây là các toán tử logic được hỗ trợ trong quy tắc SCHEDULE và TRIGGER:

evaluation_spec cần có một trigger cho loại đánh giá TRIGGER. Yếu tố kích hoạt này chứa một loại và một quy cách bộ lọc cơ bản. Quy cách bộ lọc có thể là field, value và operator.

Yếu tố kích hoạt sẽ tự động xác định liệu chúng tôi có cần đánh giá một quy tắc hay không. Bạn chỉ được có 1 yếu tố kích hoạt. Hãy xem bài viết Quy tắc dựa trên yếu tố kích hoạt để biết thêm thông tin.

Dưới đây, chúng tôi xác định một số bộ lọc đặc biệt và các nhóm bộ lọc chung mà bạn có thể sử dụng.

Bộ lọc đặc biệt

time_preset

Bộ lọc time_preset xác định khoảng thời gian mà chúng tôi tổng hợp số liệu Thông tin chi tiết. Hiện tại, chúng tôi chỉ cho phép 1 time_preset. Bộ lọc này áp dụng cho tất cả bộ lọc số thống kê trong quy tắc, bao gồm cả bộ lọc được sử dụng cho yếu tố kích hoạt, nếu có.

Toán tử duy nhất được hỗ trợ cho time_preset là EQUAL. Đây là toán tử bắt buộc miễn là có bất kỳ yếu tố kích hoạt hoặc bộ lọc Thông tin chi tiết nào. Quy tắc dựa trên yếu tố kích hoạt chỉ hỗ trợ giá trị thời gian đặt sẵn bao gồm cả TODAY vì quy tắc này thực hiện đánh giá theo thời gian thực.

Giá trị thời gian đặt sẵn cho quy tắc có thể hoạt động khác với các giao diện khác. Một số giá trị thời gian đặt sẵn dưới đây bao gồm cả dữ liệu của ngày hôm nay. Đó là vì dữ liệu của ngày hôm nay rất quan trọng đối với các quy tắc chạy thường xuyên hơn hàng ngày. Đối với những giao diện khác, giá trị đặt sẵn của LAST_N_DAYS thường không bao gồm cả dữ liệu của ngày hôm nay. Hãy xem nội dung mô tả bên dưới để biết thêm chi tiết.

{
  "field": "time_preset",
  "value": "TODAY",
  "operator": "EQUAL"
}

attribution_window

Bộ lọc attribution_window xác định khoảng thời gian xem lại mà số liệu thông tin chi tiết được tổng hợp. Để biết thêm thông tin, hãy xem phần Khoảng thời gian phân bổ trong tài liệu về Thông tin chi tiết.

Hiện tại, chúng tôi chỉ cho phép 1 attribution_window và bộ lọc này áp dụng cho tất cả bộ lọc số liệu thống kê trong quy tắc. Toán tử duy nhất được hỗ trợ cho attribution_window là EQUAL và toán tử này chỉ được Quy tắc dựa trên lịch chạy hỗ trợ.

Dù có được chỉ định hay không, value duy nhất mà bạn được phép sử dụng cho attribution_window là ACCOUNT_DEFAULT.

{
  "field": "attribution_window",
  "value": "ACCOUNT_DEFAULT",
  "operator": "EQUAL"
}

Bộ lọc siêu dữ liệu

Với bộ lọc siêu dữ liệu, bạn có thể lọc đối tượng theo trạng thái hiện tại của trường siêu dữ liệu. Những bộ lọc này cũng hỗ trợ tính năng lọc nhiều cấp độ, tức là bạn có thể sử dụng tiền tố để áp dụng bộ lọc siêu dữ liệu cho đối tượng cha mẹ hoặc ông bà của một đối tượng. Các bộ lọc khác sẽ không bị ảnh hưởng. Bộ lọc Thông tin chi tiết vẫn áp dụng cho đối tượng bình thường.

Ví dụ: nếu muốn một quy tắc áp dụng cho các nhóm quảng cáo của chiến dịch quảng cáo có mục tiêu là WEBSITE_CLICKS, bạn có thể thêm 2 bộ lọc:

 "filters" : [
  {
    "field": "entity_type",
    "value": "ADSET",
    "operator": "EQUAL",
  },
  {
    "field": "campaign.objective",
    "value": "WEBSITE_CLICKS",
    "operator": "EQUAL"
  }
]

Bộ lọc siêu dữ liệu được Quy tắc dựa trên yếu tố kích hoạt và Quy tắc dựa trên lịch chạy hỗ trợ

Bộ lọc siêu dữ liệu chỉ được Quy tắc dựa trên lịch chạy hỗ trợ

entity_type và id

Đối với mọi quy tắc có loại đánh giá là SCHEDULE hoặc TRIGGER, bạn phải chỉ định bộ lọc entity_type hoặc id.

Khi chỉ định bộ lọc entity_type, bạn xác định một cấp độ đối tượng động để áp dụng quy tắc. Ví dụ: nếu entity_type là AD, quy tắc đó sẽ tự động đánh giá mọi quảng cáo mới được thêm vào tài khoản quảng cáo. Hoạt động đánh giá này diễn ra bất kể bạn tạo quy tắc ở thời điểm nào. Khi bạn chỉ định bộ lọc id, quy tắc sẽ chỉ áp dụng cho danh sách đối tượng tĩnh.

Khi bạn chỉ định bộ lọc idmà không có tiền tố, chúng tôi sẽ tự động tính toán cấp độ đối tượng để áp dụng quy tắc. Ví dụ: nếu muốn áp dụng quy tắc cho quảng cáo [123, 456], bạn chỉ cần 1 trường bộ lọc id, giá trị [123, 456] và toán tử IN. Trong trường hợp này, entity_type là không bắt buộc vì bạn đã cung cấp một danh sách đối tượng tĩnh ban đầu. Chúng tôi có thể tính toán cấp độ đối tượng dựa trên những đối tượng đó.

Bạn có thể sử dụng entity_type và id, kết hợp với tính năng lọc nhiều cấp độ. Ví dụ: nếu muốn một quy tắc áp dụng cho tất cả quảng cáo thuộc một số nhóm quảng cáo được chỉ định, bạn có thể sử dụng bộ lọc entity_type là AD và bộ lọc adset.id với các nhóm quảng cáo được chỉ định.

Theo mặc định, nếu bạn không chỉ định bộ lọc effective_status, chúng tôi sẽ tự động thêm bộ lọc effective_status khi đánh giá quy tắc.

Đối với tất cả những loại thực thi tác động lên đối tượng đang hoạt động, bộ lọc mặc định này sẽ có toán tử là IN và giá trị là ['ACTIVE', 'PENDING_REVIEW']. Tức là quy tắc chỉ đánh giá các đối tượng có hoặc sẽ có hoạt động phân phối đang diễn ra. Đối với những loại thực thi không tác động lên đối tượng đang hoạt động (UNPAUSE), chúng tôi sẽ thêm bộ lọc này với toán tử là NOT_IN và giá trị là ['DELETED', 'ARCHIVED']. Bộ lọc mặc định là phương thức tối ưu hóa nội bộ cho các loại thực thi của chúng tôi.

Bộ lọc Thông tin chi tiết

Chúng tôi đánh giá các bộ lọc thông tin chi tiết dựa trên giá trị hiện tại mà API Thông tin chi tiết trả về cho một time_preset cụ thể. Những bộ lọc này áp dụng trực tiếp cho danh sách hoặc cấp độ đối tượng và không hỗ trợ tính năng lọc nhiều cấp độ. Tất cả bộ lọc Thông tin chi tiết đều hỗ trợ các toán tử sau đây: GREATER_THAN, LESS_THAN, EQUAL, IN_RANGE, NOT_IN_RANGE.

Hãy xem nội dung mô tả về từng trường bên dưới trong tài liệu về API Thông tin chi tiết. Tất cả bộ lọc sau đây đều được Quy tắc dựa trên lịch chạy hỗ trợ.

Dưới đây là danh sách các bộ lọc Thông tin chi tiết và tình trạng có/không được Quy tắc dựa trên yếu tố kích hoạt hỗ trợ:

Bộ lọc nâng cao

Bạn có thể tùy chỉnh và tạo ra các trường nâng cao dựa trên bộ lọc thông tin chi tiết và bộ lọc siêu dữ liệu ở trên. Để biết thêm thông tin, hãy xem bài viết Bộ lọc nâng cao cho quy cách đánh giá.

Bộ lọc nâng cao hỗ trợ các toán tử sau đây: GREATER_THAN, LESS_THAN, EQUAL, IN_RANGE, NOT_IN_RANGE. Bộ lọc nâng cao chỉ được Quy tắc dựa trên lịch chạy hỗ trợ.

Đối với một số bộ lọc nâng cao thường dùng nhất, chúng tôi hỗ trợ bí danh làm bộ lọc: