Dokumen ini sudah diperbarui.
Terjemahan ke Bahasa Indonesia belum selesai.
Bahasa Inggris diperbarui: 12 Sep 2023

Spesifikasi Pelacakan dan Konversi

Dengan Spesifikasi Pelacakan, Anda dapat mencatat tindakan yang diambil oleh orang-orang di iklan Anda. Fitur ini tidak mengoptimalkan penayangan iklan untuk sebuah tindakan, maupun mengenakan tagihan kepada akun iklan Anda berdasarkan tindakan yang terjadi tersebut.

Dalam Marketing API v2.3 dan yang lebih lama, Spesifikasi Konversi merupakan pengaturan iklan untuk CPM yang Dioptimalkan. Spesifikasi tersebut mengoptimalkan penayangan iklan untuk tindakan tertentu dan menunjukkan tindakan tersebut di laporan konversi. Setelah v2.4, conversion_specs kini hanya bisa dibaca saja. Gunakan optimization_goal di set iklan untuk memilih pengoptimalan penayangan iklan.

Tetapkan Spesifikasi Pelacakan

Gunakan dengan jenis tawaran dan materi iklan apa pun. Untuk menentukan spesifikasi pelacakan, Anda memerlukan kolom tambahan di dalam iklan yang bernama tracking_specs. Kolom tracking_specs mengambil argumen yang identik dengan spesifikasi tindakan. Untuk membuat iklan, lihat pembuatan iklan.

Spesifikasi Pelacakan Default

Untuk tujuan iklan berikut, spesifikasi pelacakan default akan berlaku. Jika Anda beralih ke spesifikasi default, maka pelacakan akan ditambahkan ke spesifikasi yang sudah ada ketimbang menimpa yang sudah ada.

Jika tujuan Anda adalah NONE atau App Install/Engagement Ads, maka spesifikasi pelacakan default akan ditimpa. Jika Anda ingin memiliki spesifikasi default, maka Anda harus menambahkannya ke spesifikasi khusus Anda.

Anda dapat menggunakan notasi string maupun susunan di spesifikasi seperti 'APPLICATION_ID' atau ['APPLICATION_ID'].

  • CPM mengacu pada billing_event=IMPRESSIONS, optimization_goal=IMPRESSIONS
  • CPC mengacu pada billing_event=CLICKS, optimization_goal=CLICKS
  • oCPM mengacu pada billing_event=IMPRESSIONS, optimization_goal yang ditetapkan ke sebuah tindakan
  • CPA mengacu pada billing_event dan optimization_goal yang ditetapkan ke sebuah tindakan
Tujuan Materi Iklan, Jenis tawaran Spesifikasi Pelacakan Deskripsi

CANVAS_APP_
ENGAGEMENT

Iklan interaksi aplikasi Canvas dengan optimization_goal= APP_INSTALLS

[{'action.type':
'app_engagement',
'application':
'APPLICATION_ID'}, {'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}]

Lihat spesifikasi meta app_engagement dan post_engagement

CANVAS_APP_
INSTALLS

Iklan instalasi aplikasi Canvas dengan pengoptimalan tidak ditetapkan menjadi optimization_goal= APP_INSTALLS

[{'action.type':
'app_engagement',
'application':
'APPLICATION_ID'}, {'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}]

Lihat spesifikasi meta app_engagement dan post_engagement

KONVERSI

Tautan postingan halaman dan iklan foto dengan promoted_object ditetapkan ke ID pixel dan optimization_goal= OFFSITE_CONVERSIONS

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'},
{'action.type':'like',
'page':PAGE_ID}

Spesifikasi Interaksi Postingan, Suka Halaman. Jumlah klik tautan di postingan halaman tertentu jika hanya ada satu tautan, jumlah interaksi di postingan, dan jumlah berapa kali pengguna menciptakan cerita atau berinteraksi dengan sebuah halaman

KONVERSI

Tautan postingan halaman dan iklan foto dengan pengoptimalan yang tidak ditetapkan ke optimization_goal= OFFSITE_CONVERSIONS

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}, {'action.type':{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'},
{'action.type':'like',
'page':PAGE_ID}

Spesifikasi Konversi, Interaksi Postingan, Suka Halaman. Jumlah klik tautan di postingan halaman tertentu jika hanya ada satu tautan, jumlah interaksi di postingan, dan jumlah berapa kali pengguna menciptakan cerita atau berinteraksi dengan sebuah halaman

KONVERSI

Iklan domain dengan promoted_object ditetapkan ke ID pixel dan optimization_goal= OFFSITE_CONVERSIONS

{'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

Spesifikasi Suka Halaman, Klik Tautan. Jumlah klik tautan di postingan halaman tertentu jika hanya ada satu tautan, jumlah interaksi di postingan, dan jumlah berapa kali pengguna menciptakan cerita atau berinteraksi dengan sebuah halaman.

KONVERSI

Iklan domain dengan pengoptimalan tidak ditetapkan menjadi optimization_goal= OFFSITE_CONVERSIONS

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}, {'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

Spesifikasi Konversi, Suka Halaman, Klik Tautan. Jumlah klik tautan di postingan halaman tertentu jika hanya ada satu tautan, jumlah interaksi di postingan, dan jumlah berapa kali pengguna menciptakan cerita atau berinteraksi dengan sebuah halaman.

EVENT_RESPONSES

Iklan peristiwa dengan pengoptimalan tidak ditetapkan menjadi optimization_goal= EVENT_RESPONSES

[{'action.type':'rsvp' ,
'response':'yes', 'event':'EVENT_ID'},
{'action.type':'rsvp' ,
'response':'maybe', 'event':'EVENT_ID'},
[{'action.type':'rsvp' ,
'response':'no', 'event':'EVENT_ID'}]

Jumlah konfirmasi kehadiran (ya, mungkin, tidak) untuk sebuah acara.

EVENT_RESPONSES

Iklan acara dengan optimization_goal= EVENT_RESPONSES

kosong (spesifikasi konversi akan menutupi tindakan yang dilacak)

Jumlah konfirmasi kehadiran (ya, mungkin, tidak) untuk sebuah acara.

LINK_CLICKS

Tautan postingan halaman dan iklan foto dengan opsi tawaran

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}

Interaksi Postingan.
Jumlah berapa kali tautan URL keluar situs, tautan dengan domain URL tertentu, tautan keluar situs di sebuah halaman, tautan keluar situs di sebuah postingan diklik.

LINK_CLICKS

Iklan domain dengan optimization_goal= LINK_CLICKS

{'action.type':'like',
'page':PAGE_ID}]

Suka Halaman.
Jumlah berapa kali tautan URL keluar situs, tautan dengan domain URL tertentu, tautan keluar situs di sebuah halaman, tautan keluar situs di sebuah postingan diklik.

LINK_CLICKS

Iklan domain dengan pengoptimalan tidak ditetapkan menjadi optimization_goal= LINK_CLICKS

{'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

Klik Situs Web, Suka Halaman.
Jumlah berapa kali tautan URL keluar situs, tautan dengan domain URL tertentu, tautan keluar situs di sebuah halaman, tautan keluar situs di sebuah postingan diklik.

MOBILE_APP_
ENGAGEMENT

Iklan interaksi aplikasi seluler dengan opsi tawaran

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}
For App Engagement Ads you must specify a tracking spec explicitly using the Facebook App ID:
[{'action.type': 'mobile_app_install', 'application': 'APP_ID'}, {'action.type':
'app_custom_event',
'application':APP_ID}]

Lihat spesifikasi meta post_engagement. Serta jumlah berapa kali peristiwa aplikasi terjadi.

MOBILE_APP_
INSTALLS

Iklan instalasi aplikasi seluler dengan opsi tawaran

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}
For App Install Ads you must specify a tracking spec explicitly using the Facebook App ID:
[{'action.type':
'app_custom_event',
'application':APP_ID}, {'action.type': 'mobile_app_install', 'application': 'APP_ID'}]

Lihat spesifikasi meta post_engagement. Serta jumlah berapa kali pengguna menginstal aplikasi melalui iklan instalasi aplikasi seluler jika ada versi iOS/Android dan jumlah berapa kali peristiwa aplikasi terjadi.

NONE

Jenis iklan apa pun

Lihat spesifikasi pelacakan default
berdasarkan jenis iklan

PAGE_LIKES

Iklan Suka halaman atau iklan postingan halaman dengan opsi tawaran

{'action.type':
'page_engagement', 'page':'PAGE_ID'}

Lihat spesifikasi meta Interaksi Halaman

POST_ENGAGEMENT

Iklan postingan halaman dengan pengoptimalan tidak ditetapkan menjadi optimization_goal= POST_ENGAGEMENT

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}

Lihat spesifikasi meta Interaksi Postingan Halaman

POST_ENGAGEMENT

Iklan postingan halaman dengan optimization_goal= POST_ENGAGEMENT

kosong

Lihat spesifikasi meta Interaksi Postingan Halaman

POST_ENGAGEMENT (pengujian)

apa pun

{'action.type':
'dwell',
'post':'POST_ID', 'page':'PAGE_ID'}

Persentase kecil jenis iklan ini memiliki jenis pelacakan dwell, yang fokus pada pengguna yang setidaknya berinteraksi dengan iklan dalam waktu minimal.

PRODUCT_ CATALOG_SALES

Iklan Produk Dinamis

{'action.type': 'post_engagement', 'page': PAGE_ID, 'post': POST_ID}

Jumlah klik tautan di postingan halaman tertentu jika hanya ada satu tautan, jumlah interaksi di postingan, dan jumlah berapa kali pengguna menciptakan cerita atau berinteraksi dengan sebuah halaman. Anda dapat menentukan set produk yang berbeda dari set produk di objek yang dipromosikan, namun default-nya adalah set produk yang ditentukan di objek yang dipromosikan.

Spesifikasi Meta

Anda dapat menentukan beragam tindakan di satu objek menggunakan spesifikasi tunggal.

Objek Spesifikasi Konversi Deskripsi

Aplikasi

{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}

Jumlah berapa kali pengguna menciptakan cerita app_story atau berinteraksi dengan konten melalui app_use, app_install, credit_spent.

Halaman

{"action.type":["page_engagement"], "page":["PAGE_ID"]}

Jumlah berapa kali pengguna melakukan tindakan berikut dalam konteks halaman tertentu: singgah, komentar, ikuti, suka, suka postingan halaman, sebut, postingan di halaman, bagikan postingan, jawab pertanyaan. Ditambah dengan jumlah berapa kali pengguna melakukan tindakan berikut dalam konteks halaman tertentu: klik tautan, lihat foto, putar video Facebook native.

Postingan Halaman

{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}

Jumlah berapa kali pengguna melakukan tindakan berikut dalam konteks postingan tertentu: komentar, ikuti pertanyaan, suka, bagikan, jawab pertanyaan. Ditambah dengan jumlah berapa kali pengguna melakukan tindakan berikut: klik tautan, suka halaman, lihat foto, putar video yang di-host di Facebook atau pemutaran video YouTube inline. Gunakan link_click untuk video yang tidak disematkan.

Spesifikasi Pelacakan Khusus

Untuk menentukan spesifikasi pelacakan Anda sendiri, gunakan framework spesifikasi tindakan. Lihat Spesifikasi Tindakan, Referensi.

Tindakan (Jenis Objek) Deskripsi, detail spesifikasi Pelacakan Spesifikasi Pelacakan atau Konversi

app_custom_event (aplikasi)

Peristiwa khusus di aplikasi.
Jumlah peristiwa khusus di aplikasi seluler.

{'action.type':
'app_custom_event',
'application':APP_ID}

app_install (aplikasi)

Instalasi aplikasi.
Jumlah instalasi
di canvas atau aplikasi seluler

[{'action.type':'app_install',
'application':APP_ID},
{'action.type':
'mobile_app_install',
'application':APP_ID}]

app_use (aplikasi)

Jumlah berapa kali aplikasi digunakan.

{'action.type':'app_use',
'application':APP_ID}

checkin (tempat)

Persinggahan ke suatu tempat.
Jumlah persinggahan ke tempat atau ke tempat turunan halaman ini.

{'action.type':'checkin',
'page': PAGE_ID},
{'action.type':'checkin',
'page.parent:PAGE_ID}

comment (postingan)

Mengomentari postingan.
Jumlah komentar di postingan halaman tertentu.

{'action.type':'comment',
'post.wall':PAGE_ID},
{'action.type':'comment',
'post':POST_ID,
'post.wall':PAGE_ID}

credit_spend (aplikasi)

Instance kredit belanja di dalam aplikasi.

'action.type':'credit_spent',
'application':APP_ID}

follow (pertanyaan)

Berlangganan ke objek.
Jumlah jawaban atau ikuti pertanyaan.

{'action.type':'vote', 'question':QUESTION_ID, 'question.creator':PAGE_ID}, {'action.type':'follow', 'question':QUESTION_ID, 'question.creator':PAGE_ID}

leadgen_quality_conversion (pixel)

Peristiwa konversi prospek corong bawah (CRM).

{'action.type': 'leadgen_quality_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type': 'leadgen_quality_conversion', 'dataset': 'OFFLINE_EVENT_SET_ID'}

like
(halaman, postingan)

Menyukai objek.
Jumlah suka di halaman atau postingan.

{'action.type':'like',
'page':PAGE_ID}
, {'action.type':'like',
'post.wall':PAGE_ID}
, {'action.type':'like',
'post':POST_ID,
'post.wall':PAGE_ID}

link_click (halaman, postingan, URL, domain URL)

Mengeklik tautan.
Jumlah berapa kali tautan URL keluar situs, tautan dengan domain URL tertentu, tautan keluar situs di sebuah halaman, tautan keluar situs di sebuah postingan diklik.

{'action.type':['link_click'],
'object':['URL']},
{'action.type':['link_click'],
'object.domain':
['URL_DOMAIN']},
{'action.type':['link_click'],
'post.wall':['PAGE_ID']},
{'action.type':['link_click'],
'post':['POST_ID'],
'post.wall':['PAGE_ID']}

mention (halaman)

Menyebut Halaman.
Jumlah sebut halaman.

{'action.type':'mention',
'object':PAGE_ID'}

offsite_conversion (pixel)

Jumlah konversi di luar situs, dan pendapatan yang terakumulasi.

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}

photo_view (halaman)

Melihat foto.
Jumlah tampilan foto,
video_plays atau link_clicks dari foto/video/pembagian tautan postingan tertentu di halaman.

{'action.type':'photo_view', 'post.wall':PAGE_ID}
{'action.type':'photo_view', 'post':POST_ID,
'post.wall':PAGE_ID}

post (postingan)

Berbagi cerita.
Jumlah pengguna yang membuat postingan di halaman.

{'action.type':'post',
'post.wall':PAGE_ID}

receive_offer (promo)

Klaim Promo.
Jumlah orang yang mengeklaim promo tertentu.

{'action.type':'receive_offer',
'offer':OFFER_ID}

rsvp (acara)

Mengonfirmasi kehadiran di Acara.
Jumlah Konfirmasi Kehadiran (ya dan mungkin) untuk acara. Nilai yang valid adalah yes, maybe, dan no.

{'action.type':'rsvp',
'event': EVENT_ID},

{'action.type':'rsvp',
'response':'yes',
'event': EVENT_ID},

{'action.type':'rsvp',
'response':'no',
'event': EVENT_ID},
{'action.type':'rsvp',
'response':'maybe',
'event': EVENT_ID}

tab_view (halaman)

Melihat tab halaman
Jumlah tayangan tab halaman tertentu. Jika Anda menginginkan semua tampilan web, cukup tentukan halamannya.

{'action.type':'tab_view',
'page.tab.name':
'PAGE_TAB_NAME', 'page':PAGE_ID},
{'action.type':'tab_view',
'page':PAGE_ID}

video_play (postingan)

Menonton video.
Jumlah tontonan video untuk postingan video tertentu di halaman.

{'action.type':'video_play', 'post.wall':PAGE_ID},{'action.type':'video_play', 'post':POST_ID,
'post.wall':PAGE_ID}

Contoh

Pelacakan Pixel

Lacak kinerja berbagai pixel di dalam iklan dengan menentukan pixel pelacakan di kolom tracking_specs iklan. Contoh:

tracking_specs="[
  {'action.type':'offsite_conversion','fb_pixel':1},
  {'action.type':'offsite_conversion','fb_pixel':2},
  {'action.type':'offsite_conversion','fb_pixel':3}
]"

Ini melacak kinerja pixel "1", "2", dan "3". Jika Anda hanya ingin mengoptimalkan pixel "1" saja, tentukan promoted_object set iklan induk. Ini berguna ketika Anda ingin mengoptimalkan CHECKOUT, namun juga ingin melacak jumlah REGISTRATION dan ADD_TO_CART.

Pixel yang dioptimalkan dengan cara menentukan ID pixel di promoted_object akan dilacak secara otomatis, sehingga Anda tidak perlu menentukan pixel yang sama di tracking_specs.

Menggunakan Spesifikasi Konversi

conversion_specs adalah kolom untuk iklan. Ini mengikuti format {'action.type':'{ACTION}', ... } tempat setiap tindakan berlaku untuk objek. Berikut adalah contoh spesifikasi konversi untuk berbagai jenis iklan:

Jenis iklan Spesifikasi Konversi

Iklan domain dengan konteks sosial

{'action.type':'link_click', 'object':'URL'}

Iklan suka halaman

{'action.type':'like', 'page':PAGE_ID}

Iklan tautan postingan halaman

{'action.type':['link_click'], 'post': [POST_ID], 'post.wall':[PAGE_ID]}

Semua iklan postingan halaman lainnya

{'action.type':'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}

Iklan acara

{'action.type':'rsvp' , 'response':'yes', 'event':'EVENT_ID'}

Iklan promo

{'action.type':'receive_offer', 'offer':OFFER_ID, 'offer.creator':PAGE_ID}

Iklan instalasi aplikasi seluler

Tidak Ada - tidak dapat membuat iklan seperti itu dengan tujuan NONE.

Iklan interaksi aplikasi seluler

Tidak Ada - hanya jenis tawaran CPC dan CPM yang didukung

Iklan instalasi aplikasi Canvas

Tidak Ada - tidak dapat membuat iklan seperti itu dengan tujuan NONE

Iklan interaksi aplikasi Canvas

Tidak Ada - tidak dapat membuat iklan seperti itu dengan tujuan NONE

Beberapa spesifikasi konversi memuat beberapa tindakan yang berlaku untuk objek tunggal. Spesifikasi tersebut disebut dengan spesifikasi meta. Berikut adalah contohnya:

Objek Spesifikasi Konversi Deskripsi

Halaman

{"action.type":["page_engagement"], "page":["PAGE_ID"]}

Jumlah berapa kali seseorang mengambil tindakan berikut di halaman tertentu: singgah, komentar, ikuti, suka, suka postingan halaman, sebut, postingan di halaman, bagikan postingan, jawab pertanyaan. Termasuk jumlah berapa kali seseorang melakukan tindakan berikut di halaman tertentu: lihat foto, putar video Facebook native.

Postingan Halaman

{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}

Jumlah berapa kali seseorang mengambil tindakan ini di postingan tertentu: komentar, ikuti pertanyaan, suka, bagikan, klaim promo, jawab pertanyaan. Termasuk jumlah berapa kali seseorang melakukan tindakan ini: klik tautan, lihat foto, putar video yang di-host di Facebook atau pemutaran video YouTube inline. Gunakan link_click untuk video yang tidak disematkan.

Aplikasi

{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}

Jumlah berapa kali seseorang menciptakan app_story atau berinteraksi dengan konten sebagai app_use, app_install, atau credit_spent.