Quy tắc đối tượng

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Đố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.

Giới hạn

  • Mỗi đối tượng có thể chỉ định tối đa 10 quy tắc trong quy tắc đối tượng, bao gồm cả số lượng rules trong inclusions hoặc exclusions.
  • Mỗi quy tắc có thể chỉ định tối đa 100 bộ lọc, còn gọi là nút lá.

Cú pháp quy tắc đối tượng

Để 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>,
}

Trường có sẵn

Tên Mô tả

inclusions

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.

exclusions

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.

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>,
}

Trường có sẵn

Tên Mô tả

operator

loại: chuỗi

Bắt buộc.

and hoặc or.

rules

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ừ.

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>, 
}

aggregationretention_seconds là các trường có thể chỉnh sửa. Tuy nhiên, việc chỉnh sửa aggregationretention_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.

Trường có sẵn

Tên Mô tả

event_sources

loại: Chuỗi

Bắt buộc.

Đối tượng JSON chứa idtype.


Bạn có thể thêm nhiều nguồn sự kiện khác vào type thông qua danh sách được phân cách bằng dấu phẩy là "store_visits,pixel,app".

retention_seconds

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 retention_days. Tối thiểu = 1; Tối đa = 365 ngày

filter

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.

aggregation

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

Bộ lọc tuân theo định dạng chung sau đây:

"filter" : {
  "operator": <BOOLEAN_OPERATOR>,
  "filters": <FILTER_SET>,
  }

Trường có sẵn

Tên Mô tả

operator

loại: chuỗi

Bắt buộc.

and hoặc or

filters

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.

Cú pháp nhóm bộ lọc

{
    "field": <FIELD>,
    "operator": <COMPARISON_OPERATOR>,
    "value": <VALUE>,
}

Trường có sẵn

Tên Mô tả

field

loại: Chuỗi

Bắt buộc.


  • Đối với Đối tượng tùy chỉnh từ trang web, hãy sử dụng 'event' nếu bộ lọc là để chỉ định sự kiện. Thông số khớp với các sự kiện do pixel gửi (ví dụ: 'ViewContent', 'Purchase').
  • Đối với Đối tượng tùy chỉnh từ ứng dụng di động, hãy sử dụng 'event' nếu bộ lọc là để chỉ định sự kiện. Thông số khớp với Sự kiện trong ứng dụng do ứng dụng gửi. Ví dụ: "_appVersion", "_value", v.v.

operator

loại: Chuỗi

Bắt buộc.

  • =
  • !=
  • >=
  • >
  • <=
  • <
  • i_contains
  • i_not_contains
  • contains
  • not_contains
  • is_any
  • is_not_any
  • i_is_any
  • i_is_not_any
  • i_starts_with
  • starts_with
  • "regex_match"[INFO]

Nếu bạn đặt fieldevent thì phải sử dụng =.

value

loại: Chuỗi

Bắt buộc.

Nếu bạn đặt thuộc tính field"event" thì phải đặt value là tên sự kiện. Hãy sử dụng API Sự kiện trong ứng dụng để xem các thông số và sự kiện trong ứng dụng do ứng dụng báo cáo.

Hàm tổng hợp

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
}

Trường có sẵn

Tên Mô tả

type

loại: Chuỗi

Bắt buộc.

Loại hàm tổng hợp.

  • Đối với Đối tượng tùy chỉnh từ trang web, bạn có thể sử dụng các hàm sau đây: 'count', 'sum', 'avg', 'min', 'max', 'time_spent''last_event_time_field'.
  • Đối với Đối tượng tùy chỉnh từ ứng dụng di động, bạn có thể sử dụng các hàm sau đây: "count","sum", "avg", "min""max".

config

Bắt buộc đối với một số loại hàm tổng hợp.

method

loại: Chuỗi

Không bắt buộc.

"absolute" nghĩa là thêm những người đã ghi lại sự kiện trong phạm vi đã chỉ định hoặc "percentile" nghĩa là thêm những người từ phạm vi phần trăm đã chỉ định. Nếu chọn percentile, bạn sẽ chỉ được sử dụng toán tử in_rangenot_in_range.

field

loại: Chuỗi

Bắt buộc. Trừ khi loại là count.

Thông số áp dụng hàm tổng hợp.

operator

loại: Chuỗi

Bắt buộc.

=, !=, >=, >, <=, <, in_range, not_in_range

value

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ử so sánh

Toán tử Mô tả

> hoặc gt

Đúng nếu giá trị thông số của sự kiện lớn hơn giá trị đã chỉ định.

>= hoặc gte

Đú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.

< hoặc lt

Đúng nếu giá trị thông số của sự kiện nhỏ hơn giá trị đã chỉ định.

<= hoặc lte

Đúng nếu giá trị thông số của sự kiện nhỏ hơn hoặc bằng giá trị đã chỉ định.

= hoặc eq

Đú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' }.

!= hoặc neq

Đúng nếu giá trị thông số của sự kiện không bằng giá trị đã chỉ định.

contains

Đú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".

not_contains

Đú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".

i_contains

Chứa, không phân biệt chữ hoa chữ thường

i_not_contains

Không chứa, không phân biệt chữ hoa chữ thường

is_any

Đú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ể.

is_not_any

Đú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.

i_is_any

"is_any", không phân biệt chữ hoa chữ thường.

i_is_not_any

"is_not_any", không phân biệt chữ hoa chữ thường

starts_with

Đúng nếu giá trị thông số của sự kiện bắt đầu bằng chuỗi cụ thể

i_starts_with

"starts_with", không phân biệt chữ hoa chữ thường

regex_match

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 đủ

Ví dụ

Đối tượng tùy chỉnh từ trang web

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"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

Đối tượng tùy chỉnh từ ứng dụng di động

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.

Toán tử và dữ liệu hoặc sự kiện

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

i_contains

Chứa chuỗi con, không phân biệt chữ hoa chữ thường

i_not_contains

Không chứa chuỗi con, không phân biệt chữ hoa chữ thường

contains

Chứa chuỗi con, phân biệt chữ hoa chữ thường

not_contains

Không chứa chuỗi con, phân biệt chữ hoa chữ thường

eq

Bằng, phân biệt chữ hoa chữ thường

neq

Không bằng, phân biệt chữ hoa chữ thường

lt

Nhỏ hơn, chỉ trường số

lte

Nhỏ hơn hoặc bằng, chỉ trường số

gt

Lớn hơn, chỉ trường số

gte

Lớn hơn hoặc bằng, chỉ trường số

regex_match

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 đủ

Dữ liệu Dữ liệu được lọc

url

URL thoát ký tự hoàn toàn của trang web đã truy cập

domain

Miền của trang web đã truy cập

path

Đường dẫn của trang web đã truy cập, không bao gồm miền

event

Tên của pixel event, chẳng hạn như 'ViewContent'

device_type

Thiết bị đã truy cập trang web:

desktop

mobile_android_phone

mobile_android_tablet

mobile_ipad

mobile_ipod

mobile_iphone

mobile_tablet

mobile_windows_phone

trường customData bất kỳ

Bất kỳ trường nào được thêm vào customData để kích hoạt pixel, chẳng hạn như productId, category, price

Cung cấp từng quy tắc dưới dạng chuỗi được mã hóa JSON.