Quy tắc đối tượng xác định xem ai đó có được thêm vào đối tượng tùy chỉnh của bạn hay không. Quy tắc này được áp dụng cho URL giới thiệu hoặc sự kiện và dữ liệu cụ thể.
Hãy cung cấp quy tắc của bạn dưới dạng chuỗi được mã hóa JSON có cấu trúc như sau:
Hãy sử dụng quy tắc đối tượng cho các loại đối tượng tùy chỉnh khác nhau, bao gồm cả Đối tượng tùy chỉnh từ trang web, Đối tượng tùy chỉnh từ ứng dụng di động và Đối tượng tùy chỉnh offline. Để biết Quy tắc đối tượng tương tác, hãy xem phần Đối tượng tùy chỉnh tương tác.
rules
trong inclusions
hoặc exclusions
.Để xác định quy tắc đối tượng, bạn phải tuân theo cấu trúc sau đây:
rule: { "inclusions": <RULE_SET>, "exclusions": <RULE_SET>, }
Tên | Mô tả |
---|---|
loại: Chuỗi | Bắt buộc. Chuỗi JSON của bộ quy tắc để xác định quy tắc bao gồm. Hãy xem phần Cú pháp bộ quy tắc. |
loại: Chuỗi | Bắt buộc. Chuỗi JSON của bộ quy tắc để xác định quy tắc loại trừ. Hãy xem phần Cú pháp bộ quy tắc. |
Đối với mỗi bộ quy tắc, hãy tuân theo cấu trúc sau đây:
{ "operator" : <BOOLEAN_OPERATOR>, "rules" : <JSON_RULE>, }
Tên | Mô tả |
---|---|
loại: chuỗi | Bắt buộc.
|
loại: chuỗi | Bắt buộc. Chuỗi JSON của quy tắc (mảng quy tắc). Hãy xem phần Cú pháp quy tắc bao gồm và loại trừ. |
Đối với mỗi quy tắc bao gồm hoặc loại trừ, hãy tuân theo cấu trúc sau đây:
{ "event_sources" : <EVENT_SOURCE_DEFINITION>, "retention_seconds" : <SECONDS>, "filter" : <FILTER>, "aggregation" : <AGGREGATION>, }
aggregation
và retention_seconds
là các trường có thể chỉnh sửa. Tuy nhiên, việc chỉnh sửa aggregation
và retention_seconds
sẽ không làm mất đối tượng. Những người chỉ khớp với quy tắc/hàm tổng hợp cũ sẽ vẫn thuộc đối tượng đó cho đến khi hết hạn.
Tên | Mô tả |
---|---|
loại: Chuỗi | Bắt buộc. Đối tượng JSON chứa
Bạn có thể thêm nhiều nguồn sự kiện khác vào |
loại: Số nguyên | Bắt buộc. Số nguyên (tính bằng giây) cho khoảng thời gian giữ chân của đối tượng, phải nhỏ hơn |
loại: Chuỗi | Bắt buộc. Chuỗi JSON của quy tắc bộ lọc. Hãy xem phần Bộ lọc. |
loại: Số nguyên | Không bắt buộc. Chuỗi JSON của hàm tổng hợp. Hãy xem phần Hàm tổng hợp. |
Bộ lọc tuân theo định dạng chung sau đây:
"filter" : { "operator": <BOOLEAN_OPERATOR>, "filters": <FILTER_SET>, }
Tên | Mô tả |
---|---|
loại: chuỗi | Bắt buộc.
|
loại: chuỗi | Bắt buộc. Mảng đối tượng JSON của quy tắc bộ lọc. Hãy xem phần Cú pháp quy tắc bộ lọc. |
{ "field": <FIELD>, "operator": <COMPARISON_OPERATOR>, "value": <VALUE>, }
Tên | Mô tả |
---|---|
loại: Chuỗi | Bắt buộc.
|
loại: Chuỗi | Bắt buộc.
Nếu bạn đặt |
loại: Chuỗi | Bắt buộc. Nếu bạn đặt thuộc tính |
Hãy tạo đối tượng tùy chỉnh dựa trên tần suất và cường độ thực hiện hành vi bằng cách sử dụng hàm aggregation
trong trường quy tắc đối tượng. Nhờ vậy, bạn xác định được hàm tổng hợp như sau:
"aggregation" : { "type":"count", "operator":">", "value":1 }
Tên | Mô tả |
---|---|
loại: Chuỗi | Bắt buộc. Loại hàm tổng hợp.
|
| Bắt buộc đối với một số loại hàm tổng hợp. |
loại: Chuỗi | Không bắt buộc.
|
loại: Chuỗi | Bắt buộc. Trừ khi loại là Thông số áp dụng hàm tổng hợp. |
loại: Chuỗi | Bắt buộc.
|
loại: Chuỗi | Bắt buộc. Giá trị dự kiến của thông số. |
Ví dụ:
"aggregation" : { "type":"count", "operator":">", "value":1 }
Toán tử | Mô tả |
---|---|
| Đúng nếu giá trị thông số của sự kiện lớn hơn giá trị đã chỉ định. |
| Đúng nếu giá trị thông số của sự kiện lớn hơn hoặc bằng giá trị đã chỉ định. |
| Đúng nếu giá trị thông số của sự kiện nhỏ hơn giá trị đã chỉ định. |
| Đúng nếu giá trị thông số của sự kiện nhỏ hơn hoặc bằng giá trị đã chỉ định. |
| Đúng nếu giá trị thông số của sự kiện bằng giá trị đã chỉ định. Lưu ý: Giá trị này tương đương với việc không chỉ định toán tử nào, nghĩa là "'x' : { 'eq' : 'y' }" tương tự như "'x' : 'y' }. |
| Đúng nếu giá trị thông số của sự kiện không bằng giá trị đã chỉ định. |
| Đúng nếu chuỗi giá trị thông số của sự kiện chứa chuỗi đã chỉ định. Giá trị "shoe12345" sẽ hoàn thành toán tử "contains" nếu giá trị đã chỉ định là "shoe". |
| Đúng nếu chuỗi giá trị thông số của sự kiện không chứa chuỗi đã chỉ định. Giá trị "shoe12345" sẽ hoàn thành toán tử "not_contains" nếu giá trị đã chỉ định là "purse". |
| Chứa, không phân biệt chữ hoa chữ thường |
| Không chứa, không phân biệt chữ hoa chữ thường |
| Đúng nếu giá trị thông số của sự kiện khớp với bất kỳ chuỗi nào trong mảng cụ thể. |
| Đúng nếu giá trị thông số của sự kiện không khớp với chuỗi nào trong mảng đã chỉ định. |
| "is_any", không phân biệt chữ hoa chữ thường. |
| "is_not_any", không phân biệt chữ hoa chữ thường |
| Đúng nếu giá trị thông số của sự kiện bắt đầu bằng chuỗi cụ thể |
| "starts_with", không phân biệt chữ hoa chữ thường |
| Khớp với một biểu thức chính quy, chẳng hạn như \"example\.com.*purchase$\". Hỗ trợ ngữ pháp PCRE đầy đủ |
Khớp với tất cả URL tham chiếu có chứa chuỗi "shoes" trong 30 ngày qua:
{ "inclusions": { "operator": "or", "rules": [ { "event_sources": [ { "type": "pixel", "id": "<PIXEL_ID>", } ], "retention_seconds": 2592000, "filter": { "operator": "and", "filters": [ { "field": "url", "operator": "i_contains", "value": "shoes" } ] }, } ] } }
Khớp với các sự kiện ViewContent
có giá mặt hàng lớn hơn hoặc bằng 100 USD trong 30 ngày qua. Hãy cân nhắc sử dụng quy tắc này cho sự kiện sau đây:
_fbq.push([ 'track', 'ViewContent', { productId: 1234, category: 'Men > Shoes', price: 199 } ]);
{ "inclusions": { "operator": "or", "rules": [ { "event_sources": [ { "type": "pixel", "id": "<PIXEL_ID>" } ], "retention_seconds": 2592000, "filter": { "operator": "and", "filters": [ { "field": "event", "operator": "eq", "value": "ViewContent" }, { "operator": "or", "filters": [ { "field": "price", "operator": ">=", "value": "100" } ] } ] } } ] } }
Hãy xem phần Đối tượng tùy chỉnh từ ứng dụng di động, Quy tắc đối tượng tùy chỉnh mẫu.
Quy tắc có các toán tử và dữ liệu hoặc sự kiện sau đây:
Toán tử | Loại bộ lọc |
---|---|
| Chứa chuỗi con, không phân biệt chữ hoa chữ thường |
| Không chứa chuỗi con, không phân biệt chữ hoa chữ thường |
| Chứa chuỗi con, phân biệt chữ hoa chữ thường |
| Không chứa chuỗi con, phân biệt chữ hoa chữ thường |
| Bằng, phân biệt chữ hoa chữ thường |
| Không bằng, phân biệt chữ hoa chữ thường |
| Nhỏ hơn, chỉ trường số |
| Nhỏ hơn hoặc bằng, chỉ trường số |
| Lớn hơn, chỉ trường số |
| Lớn hơn hoặc bằng, chỉ trường số |
| Khớp với một biểu thức chính quy, chẳng hạn như |
Dữ liệu | Dữ liệu được lọc |
---|---|
| URL thoát ký tự hoàn toàn của trang web đã truy cập |
| Miền của trang web đã truy cập |
| Đường dẫn của trang web đã truy cập, không bao gồm miền |
| Tên của pixel |
| Thiết bị đã truy cập trang web:
|
trường | Bất kỳ trường nào được thêm vào |
Cung cấp từng quy tắc dưới dạng chuỗi được mã hóa JSON.