Interaksi Pemirsa Khusus

Buat pemirsa berdasarkan orang yang berinteraksi dengan konten Anda di Facebook atau Instagram. Jenis pemirsa yang didukung saat ini termasuk Halaman, profil Instagram for Business, iklan Prospek, iklan Instant Experience, Belanja, dan augmented reality.

Panduan ini menggambarkan API dengan menggunakan pemirsa interaksi Halaman sebagai contoh. Facebook memperbarui pemirsa khusus Anda untuk interaksi Halaman dengan terus menambahkan orang-orang yang berinteraksi dengan halaman Anda. Saat Anda pertama kali membuat pemirsa ini, Facebook mengisinya dengan daftar orang-orang yang sudah berinteraksi dengan Halaman Anda dalam periode retensi tertentu.

Sejak September 2018, kami tidak akan lagi mendukung subtype untuk pemirsa khusus situs web dan aplikasi, pemirsa khusus interaksi, serta pemirsa dari data konversi offline. Pengecualian adalah subtype didukung untuk pemirsa khusus interaksi untuk video.
Jika Anda membuat pemirsa dari Eropa atau menargetkan orang-orang di Eropa, lihat perubahan non-versi 2 Des 2020 kami.

Membuat Pemirsa

Untuk membuat pemirsa khusus interaksi, akun iklan Anda harus menerima Ketentuan Layanan untuk Pemirsa Khusus, di Pengelola Iklan.

Untuk membuat pemirsa yang mencantumkan orang yang berinteraksi dengan Halaman Anda berdasarkan peristiwa page_engaged:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Parameter

Nama	Deskripsi
`name` string	Wajib. Nama pemirsa khusus.
`rule` Objek JSON	Wajib. Aturan untuk mendefinisikan pemirsa. Mengikuti sintaksis yang sama dengan pemirsa khusus situs web.

Pemirsa khusus interaksi adalah jenis pemirsa khusus. Untuk semua kolom yang tersedia, lihat Referensi Pemirsa Khusus.

Catatan: Setiap akun iklan dapat membuat maksimal 500 pemirsa khusus interaksi.

Aturan Interaksi

Anda dapat menentukan apakah Facebook menambahkan seseorang ke pemirsa khusus atau tidak dengan Aturan Pemirsa.

Tentukan kolom type dan id dalam event_sources pada aturan untuk menandakan type dan id dari objek interaksi. Kolom id mengambil ID satu objek, atau deret ID dari jenis yang sama.

Ini adalah sumber peristiwa yang didukung dan ID objek interaksi yang sesuai:

page: ID halaman Facebook.
lead: ID formulir prospek.
ig_lead_generation: ID formulir prospek.
canvas: ID Canvas.
ig_business: ID profil Instagram for Business.
shopping_page: ID Halaman Facebook Shop Anda.
shopping_ig: ID Instagram Shop.
ar_experience: Instant Experience yang menggunakan efek AR.
ar_effects: Efek Facebook atau Instagram yang Anda miliki. Ini tidak termasuk efek yang digunakan dalam iklan.

Setiap aturan terdiri dari object_id dan event_name.

Halaman

Atur object_id ke ID Halaman Anda. Di bawah event_name, gunakan salah satu peristiwa interaksi berikut:

page_engaged: Orang yang mengunjungi halaman Anda atau berinteraksi dengan konten atau iklan Halaman, di Facebook atau Messenger. Ini merupakan jenis interaksi yang paling inklusif dan mencakup semua jenis interaksi lainnya.
page_visited: Orang yang telah mengunjungi Halaman Anda.
page_liked: Orang yang saat ini menyukai Halaman Anda. (Lihat detail tentang retensi dan aturan yang terkait dengan suka Halaman)
page_messaged: Orang yang pernah mengirimkan pesan ke Halaman Anda.
page_cta_clicked: Orang yang telah mengeklik tombol ajakan bertindak di Halaman Anda (misalnya: "Hubungi kami" atau "Beli Sekarang").
page_or_post_save: Orang yang telah menyimpan Halaman atau salah satu postingan Halaman Anda.
page_post_interaction: Orang yang telah berinteraksi dengan salah satu postingan Halaman Anda. Interaksi mencakup reaksi (Suka, Super, Haha, Wow, Sedih, Marah), berbagi, komentar, klik tautan, atau usap carousel.

Iklan Prospek

Atur object_id ke FORM_ID dan atur rule untuk melacak salah satu peristiwa iklan prospek berikut:

lead_generation_submitted: Semua pengguna yang menyelesaikan formulir dan mengirimnya.
lead_generation_dropoff: Semua orang yang menutup formulir tanpa mengirimnya. Mereka mungkin sudah atau belum mengisi salah satu kolom.
lead_generation_opened: Semua orang yang membuka formulir penciptaan prospek tanpa melihat apakah mereka mengirim formulir atau tidak.

Instant Experience

Atur object_id ke "CANVAS_ID". rule harus melacak salah satu peristiwa berikut:

instant_shopping_document_open
instant_shopping_document_pause
instant_shopping_document_resume
instant_shopping_document_close
instant_shopping_did_scroll
instant_shopping_element_click
instant_shopping_element_impression

Profil Instagram for Business

object_id harus adalah "INSTAGRAM_BUSINESS_PROFILE_ID", dan rule harus melacak salah satu peristiwa profil Instagram for Business berikut:

ig_business_profile_all: Orang yang mengunjungi profil Instagram for Business Anda atau berinteraksi dengan konten atau iklan profil Instagram for Business Anda. Ini merupakan jenis interaksi yang paling inklusif dan mencakup semua jenis interaksi lainnya. Ini gabungan dari ig_business_profile_engaged, ig_user_messaged_business, dan ig_user_messaged_business.
ig_business_profile_engaged: Orang yang berinteraksi dengan profil Instagram for Business Anda atau berinteraksi dengan konten atau iklan profil Instagram for Business Anda.
ig_user_messaged_business: Orang yang mengirimkan pesan ke profil Instagram for Business Anda.
ig_business_profile_visit: Orang yang mengunjungi profil Instagram for Business Anda.
ig_business_profile_ad_saved: Orang yang menyimpan konten atau iklan organik dari profil Instagram for Business Anda.
ig_ad_like
ig_ad_comment
ig_ad_share
ig_ad_save
ig_ad_cta_click
ig_ad_carousel_swipe
ig_organic_like
ig_organic_comment
ig_organic_share
ig_organic_save
ig_organic_swipe
ig_organic_carousel_swipe

Jenis Kreator Media Instagram saat ini tidak didukung untuk pembuatan pemirsa khusus interaksi video.

Belanja

Aturan interaksi belanja harus melacak salah satu peristiwa berikut:

VIEW_CONTENT: Orang-orang yang telah melihat halaman detail produk Anda. Opsi ini tersedia di seluruh dunia.
ADD_TO_CART: Orang-orang yang telah menambahkan produk Anda ke keranjang belanja mereka. Ini hanya tersedia untuk bisnis yang mengaktifkan pembayaran, dan hanya untuk konsumen di Amerika Serikat.
PURCHASE: Orang yang telah membeli produk Anda. Ini hanya tersedia untuk bisnis yang mengaktifkan proses pembayaran, dan hanya untuk konsumen di Amerika Serikat.

Untuk membuat aturan yang menambahkan orang yang telah melihat produk Anda:

curl -i -X POST
-F 'name="test_api"'\
-F 'rule= {
	"inclusions": {
		"operator": "or",
		"rules": [
			{
				"event_sources": [
					{
						"id": "<ID>",
						"type": "shopping_ig"
					}
				]
				"retention_seconds": <RETENTION_SECONDS>,
				"filter": {
					"operator": "and",
					"filters": [
						{
						"field":"event",
						"operator":"eq",
						"value": "VIEW_CONTENT"
						}
					]
				}
			}
		]
	}
}
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Parameter page_messaged dan ig_user_messaged_business mungkin tidak tersedia di Eropa karena aturan privasi baru.

Augmented Reality

Pemirsa khusus interaksi augmented reality dapat berisi dua bagian: Pengalaman AR dan efek AR.

Untuk pemirsa khusus interaksi pengalaman AR, atur object_id ke ID kontainer data iklan AR dan untuk event_name yang diajukan, gunakan ar_camera_open atau camera_cta_click.
Untuk pemirsa khusus interaksi efek AR, atur object_id ke ID efek AR dan gunakan ar_effect_open untuk kolom event_name.

Jumlah Hari Retensi Maks

Untuk persyaratan hukum dan privasi, kami mengizinkan jumlah hari retensi maksimal yang berbeda untuk tiap jenis sumber peristiwa:

Iklan Penciptaan Prospek: 90 hari
Profil Instagram for Business: 730 hari
Halaman: 730 hari
- Catatan: Pemirsa suka Halaman tidak memiliki retensi
Instant Experience, tadinya dikenal sebagai Canvas: 730 hari
Belanja: 365 hari. Data tersedia mulai April 2020.
Augmented reality: 365 hari

Aturan Interaksi dengan Bagian Pengecualian

Aturan pemirsa interaksi kompatibel dengan aturan pemirsa khusus situs web. Oleh karena itu, mereka dapat memiliki beberapa aturan penyertaan dan pengecualian. Pengguna yang cocok dengan setidaknya salah satu aturan akan ditambahkan ke pemirsa.

Pada contoh berikut, kami membuat pemirsa yang menyertakan pengguna yang mengunjungi halaman Anda atau berinteraksi dengan halaman Anda, tetapi mengecualikan orang yang mengeklik ajakan bertindak:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       },
       "exclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_cta_clicked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Untuk informasi selengkapnya, lihat Pemirsa Khusus dari Situs Web Anda.

Beberapa Aturan

Pemirsa interaksi dapat memiliki beberapa aturan, dan pengguna yang cocok dengan setidaknya satu aturan akan ditambahkan ke pemirsa. Contoh pembuatan pemirsa yang mencakup pengguna yang pernah mengirimkan pesan ke halaman atau mengeklik ajakan untuk bertindak:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 },
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Beberapa Halaman

Aturan tidak terbatas pada satu halaman. Anda dapat memiliki halaman yang berbeda untuk tiap aturan, dan orang yang berinteraksi dengan minimal satu halaman, dan kami menyertakannya ke dalam pemirsa.

Berikut adalah contoh pemirsa yang mencakup semua orang yang pernah mengunjungi minimal satu dari tiga halaman:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               },
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Untuk mengetahui detail tentang Pemirsa Khusus, lihat Referensi Pemirsa Khusus.

Retensi dan Aturan Suka Halaman

Pemirsa suka Halaman tidak memiliki retensi (retention_seconds=0). Selain itu, aturan suka Halaman tidak dapat digabungkan dengan peristiwa Halaman lainnya.

Berikut ini adalah contoh pembuatan pemirsa suka Halaman:

curl -X POST \
  -F 'name="Page Likes Audience Name"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 0,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_liked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences