Marketing API

Gambaran Umum Pemirsa

Penargetan pemirsa membantu Anda menampilkan iklan kepada orang-orang yang diinginkan. Ada dua pendekatan umum yang dapat diambil saat membuat pemirsa target:

  • Spesifik — Anda menetapkan serangkaian parameter yang relatif ketat, dan kami membuat pemirsa dalam parameter tersebut. Pendekatan ini mencakup Pemirsa Khusus, Pemirsa Serupa, dan Pemirsa Dinamis.
  • Luas — Anda mengandalkan sistem penayangan kami untuk menemukan orang-orang yang paling tepat untuk ditunjuki iklan Anda. Tetapkan batasan dasar, seperti demografi atau lokasi, maka kami menayangkan iklan kepada orang-orang yang memenuhi atribut tersebut.

Dokumen ini berisi ringkasan opsi penargetan pemirsa yang ditawarkan oleh Marketing API.

Pemirsa Khusus

Pemirsa Khusus adalah opsi untuk membuat pemirsa sendiri dari serangkaian sumber berbeda, termasuk daftar pelanggan, traffic situs web atau aplikasi, dan interaksi di Facebook.

Beberapa pemirsa mungkin mengharuskan Anda membuat aturan pemirsa untuk menentukan apakah seseorang harus ditambahkan ke Pemirsa Khusus Anda.

Izin

Izin ads_management diperlukan untuk membuat dan memperbarui pemirsa khusus.

Jenis Pemirsa Khusus

Pemirsa Khusus File Pelanggan

Buat Pemirsa Khusus target dari informasi pelanggan. Ini termasuk alamat email, nomor telepon, nama, tanggal lahir, jenis kelamin, lokasi, ID Pengguna Aplikasi, ID Pengguna Lingkup Halaman, Pengidentifikasi Periklanan Apple (IDFA), atau ID Periklanan Android.

Pemirsa Khusus Interaksi

Buat pemirsa berdasarkan orang yang berinteraksi dengan konten Anda di Facebook atau Instagram. Jenis pemirsa yang didukung saat ini mencakup Halaman, profil bisnis Instagram, iklan Prospek, dan iklan Instant Experience.

Pemirsa Khusus Aplikasi Seluler

Buat pemirsa berdasarkan tindakan pengguna di aplikasi Anda, yang sesuai dengan kriteria Anda. Solusi ini menggunakan peristiwa bernama yang dicatat melalui Facebook SDK, App Events API, atau melalui Mitra Pengukuran Seluler kami.

Pemirsa Khusus Situs Web

Buat Pemirsa Khusus dari pengguna yang mengunjungi atau mengambil tindakan tertentu di situs web Anda menggunakan Facebook Pixel, JavaScript Tag API, dan aturan pemirsa. Setelah Anda membuat Pemirsa Khusus dengan data situs web, referensikan pemirsa tersebut dalam penargetan iklan, seperti saat mereferensikan Pemirsa Khusus standar.

Pemirsa Khusus Offline

Kelompokkan orang yang mengunjungi toko Anda, menelepon layanan pelanggan Anda, atau mengambil tindakan offline bersama, lalu targetkan mereka dengan iklan Facebook. Pemirsa Khusus dari Konversi Offline didasarkan pada peristiwa konversi yang diunggah ke Kumpulan Peristiwa Offline.

Pemirsa Dinamis

Iklan Dinamis memungkinkan Anda menampilkan iklan kepada orang berdasarkan minat pembelian lintas-perangkat mereka. Anda dapat mengumpulkan sinyal minat pengguna dari aplikasi seluler dan situs web, lalu menggunakan data ini untuk membuat pemirsa guna menargetkan calon pelanggan.

Pemirsa Serupa

Targetkan orang yang paling mirip dengan pelanggan lama Anda. Pemirsa serupa mengambil beberapa kelompok orang sebagai "seed", kemudian Facebook membuat pemirsa serupa. Anda dapat menggunakan pemirsa serupa untuk tujuan bisnis apa pun — menargetkan orang yang serupa dengan pelanggan Anda untuk akuisisi penggemar, pendaftaran situs, pembelian di luar Facebook, klaim kupon, atau sekadar untuk mendorong kesadaran akan suatu merek.

Berbagi Pemirsa Khusus

Anda dapat memilih untuk berbagi Pemirsa Khusus Anda dengan bisnis lain, seperti mitra yang mengelola dan menjalankan iklan Anda. Ada persyaratan dan API tertentu yang harus diikuti saat berbagi. Pelajari selengkapnya tentang Fungsi Bisnis-ke-Bisnis.

Penghapusan Pemirsa Khusus

Untuk semua pengiklan mulai tanggal 8 Juni 2021 dan seterusnya, kami akan secara otomatis memindahkan pemirsa ke tahap “Pemirsa Kedaluwarsa” setelah mereka tidak aktif selama lebih dari dua tahun. Ini berarti bahwa setelah pemirsa memenuhi ambang batas untuk tidak digunakan dalam set iklan aktif selama lebih dari dua tahun, itu akan secara otomatis ditandai sebagai "Pemirsa Kedaluwarsa", dan kolom delete_time akan ditandai dengan perkiraan waktu penghapusan (yaitu, 90 hari sejak waktu penandaan) saat pemirsa dijadwalkan untuk dihapus.

Anda kemudian dapat menghapus pemirsa secara proaktif atau menggunakan pemirsa di set iklan aktif untuk mencegah penghapusan. Anda dapat melihat pemirsa mana yang berada dalam tahap kedaluwarsa kapan saja dengan memfilter kolom operation_status atau delete_time.

Untuk Pemirsa Khusus Daftar Pelanggan, khususnya, Anda harus memberikan instruksi kepada kami sebelum kami mengambil tindakan apa pun. Setelah pemirsa dipindahkan ke tahap "Pemirsa Kedaluwarsa" dan ditandai, Anda harus memberikan instruksi dengan menggunakan pemirsa yang ditandai itu di set iklan aktif, yang akan kami anggap sebagai instruksi untuk mempertahankan pemirsa itu, atau dengan memutuskan untuk tidak menggunakan pemirsa yang ditandai itu di set iklan aktif, yang akan kami anggap sebagai instruksi untuk menghapus pemirsa itu.

Pemirsa Khusus

Endpoint:GET /{CUSTOM_AUDIENCE_ID}

Kolom pemirsa khusus operation_status kini memiliki opsi status EXPIRING, yang akan ditambahkan ke pemirsa yang tidak pernah digunakan dalam set iklan aktif selama 2 tahun terakhir. Ketika suatu pemirsa telah ditandai sebagai kedaluwarsa, kolom delete_time menunjukkan kapan pemirsa itu akan dihapus.

Contoh Tanggapan

delete_time: 1620543600 // Unix time in secs for 9 May 2021
operation_status: {
  “status”: 100
  “description”: "If an audience hasn't been used in an active ad set for over 2 years, it will begin to expire. Expiring audiences that remain unused for 90 days will be deleted."
}

Akun Iklan

Endpoint:GET /act_{AD_ACCOUNT_ID]/customaudiences

Anda kini dapat memfilter pemirsa khusus untuk melihat pemirsa yang operation_status-nya EXPIRING atau pemirsa yang memiliki delete_time yang menandakan bahwa pemirsa tersebut akan segera dihapus. Filter baru ini akan menghasilkan ID pemirsa.

Contoh Permintaan

GET /act_217284683/customaudiences?filtering=[{"field":"delete_time","operator":"GREATER_THAN","value":0}]&fields=["name", "operation_status","delete_time"]
 
GET /act_217284683/customaudiences?filtering=[{"field":"operation_status.code","operator":"IN","value":[100]}]&fields=["name", "operation_status","delete_time"]']

Endpoint:GET /act_{AD_ACCOUNT_ID}/saved_audiences

Anda sekarang dapat memfilter pemirsa tersimpan berdasarkan delete_time untuk melihat pemirsa yang akan segera dihapus. Filter ini menghasilkan ID pemirsa.

Contoh Permintaan

GET /act_217284683/saved_audiences?filtering=[{"field":"delete_time","operator":"GREATER_THAN","value":0}]

Pemirsa Tersimpan

Endpoint:GET /{SAVED_AUDIENCE_ID}

Kolom operation_status untuk pemirsa tersimpan kini memiliki opsi status EXPIRING, yang akan ditambahkan ke pemirsa yang tidak pernah digunakan dalam set iklan aktif selama 2 tahun terakhir. Ketika suatu pemirsa telah ditandai sebagai kedaluwarsa, kolom delete_time menunjukkan kapan pemirsa itu akan dihapus.

Contoh Tanggapan

delete_time: 1620543600 // Unix time in secs for 9 May 2021
operation_status: {
  "status": 100
  "description": "If an audience hasn't been used in an active ad set for over 2 years, it will begin to expire. Expiring audiences that remain unused for 90 days will be deleted."
}

Pertanyaan Umum

Any Custom Audience, Lookalike Audience, or Saved Audience which has not been used in any active ad sets in over two years will be included in this update. Note: This is a rolling change going forward.

Tautan Permanen

If you do not wish for the identified audiences to be deleted, you will be required to include the audiences marked as “Expiring Audience” in an active ad set prior to the deletion date shown in the delete_time field, which is 90 days after the audience is flagged, to keep it from being deleted.

For Customer List Custom Audiences, specifically, you will need to provide us with your instructions by either using the flagged audience in an active ad set, which we will consider an instruction to retain the audience, or by deciding not to use the flagged audience in an active ad set, which we will consider an instruction to delete the audience.

Tautan Permanen

The system will automatically delete the audience that has had an EXPIRING status for more than 90 days.

Tautan Permanen

Penargetan

Spesifikasi penargetan adalah atribut set iklan yang menentukan siapa yang melihat suatu iklan. Penargetan dasar atau inti meliputi:

Biasanya untuk menentukan penargetan Anda mendapat data dari Pencarian Penargetan, lalu menentukan opsi dalam Spesifikasi Penargetan. Anda harus menentukan setidaknya satu negara dalam penargetan, kecuali Anda menggunakan Pemirsa Khusus.

Pengiklan yang menayangkan iklan perumahan, lowongan kerja, dan kredit, yang berbasis di Amerika Serikat atau menayangkan iklan yang ditargetkan ke Amerika Serikat memiliki set batasan yang berbeda. Lihat Kategori Iklan Khusus.

Lihat Juga