Filter Spesifikasi Evaluasi

Dalam aturan Berbasis Jadwal, dimungkinkan untuk menggunakan jenis kolom filter yang lebih canggih.

Kolom Insight Berawalan

Anda dapat menetapkan jenis awalan tertentu untuk filter Insight. Ini mirip dengan awalan yang ditetapkan untuk filter Metadata guna melakukan pemfilteran multi-level.

Anda dapat menetapkan awalan level objek pada filter untuk memanfaatkan pemfilteran multi-level Insight. Misalnya, aturan iklan dapat difilter berdasarkan kinerja set iklan atau kampanye iklan. Anda juga dapat menentukan jendela atribusi dan awalan preset waktu pada filter. Ini digunakan untuk mengganti jendela atribusi aturan dan preset waktu untuk filter khusus ini.

Penggunaan

Awalan bersifat opsional. Kolom dapat memiliki:

  • awalan level objek
  • awalan jendela atribusi
  • awalan preset waktu

Anda dapat menggunakan semua opsi di atas, tidak sama sekali, atau kombinasi, asalkan sesuai urutan itu. Kolom harus memiliki format berikut:

{ object_level_prefix? } {attribution_window_prefix?} { time_preset_prefix? } { field_name }

Di bawah ini, lihat contoh kolom Insight berawalan yang benar dan salah. Kami juga memberikan contoh kolom metadata berawalan yang benar dan salah, untuk menunjukkan filter metadata yang kami dukung.

Contoh untuk kolom Insight spent
Contoh yang benar

adset.yesterday_spent - total jumlah yang dibelanjakan di level set iklan kemarin

adset.spent - total jumlah yang dibelanjakan di level set iklan

yesterday_spent - total jumlah yang dibelanjakan kemarin

campaign.28d_view_1d_click:lifetime_results - total hasil di level set iklan selama masa aktifnya, dengan jendela atribusi 28 hari setelah ditayangkan dan 1 hari setelah diklik

campaign.lifetime_spent - total jumlah yang dibelanjakan di level kampanye iklan selama masa aktifnya

Contoh yang keliru

lifetime_campaign.spent - awalan preset waktu tidak boleh mendahului awalan level objek

lifetime_today_spent - tidak boleh ada dua awalan preset waktu

ad.adset.spent - tidak boleh ada dua awalan level objek

yesterday.adset_spent - pemisah yang salah


Contoh untuk kolom Metadata daily_budget
Contoh yang benar

adset.daily_budget - anggaran harian set iklan

daily_budget - anggaran harian

Contoh yang keliru

yesterday_daily_budget - tidak boleh menggunakan awalan preset di kolom Metadata

ad.daily_budget - iklan tidak memiliki anggaran harian

Awalan Level Objek

AwalanJenis ObjekValid pada Jenis Objek

ad.

Iklan

Iklan

adset.

Set Iklan

Iklan, Set Iklan

campaign.

Kampanye

Iklan, Set Iklan, Kampanye

Awalan Jendela Atribusi

Awalan Jendela Atribusi Deskripsi

account_default:

Menggunakan pengaturan jendela atribusi level akun

default:

Jendela atribusi default Facebook adalah penayangan 1 hari, klik 28 hari

inline:

Atribusi inline saja (0 hari penayangan, 0 hari klik)

1d_view:

1 hari penayangan, 0 hari klik

7d_view:

7 hari penayangan, 0 hari klik

28d_view:

28 hari penayangan, 0 hari klik

1d_click:

0 hari penayangan, 1 hari klik

7d_click:

0 hari penayangan, 7 hari klik

28d_click:

0 hari penayangan, 28 hari klik

1d_view_1d_click:

1 hari penayangan, 1 hari klik

7d_view_1d_click:

7 hari penayangan, 1 hari klik

28d_view_1d_click:

28 hari penayangan, 1 hari klik

1d_view_7d_click:

1 hari penayangan, 7 hari klik

7d_view_7d_click:

7 hari penayangan, 7 hari klik

28d_view_7d_click:

28 hari penayangan, 7 hari klik

7d_view_28d_click:

7 hari penayangan, 28 hari klik

28d_view_28d_click:

28 hari penayangan, 28 hari klik

Awalan Preset Waktu

Daftar ini sama dengan daftar nilai preset waktu yang valid, tetapi dibuat menjadi huruf kecil dan dilampirkan dengan pemisah.

Awalan Deskripsi

lifetime_

Masa aktif objek

today_

Hari ini mulai dari tengah malam dalam zona waktu akun iklan

last_2_days_

YESTERDAY dan TODAY

last_3_days_

2 hari penuh terakhir dan TODAY

last_7_days_

6 hari penuh terakhir dan TODAY

last_14_days_

13 hari penuh terakhir dan TODAY

last_28_days_

27 hari penuh terakhir dan TODAY

last_30_days_

29 hari penuh terakhir dan TODAY

this_month_

Bulan ini, termasuk TODAY

this_week_mon_today_

Minggu ini dengan hari Senin sebagai hari pertama dalam seminggu, termasuk TODAY

this_week_sun_today

Minggu ini dengan hari Minggu sebagai hari pertama dalam seminggu, termasuk TODAY

yesterday_

Satu hari penuh sebelumnya, tidak termasuk TODAY

last_2d_

2 hari penuh terakhir, tidak termasuk TODAY

last_3d_

3 hari penuh terakhir, tidak termasuk TODAY

last_7d_

7 hari penuh terakhir, tidak termasuk TODAY

last_14d_

14 hari penuh terakhir, tidak termasuk TODAY

last_28d_

28 hari penuh terakhir, tidak termasuk TODAY

last_30d_

30 hari penuh terakhir, tidak termasuk TODAY

last_nd_14_8_

14 hari terakhir hingga 7 hari terakhir, untuk ROAS

last_nd_30_8_

30 hari terakhir hingga 7 hari terakhir, untuk ROAS

last_nd_60_8_

60 hari terakhir hingga 7 hari terakhir, untuk ROAS

last_nd_120_8_

120 hari terakhir hingga 7 hari terakhir, untuk ROAS

last_nd_180_8_

180 hari terakhir hingga 7 hari terakhir, untuk ROAS

last_nd_lifetime_8_

Masa aktif hingga 7 hari terakhir, untuk ROAS

last_nd_60_29_

60 hari terakhir hingga 28 hari terakhir, untuk ROAS

last_nd_120_20_

120 hari terakhir hingga 28 hari terakhir, untuk ROAS

last_nd_180_29_

180 hari terakhir hingga 28 hari terakhir, untuk ROAS

last_nd_lifetime_29_

Masa aktif hingga 28 hari terakhir, untuk ROAS

Agregasi

Anda bisa menggabungkan beberapa kolom Insight ke beberapa objek iklan. Dengan begitu, Anda dapat membuat filter di metrik subset objek iklan tertentu. Misalnya, total jangkauan pada beberapa iklan atau jumlah total klik pada set iklan yang berbeda.

Sementara beberapa metrik seperti clicks dihitung dengan penjumlahan sederhana, metrik lain seperti reach dihitung dengan cara berbeda. Karena reach didasarkan pada jumlah impresi unik, pengguna duplikat akan dihapus dalam agregasi beberapa objek iklan.

Penggunaan

Kolom agregat mengambil bentuk aggregate({ field }). field dapat berisi jendela atribusi dan awalan preset waktu. Kumpulan objek iklan yang hendak diagregasi ditentukan oleh kolom filter wajib lainnya, aggregation_id.

Contoh Kolom Agregat

Contoh yang benar

aggregate(reach)

aggregate(lifetime_reach)

Contoh yang keliru

aggregate(daily_budget)

aggregate(adset.reach)

Filter ID Agregasi

Filter aggregation_id menentukan objek iklan yang hendak diagregasi. Ini hanya mendukung operator IN dan daftar id sebagai nilainya. ID dapat berupa iklan, set iklan, atau kampanye iklan, tetapi semuanya harus berasal dari level objek yang sama.

Contoh filter aggregation_id

{
  "field": "aggregation_id",
  "operator": "IN",
  "value": [1234, 5678]
},
{
  "field": "aggregate(reach)",
  "operator": "GREATER_THAN",
  "value": 100
}

Kolom yang Didukung

  • clicks
  • cpc
  • cpm
  • cpp
  • ctr
  • frequency
  • impressions
  • mobile_app_purchase_roas
  • reach
  • result_rate
  • spent
  • unique_clicks
  • unique_impressions
  • website_purchase_roas
  • cost_per_unique_click

Kolom Formula

Anda dapat mengatur ekspresi aritmetika sederhana sebagai kolom. Misalnya, ini dapat digunakan untuk menemukan rasio antara dua kolom numerik.

Ini berfungsi pada kolom Insight dan pada subset kolom Metadata numerik. Daftar lengkap yang didukung ada di bawah ini.

Penggunaan

Kolom formula terdiri dari kolom atau konstanta dan operator yang benar secara sintaksis dipisahkan oleh spasi. Ini mendukung operator +-* dan /. Anda dapat menambahkan konstanta, misalnya untuk memboboti kolom tertentu atau bertindak sebagai ofset.

Kolom dalam hal ini dapat sepenuhnya diberi awalan, sehingga Anda dapat menambahkan level objek yang valid dan awalan preset waktu.

Saat ini kami mengizinkan maksimum 6 kolom non-konstanta dalam formula. Anda dapat memiliki konstanta sebanyak yang Anda inginkan.

today_spent / adset.today_spent

0.8 * cpc + 0.2 * cpm

{ field_or_constant_1 } { + | - | * | / } { field_or_constant_2 }

Contoh Formula

Contoh yang benar

today_spent / adset.daily_budget - persentase anggaran harian

clicks / adset.clicks - rasio klik dibandingkan dengan klik set iklan

today_impressions / yesterday_impressions - rasio jumlah impresi hari ini dibandingkan dengan jumlah impresi kemarin

today_impressions / aggregate(today_impressions) - rasio jumlah impresi hari ini dibandingkan dengan jumlah impresi agregat

(adset.spent - spent) - tanda kurung boleh digunakan, saat menerima formula dalam tanggapan API, formula tersebut akan diberi tanda kurung

Contoh yang keliru

(clicks + cpc + cpm + ctr + cpa + cpp) / cost_per - tidak boleh menggunakan lebih dari 6 kolom

today_impressions/yesterday_impressions - komponen harus dipisahkan spasi

Kolom Metadata Numerik yang Valid

KolomValid pada Jenis Objek

bid_amount

Iklan, Set Iklan

daily_budget

Set Iklan

lifetime_budget

Set Iklan

spend_cap

Kampanye