Aturan Pemirsa

Aturan pemirsa menentukan apakah seseorang ditambahkan ke pemirsa khusus Anda. Aturan diterapkan pada URL perujuk maupun peristiwa dan data tertentu.

Berikan aturan Anda sebagai string berkode JSON yang terstruktur seperti ini:

• Satu aturan pemirsa berisi dua set aturan.
• Tiap set aturan dapat berisi aturan penyertaan atau pengecualian.
• Tiap aturan penyertaan atau pengecualian dapat berisi filter dan fungsi agregasi.
• Tiap filter berisi set filter.

Gunakan aturan pemirsa untuk berbagai jenis pemirsa khusus, termasuk Pemirsa Khusus Situs Web, Pemirsa Khusus Aplikasi Seluler, dan Pemirsa Khusus Offline. Untuk Aturan Pemirsa Interaksi, lihat Pemirsa Khusus Interaksi.

Batasan

• Tiap pemirsa dapat menentukan maksimal 10 aturan dalam aturan pemirsa. Hal ini mencakup jumlah rules dalam inclusions atau exclusions
• Tiap aturan dapat menentukan hingga 100 filter, yang dikenal sebagai leaf node.

Sintaks Aturan Pemirsa

Untuk menentukan aturan pemirsa, struktur berikut harus diikuti:

rule: {
   "inclusions": <RULE_SET>,
   "exclusions": <RULE_SET>,
}

Kolom yang Tersedia

Sintaks Set Aturan

Untuk setiap set aturan, ikuti struktur ini:

{
  "operator" : <BOOLEAN_OPERATOR>,
  "rules" : <JSON_RULE>,
}

Kolom yang Tersedia

Sintaks Aturan Penyertaan dan Pengecualian

Untuk setiap aturan penyertaan atau pengecualian, ikuti struktur ini:

{
  "event_sources" : <EVENT_SOURCE_DEFINITION>, 
  "retention_seconds" : <SECONDS>,
  "filter" : <FILTER>,
  "aggregation" : <AGGREGATION>, 
}

Kolom yang Tersedia

Filter

Pemfilteran mengikuti format umum ini:

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

Kolom yang Tersedia

Sintaks Set Filter

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

Kolom yang Tersedia

Fungsi Agregasi

Buat pemirsa khusus berdasarkan frekuensi dan intensitas perilaku dengan menggunakan aggregation pada kolom aturan pemirsa. Dengan kolom ini, Anda menentukan fungsi agregasi, contoh:

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

Kolom yang Tersedia

Contoh:

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

Operator Perbandingan

Contoh

Pemirsa Khusus Situs Web

Cocokkan semua URL perujuk yang berisi string shoes dalam 30 hari terakhir:

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

Cocokkan peristiwa ViewContent yang mempunyai harga item lebih besar daripada atau sama dengan USD100 dalam 30 hari terakhir. Pertimbangkan untuk menggunakan aturan ini untuk peristiwa berikut:

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

Pemirsa Khusus Aplikasi Seluler

Lihat Pemirsa Khusus Aplikasi Seluler, Contoh Aturan Pemirsa Khusus.

Operator dan Data atau Peristiwa

Aturan memiliki operator dan data atau peristiwa berikut:

Sediakan tiap aturan sebagai string berkode JSON.