Marketing API

Penargetan Terperinci

Dengan Pencarian Penargetan, Anda dapat menemukan penargetan dengan satu jenis penargetan dalam satu panggilan API. Dengan API Penargetan Terperinci, Anda dapat mencari beberapa jenis penargetan dalam satu permintaan secara bersamaan. Anda juga bisa mendapatkan saran berdasarkan kueri Anda.

API memiliki empat endpoint: Pencarian, Saran, Jelajahi, dan Validasi.

Tanggapan untuk endpoint ini berisi hal berikut:

Nama Deskripsi

id

jenis: string

ID pemirsa target

name

jenis: string

Nama pemirsa target

audience_size_lower_bound

bilangan bulat

Estimasi batas bawah ukuran pemirsa target

audience_size_upper_bound

bilangan bulat

Estimasi batas atas ukuran pemirsa target

path

jenis: array string

Mencakup kategori dan semua kategori induk penargetan ini

description

jenis: string

Deskripsi singkat tentang target pemirsa

Jika Anda tidak memberikan limit_type, kami memfilter hasil kurang dari 2000 orang ke dalam empat kategori: work_employers, work_positions, education_majors, education_schools. Jika tidak, hasil yang diperoleh kurang bermakna. Saat Anda menggunakan limit_type kami memfilter salah satu dari empat kategori tersebut dan tidak akan mengembalikan semuanya.

Dapatkan pemirsa target untuk iklan Anda yang sesuai dengan kueri pencarian. Anda dapat menyediakan parameter berikut pada endpoint ini:

curl -G \
-d "q=harvard" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsearch
Nama Deskripsi

q

jenis: string

Wajib.

String kueri

limit

jenis: bilangan bulat

Opsional.

Jumlah hasil

limit_type

jenis: string

Opsional.

Batasi jenis pemirsa yang akan diambil. Default-nya semua jenis.

Nilai yang valid:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

jenis: string

Opsional.

Bahasa untuk menampilkan nama dan deskripsi pemirsa, jika tersedia. Default-nya adalah bahasa akun iklan

Saran

Mengembalikan pemirsa tambahan yang dapat Anda targetkan berdasarkan beberapa pemirsa terpilih yang Anda masukkan.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003263791114}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsuggestions

Masukkan parameter ini:

Nama Deskripsi

targeting_list

jenis: Array {'type':'{TYPE}', 'id':{ID}}

Wajib.

Array pasangan {'type':'{TYPE}', 'id':{ID}} sebagai masukan untuk saran pemirsa.

limit

jenis: bilangan bulat

Opsional.

Jumlah hasil. Default-nya adalah 30. Maksimum adalah 45.

limit_type

jenis: string

Opsional.

Batasi jenis pemirsa yang akan diambil. Default-nya semua jenis

Nilai yang valid:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

jenis: string

Opsional.

Bahasa untuk menampilkan nama dan deskripsi pemirsa. Default-nya adalah bahasa akun iklan

Jelajahi

Dapatkan penargetan dalam Taksonomi terstruktur untuk kategori Facebook, penyedia data pihak ketiga, dan minat tertentu. Hasil dari endpoint ini muncul di fungsionalitas Jelajahi dalam komponen UI Penargetan Terperinci di Pengelola Iklan.

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingbrowse

Masukkan parameter opsional berikut:

Nama Deskripsi

limit_type

jenis: string

Batasi jenis pemirsa yang akan diambil. Default-nya semua jenis.

locale

jenis: string

Bahasa untuk menampilkan nama dan deskripsi pemirsa. Default-nya adalah bahasa akun iklan

Validasi

Pastikan pemirsa valid atau tidak untuk penargetan. Ini sangat membantu jika Anda sudah membuat set iklan dan ingin memastikan bahwa spesifikasi targetnya masih berlaku. Jika penargetan tidak valid, Anda harus menghapusnya dari spesifikasi penargetan.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003283735711}, {'type':'relationship_statuses','id':100}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingvalidation

Selain kolom tanggapan Penargetan Terperinci standar, endpoint ini juga mengembalikan:

Nama deskripsi

valid

jenis: boolean

Apakah pemirsa penargetan valid atau tidak

Berikut adalah daftar parameter input:

Nama Deskripsi

targeting_list

jenis: Array {'type':'{TYPE}', 'id':{ID}}

Array pasangan {'type':'{TYPE}', 'id':{ID}} untuk validasi. Sebaiknya ada.

id_list

jenis: array string

Array ID untuk validasi. Hanya berhasil jika ID dapat diidentifikasi secara unik dalam basis data pemirsa kami

name_list

jenis: array string

Array String untuk validasi. Hanya minat, tidak peka huruf besar-kecil

locale

jenis: string

Bahasa untuk menampilkan nama dan deskripsi pemirsa. Default-nya adalah bahasa akun iklan

Masukkan setidaknya salah satu dari yang berikut ini: targeting_list, id_list, dan name_list.