Dokumen ini sudah diperbarui.
Terjemahan ke Bahasa Indonesia belum selesai.
Bahasa Inggris diperbarui: 17 Jul 2023

Studi Peningkatan

Buat dan jalankan eksperimen untuk mengukur efisiensi kampanye Facebook Anda. Tentukan strategi periklanan apa yang paling mendorong dampak bisnis. Lihat Studi Iklan, Referensi.

Saat Anda membuat studi peningkatan, Anda secara acak membuat grup uji akun Pusat Akun yang melihat iklan Anda dan grup kontrol yang tidak melihat iklan Anda.

Anda dapat berbagi data konversi dengan aman dari kampanye iklan Anda dengan Facebook menggunakan Meta Pixel, atau Peristiwa Aplikasi. Facebook menentukan peningkatan konversi yang dihasilkan dari kampanye Anda. Kami membandingkan jumlah konversi, konversi akun Pusat Akun, dan pendapatan penjualan yang tersedia antara grup uji dan grup kontrol.

Siapkan Studi

Siapkan studi dengan satu atau beberapa grup, yang disebut sel. Saat Anda menyiapkan studi, Facebook mengacak pemirsa untuk iklan Anda dan menetapkan akun Pusat Akun ke grup uji atau grup kontrol. Setelah Anda menjalankan studi, Facebook menghitung perbedaan antara grup uji dan grup kontrol sehingga Anda mengevaluasi dampak iklan Facebook Anda dibandingkan dengan tujuan bisnis.

Untuk menyiapkan studi, buat panggilan POST:

'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Anda dapat menyiapkan studi dengan satu grup uji untuk melihat cara iklan Facebook menghasilkan bisnis tambahan. Anda juga dapat mengatur ruang belajar dengan beberapa grup uji, yang memungkinkan Anda menentukan pendekatan beriklan apa yang berfungsi paling baik bagi pemirsa Anda.

Contoh - Siapkan studi peningkatan dengan satu grup uji

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Untuk membuat studi baru, sediakan hal berikut:

ParameterDeskripsi

name

Nama studi.

description

Deskripsi singkat tentang tujuan studi.

cooldown_start_time

Dihentikan. Facebook masih menayangkan selama waktu antara observation_end_time dan end_time. Jika Anda menggunakan cooldown_start_time, sekarang aturlah waktu ini menggunakan start_time.

start_time

Waktu mulai masa aktif kampanye. Waktu mulai studi harus di masa mendatang.

end_time

Waktu akhir masa aktif kampanye.

observation_end_time

Akhir periode konversi pascates. Selama periode ini (yakni antara end_time dan observation_end_time), semua iklan Facebook (termasuk yang ditambahkan ke studi ini) dikirimkan secara normal ke grup uji dan kontrol, tetapi tidak ada pengguna baru yang akan dicatat peluangnya. Kami akan terus mencocokkan konversi selama periode ini dengan pengguna di grupnya masing-masing. Jika Anda tidak membutuhkan periode konversi pasca-tes untuk studi Anda, atur ini ke end_time.

cells

Sel dalam studi yang menentukan grup uji dan grup kontrol.

objectives

Tujuan studi. Lihat Menentukan Tujuan Studi.

viewers

Bagikan studi ini ke daftar ID pengguna Facebook.

type

Untuk Peningkatan Konversi, jenisnya harus LIFT.

LARANGAN - Setelah studi dimulai, Anda tidak dapat memperbarui start_time dan treatment_percentage sel. Anda juga tidak bisa menghapus objek terkait, seperti adaccounts atau campaigns, dari grup uji. Anda masih dapat memperbarui end_time dan observation_end_time ke depannya jika studi belum berakhir, dan tambahkan objek terkait baru ke grup uji.

Untuk menjalankan Jangkauan dan Frekuensi terkait dengan pengukuran Peningkatan, Anda harus menyiapkan studi Peningkatan terlebih dahulu dan memastikan durasi Jangkauan dan Frekuensi berada dalam durasi studi Peningkatan.

Buat Grup Uji

Untuk memulai, tentukan berapa banyak akun Pusat Akun yang menerima iklan Anda dan berapa banyak akun Pusat Akun yang tidak. Anda harus membuat grup uji saat menyiapkan studi; meneruskan daftar objek JSON di cells di bawah ad_studies. Lihat Sel Studi Iklan, Referensi. Grup uji berisi informasi berikut.

ParameterDeskripsi

name

Nama grup uji.

description

Deskripsi singkat tentang grup uji.

treatment_percentage

Mendefinisikan akun Pusat Akun yang menerima iklan Anda.

control_percentage

Mendefinisikan persentase holdout dari akun Pusat Akun yang tidak akan melihat iklan. Persentase perlakuan ditambah kontrol harus sama dengan 100.

ad_studies

Daftar entitas iklan, seperti adaccounts atau campaigns, ke studi. Facebook menjalankan dan mengukur semua iklan di bawah entitas iklan aktif selama masa studi.

Contoh - Membaca grup uji dalam studi

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>/cells'

Contoh - Perbarui atau modifikasi informasi sel dan perlakuan serta persentase kontrol dengan memberikan ID sel di cells

curl \
  -F 'cells=[{id:<CELL_ID>,treatment_percentage:80,control_percentage:20}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Contoh - Baca semua studi yang Anda buat ad_studies untuk bisnis Anda

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Anda juga dapat melihat semua studi yang terkait dengan akun iklan Anda dengan membuat permintaan GET di {ad-account-ID/include_all_studies=true} dengan token akses Anda.

Siapkan Beberapa Grup Uji

Siapkan studi dengan beberapa grup uji pengguna Facebook. Ini membantu mengukur dampak inkremental dari berbagai strategi Facebook pada tujuan bisnis, seperti menggunakan opsi penargetan iklan yang berbeda. Untuk menyiapkan studi dengan beberapa grup uji, berikan daftar grup uji di cells.

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"group A",description:"description of group A",treatment_percentage:50,control_percentage:20,campaigns:[<CAMPAIGN_ID1>]},{name:"group B",description:"description of group B",treatment_percentage:20,control_percentage:10,campaigns:[<CAMPAIGN_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

control_percentage menentukan sisa untuk setiap grup uji masing-masing terhadap total populasi. Contoh, Anda memiliki studi dengan dua grup uji: grup A adalah 50% perlakuan dengan 20% kontrol dan grup B adalah 20% perlakuan dengan 10% kontrol. Hasilnya ~ 28,6%, atau 20%/70% dari populasi di grup A, menjadi pengguna kontrol dan ~ 33,3%, atau 10%/ 0% dari populasi di grup B, menjadi pengguna kontrol.

Jumlah persentase perlakuan dan kontrol di seluruh grup uji biasanya harus sama dengan 100. Namun, jumlahnya bisa kurang dari 100 untuk beberapa kasus penggunaan tertentu. Contoh: saat Anda memiliki tiga grup uji yang dibagi rata pada 33%.

Anda dapat memperbarui, menambah, dan menghapus grup uji dalam sebuah studi.

  • Untuk memperbarui grup uji yang ada, lihat ID-nya di grup uji.
  • Untuk menambah grup uji baru, sediakan objek grup uji baru.
  • Untuk menghapus grup uji, cukup hilangkan dari cells saat Anda memperbarui studi:
curl \
  -F 'cells=[{id:<CELL_ID1>,treatment_percentage:60,control_percentage:10},{name:"group C",description:"replacing group B",treatment_percentage:25,control_percentage:5,campaigns:[<CAMPAIGN_ID3>]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Tentukan Tujuan Beriklan

Tentukan tujuan beriklan yang ingin Anda ukur dan cara Anda meneruskan data konversi ke Facebook. Studi peningkatan perlu setidaknya satu tujuan. Anda tidak dapat mengubah tujuan setelah studi mulai aktif. Lihat Tujuan Studi Iklan, Referensi.

Contoh - Buat dan tambahkan tujuan CONVERSIONS ke sebuah studi

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'


Nama Deskripsi Sumber Data

CONVERSIONS

Mengukur peningkatan konversi.

Meta Pixel berbasis CAPI

Jika Anda menggunakan CONVERSIONS dan Meta Pixel atau Aplikasi Seluler sebagai sumber peristiwa, Anda harus memberikan daftar nama peristiwa yang ingin Anda ambil untuk tujuan tersebut. Meta kemudian dapat melaporkan hasil berdasarkan peristiwa konversi spesifik ini.

Sumber Pengukuran Nama Peristiwa

Meta Pixel

fb_pixel_view_content, fb_pixel_search, fb_pixel_add_to_cart, fb_pixel_add_to_wishlist, fb_pixel_initiate_checkout, fb_pixel_add_payment_info, fb_pixel_purchase, fb_pixel_lead, fb_pixel_complete_registration, custom

Aplikasi Seluler

fb_mobile_activate_app, fb_mobile_complete_registration, fb_mobile_content_view, fb_mobile_search, fb_mobile_rate, fb_mobile_tutorial_completion, fb_mobile_add_to_cart, fb_mobile_add_to_wishlist, fb_mobile_initiated_checkout, fb_mobile_add_payment_info, fb_mobile_purchase, fb_mobile_level_achieved, fb_mobile_achievement_unlocked, fb_mobile_spent_credits

Buat Tujuan

Buat tujuan dengan meneruskan daftar objek JSON objectives saat Anda membuat studi baru. Tujuan berisi informasi berikut:

ParameterDeskripsi

name

Nama tujuan.

is_primary

Boolean yang menentukan bahwa ini adalah tujuan utama Anda beriklan. Studi hanya boleh memiliki satu tujuan utama.

type

Nilai tujuan dari CONVERSIONS.

adspixels

Daftar ID Meta Pixel bersama daftar event_names per ID, jika ada.

applications

Daftar aplikasi seluler Anda termasuk event_names yang relevan per ID.

offline_conversion_data_sets

Daftar ID set Peristiwa Offline jika ada. Saat ini kami tidak mendukung perincian peristiwa untuk Konversi Offline.

customconversions

Daftar ID Konversi Khusus, jika ada.

Anda juga bisa memiliki beberapa tujuan per studi. Hasilnya akan diagregasi berdasarkan tujuan. Di bawah ini adalah contoh studi dengan berbagai tujuan.

curl \
  -F 'name="another study"' \
  -F 'description="description of another study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"first objective objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID1>},{id:<APP_ID2>}]},{name:"scond  objective",type:"CONVERSIONS",applications:[{id:<APP_ID3>,event_names:["fb_mobile_purchase"]}],adspixels:[{id:<FB_PIXEL_ID>,event_names:["fb_pixel_purchase","fb_pixel_lead"]}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Anda dapat memperbarui, menambah, dan menghapus tujuan dalam studi dengan melakukannya di level studi, mirip dengan memodifikasi grup uji. Untuk memperbarui tujuan yang ada, lihat ID-nya di objek objectives. Untuk menambahkan tujuan baru, sediakan objek tujuan baru. Untuk menghapus tujuan, cukup hilangkan dari parameter objectives saat Anda memperbaruinya.

Contoh - Perbarui sumber pengukuran applications tujuan dan hapus sumber pengukuran adspixels.

curl \
  -F 'objectives=[{id:<OBJECTIVE_ID>,name:"new objective name",applications:[{id:<APP_ID>}],adspixels:[]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Contoh - Baca tujuan studi

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Pelaporan

Mengambil Tujuan

Semua metrik "pembeli" akan muncul untuk studi yang dimulai sebelum batas waktu 13/7/2021. Studi yang dimulai setelah 13/7 tidak akan memiliki metrik dan pengelompokan "pembeli" menurut jenis kelamin, usia, dan negara. Perubahan ini akan memengaruhi kolom di bawah yang dimulai dengan "pembeli" (buyers_test, buyers_control_scaled2, dst.).

Perhatikan juga bahwa Anda perlu menggunakan perincian cell_id untuk mendapatkan hasil level sel.

Tujuan studi ditentukan selama penyiapan studi. Lihat panduan penyiapan untuk cara menentukan tujuan studi Anda.

Anda dapat membaca tujuan yang dibuat untuk studi dengan membuat panggilan GET ke edge objectives studi.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Untuk selengkapnya tentang tujuan, baca dokumentasi referensi Tujuan Studi Iklan.

Mengambil Hasil

Untuk mengambil hasil untuk sebuah tujuan, Anda dapat membuat panggilan GET ke node tujuan dengan menentukan results dalam parameter kolom. Kolom last_updated_results juga memberi tahu Anda kapan data hasil untuk tujuan khusus ini terakhir diperbarui.

Contoh tanggapan yang ditampilkan sebagai JSON yang di-parse agar mudah dibaca.

Perintah:

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Data yang dihasilkan adalah objek JSON, berisi nama metrik dan string nilai. Bacalah Glosarium Metrik Peningkatan Facebook.

Dengan pembeli:

{
	"results": [
	"{"cell_id":"<cell_id>",
	"population_test":2334212,
	"population_control":123407,
	"population_reached":1862084,
	"impressions":19020874,
	"spend":26059,
	"buyers_control_raw_scaled":37672.615701199,
	"buyers_exposed":30085.482427228,
	"buyers_frequentist_pValue":0.00064950107027983,
	"conversions_control_raw_scaled":110918.27003534,
	"conversions_exposed":86961.044050743,
	"conversions_raw_pValue":0.12863848309723,
	"conversions_test":104412.89695396,
	"conversions_control_scaled":104575.81331581,
	"conversions_incremental":-162.91636184894,
	"conversions_notExposed":87123.960412592,
	"conversions_confidence":0.69291721817069,
	"conversions_multicell_confidence":null,
	"conversions_incremental_lower":-3470.6251396487,
	"conversions_incremental_upper":3235.0644420632,
	"conversions_multicell_rank":null,
	"conversions_incremental_share":-0.001873440730011,
	"conversions_CPiC":-159.95324044961,
	"buyers_test":40732.369934386,
	"buyers_control_scaled":41990.129061459,
	"buyers_incremental":-1257.7591270729,
	"buyers_notExposed":36617.935710157,
	"buyers_confidence":0.19318944031404,
	"buyers_multicell_confidence":null,
	"buyers_incremental_lower":-2905.5296282828,
	"buyers_incremental_upper":426.25813050358,
	"buyers_multicell_rank":null,
	"buyers_incremental_share":-0.041806181107957,
	"buyers_CPiB":-20.718593440578}"
	  ],
	  "id": "<objective_id>"
}


Tanpa pembeli:

{
	"results": [
	"{"cell_id":"<cell_id>",
	"population_test":2334212,
	"population_control":123407,
	"population_reached":1862084,
	"impressions":19020874,
	"spend":26059,
	"conversions_control_raw_scaled":110918.27003534,
	"conversions_exposed":86961.044050743,
	"conversions_raw_pValue":0.12863848309723,
	"conversions_test":104412.89695396,
	"conversions_control_scaled":104575.81331581,
	"conversions_incremental":-162.91636184894,
	"conversions_notExposed":87123.960412592,
	"conversions_confidence":0.69291721817069,
	"conversions_multicell_confidence":null,
	"conversions_incremental_lower":-3470.6251396487,
	"conversions_incremental_upper":3235.0644420632,
	"conversions_multicell_rank":null,
	"conversions_incremental_share":-0.001873440730011,
	"conversions_CPiC":-159.95324044961}"
	  ],
	  "id": "<objective_id>"
}

Hasil Perincian

Selain mengambil hasil per tujuan, Anda dapat memilih untuk memecah hasil dengan menyediakan parameter breakdowns.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Berikut ini adalah dimensi perincian yang tersedia:

Studi yang dimulai setelah 13/7 tidak akan memiliki perincian berdasarkan jenis kelamin, usia, dan negara.

Perincian Nilai

age

13-17, 18-24, 25-34, 35-44, 45-54, 55-54, 65+

cell_id

ID dari sel yang tersedia dalam studi ini.

gender

M atau F

country

Kode negara dua huruf (ISO 3166-1 alpha-2). Contoh: US, GB, IN, AU.

Saat ini didukung hanya saat di-kueri dalam kombinasi dengan cell_id.

Contoh: breakdowns=['cell_id','country']

Hasil ini menunjukkan beberapa objek JSON dalam array berdasarkan perincian yang tersedia. Contoh: jika cell_id disediakan, hasilnya akan dipecah sesuai jumlah sel dalam studi. Anda dapat memberikan satu atau lebih perincian; namun, kombinasi perincian harus setidaknya 100 konversi dari gabungan antara grup uji dan grup kontrol agar hasil ditampilkan.

{
  "id": "<STUDY_OBJECTIVE_ID>",
  "results": [
  {
    "cell_id": "<CELL_ID1>",
    ...
    Default fields where the values are specific to the <CELL_ID1> breakdown
    ...
  },
  {
    "cell_id": "<CELL_ID2>",
    ...
    Default fields where the values are specific to the <CELL_ID2> breakdown
    ...
  }],
}

Hasil untuk Cap Tanggal Tertentu

Anda dapat menentukan stempel tanggal dalam panggilan API untuk memperoleh hasil studi dari tanggal tertentu. Perhatikan bahwa panggilan mengembalikan hasil yang sama jika Anda melakukan panggilan sama pada tanggal tertentu tanpa menyertakan kolom stempel tanggal. Tanggal harus dalam 30 hari sebelumnya.

curl -G \
      -d 'access_token=<ACCESS_TOKEN>' \
      'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&ds=2020-03-01'