Reservasi

Reservasi memungkinkan Anda untuk merencanakan dan membeli kampanye Anda dengan biaya tetap, menawarkan jangkauan yang dioptimalkan dan frekuensi iklan terkontrol sambil membantu Anda memperkirakan kinerja kampanye Anda. Ini serupa dengan bagaimana orang membeli iklan TV secara tradisional. Ini adalah opsi lanjutan khusus yang hanya akan digunakan sebagian besar pengiklan jika mereka menginginkan jaminan tinggi bahwa iklannya menjangkau akun Pusat Akun dalam jumlah tertentu.

Reservasi berfungsi di berbagai jenis iklan dan perangkat. Karena Meta menarget berdasarkan orang nyata, bukan cookie, kami dapat memprediksi jangkauan dengan lebih akurat dan mengontrol frekuensi di berbagai perangkat.

Pembatasan

• Tersedia untuk akun iklan tertentu. Periksa parameter CAN_USE_REACH_AND_FREQUENCY akun iklan.
• stop_time set iklan harus dalam rentang 180 hari prediksi.
• Akun juga memiliki batasan berdasarkan negara; periksa dengan panggilan API GET ke https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>?fields=rf_spec.
• Hanya tetapkan satu negara dalam satu waktu di target_spec.
• Tidak ada versi iOS minimal untuk user_os, seperti iOS_ver_2.0_and_above.
• Saat membuat atau memperbarui kampanye reservasi, Anda tidak dapat mengatur anggaran sepanjang masa berlaku atau harian, batas impresi sepanjang masa berlaku atau harian, batas frekuensi atau tawaran eksternal, atau kolom PacingType.

Cari rf_spec untuk mengetahui batasan yang berlaku:

Hasilnya terlihat seperti ini:

{
  "rf_spec": {
    "min_reach_limits": {
      "US": 1000000,
      "CA": 1000000,
    },
    "countries": [
      "US",
      "CA",
    ],
    "min_campaign_duration": {
      "US": 3,
      "CA": 3,
    },
    "max_campaign_duration": {
      "US": 30,
      "CA": 30,
    },
    "max_days_to_finish": {
      "US": 56,
      "CA": 56,
    }
  }
}

Membuat Prediksi

Prediksi berisi jumlah akun Pusat Akun yang dapat dijangkau iklan Anda dalam rentang tanggal berdasarkan jangkauan, frekuensi, pemirsa, dan anggaran yang ditentukan. Estimasi reservasi dapat membantu Anda menyimulasikan hasil kampanye Anda sepanjang masa promosi dan akan menyesuaikannya berdasarkan tujuan, anggaran, pemirsa, format, dan penempatan Anda, keamanan merek, target kinerja, dan pengaturan kontrol frekuensi.

Pengeditan kampanye reservasi dapat dilakukan setelah pemesanan, tetapi begitu kampanye diluncurkan, Anda tidak dapat mengedit atau menjedanya kecuali untuk mengganti materi iklan Anda. Jika Anda hanya mengedit materi iklan, prediksi Anda tidak akan berubah. Anda dapat menghapus kampanye untuk membatalkan dan menghentikannya, tetapi harus memesan ulang kampanye, sehingga Anda mungkin menerima CPM dan prediksi hasil kampanye yang baru. Hanya pesan kampanye yang ingin Anda jalankan. ** Untuk pengujian, batasi reservasi Anda dalam ukuran dan durasi terkecil; pastikan jika Anda ingin membatalkannya karena ini adalah stok iklan sebenarnya yang kami pesan untuk Anda.

Batas

Berikut adalah batasan default untuk prediksi:

• Pemirsa target setidaknya 300 ribu akun Pusat Akun.
• Jangkauan minimal 200 ribu akun Pusat Akun.
• Set iklan harus aktif minimal 1 hari dan maksimal 90 hari (Jumlah hari dihitung sebagai jumlah hari durasi kampanye. Contoh: jika kampanye dimulai pukul 12.00 di hari ke-1 dan berakhir pukul 10.00 di hari ke-2, maka kampanye dianggap telah aktif selama 2 hari meskipun perbedaannya kurang dari 24 jam).
• Waktu berhenti set iklan harus dalam rentang 180 hari dari prediksi.
• Kampanye harus berakhir setelah pukul 06.00 di hari terakhir dalam zona waktu akun iklan.

Membaca Prediksi

Untuk detailnya, tentukan kolom. Untuk melihat semua reachfrequencyprediction untuk sebuah akun, buat HTTP GET ke https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions?fields={COMMA_SEPERATED_FIELD_LIST}.

Untuk menjangkau semua reachfrequencyprediction berdasarkan ID reachfrequencyprediction, buat HTTP GET dengan kolom yang Anda inginkan: https://graph.facebook.com/{API_VERSION}/{RF_PREDICTION_ID}?fields={COMMA_SEPERATED_FIELD_LIST}.

Secara default, Meta menampilkan ID. Untuk detail kolom, lihat Prediksi Reservasi, Membaca.

Kode Status Tanggapan

Ini menunjukkan kemungkinan hasil status di reachfrequencyprediction. Batasan awal akan muncul jika berlaku, namun batasan dapat bervariasi per akun iklan atau berdasarkan negara di masa mendatang:

Menggunakan Prediksi

Berikan ID Prediksi Anda dan datanya sebagai masukan untuk membuat ID baru yang berfungsi sebagai ID pemesanan. Lalu lampirkan ID reservasi ini ke set iklan Anda. Membuat pemesanan akan menjadikan stok tidak tersedia untuk orang lain, sehingga Anda harus melampirkannya sebelum kedaluwarsa.

Jika pemesanan berhasil, kami sementara akan memesan stok untuk Anda. Anda memiliki sekitar satu jam setelah pemesanan untuk menetapkan iklan ke set iklan.

Reservasi

Reservasi prediksi untuk set iklan Anda guna mengunci harga Anda dan mendapatkan jangkauan yang dapat diprediksi. Pesan pemirsa yang diidentifikasi dengan reachfrequencyprediction untuk waktu yang ditetapkan dengan reserve untuk action. Anda dapat menggunakan ID prediksi tunggal untuk membuat beberapa pemesanan. Contoh:

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
// Response 
{"id":9876543210"}

Untuk memesan stok berdasarkan prediksi, buat panggilan API POST ke https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions.

Untuk reach, budget, dan impression, Anda dapat memesan prediksi di titik tertentu di curve_budget_reach daripada di tuple asli prediksi jangkauan/anggaran. Gunakan kolom ini:

Meta menyimpan prediksi secara asinkron; Anda harus memilih dan memeriksa status prediksi. Awalnya, status prediksinya 2 (TERTUNDA). Setelah selesai, statusnya adalah 1, SUCCESS, atau 15, FAIL yang berarti kami kekurangan stok untuk menyelesaikan pemesanan ini.

Karena sistem pemesanan itu dinamis, Anda mungkin melihat perubahan kecil dalam ketersediaan stok antara waktu prediksi Anda dan waktu reservasi. Namun, Meta menghargai nilai yang Anda dapatkan pada waktu prediksi, selama perubahan masih dalam ambang batas yang wajar.

Menetapkan ke Set Iklan

Setelah Anda berhasil memesan prediksi, buat set iklan dengannya:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

Agar berhasil menetapkan prediksi, set iklan Anda harus memenuhi kriteria berikut:

• Jangan menentukan:
• start_time - berasal dari prediksi
• end_time - berasal dari prediksi
• targeting - berasal dari prediksi
• bid_amount
• optimization_goal
• lifetime_budget atau daily_budget
• Anda dapat menetapkan reservasi ke set iklan tanpa iklan yang aktif. Namun, Anda harus memiliki setidaknya satu iklan aktif sebelum set iklan dimulai.
• Anda harus menyertakan rf_prediction_id yang akan melampirkan prediksi ke set iklan baru.
• Atribut buying_type kampanye iklan adalah RESERVED

Anda juga dapat melampirkan reachfrequencyprediction ke set iklan untuk mengubah prediksinya. Buat permintaan POST ke https://graph.facebook.com/{ad_set_id} dengan rf_prediction_id untuk reachfrequencyprediction yang ingin Anda gunakan.

Berikut ini adalah batas pada set iklan:

• Opsi platform penerbit: facebook, instagram.
• Opsi penempatan Facebook: feed dan rightcolumn.
• Opsi penempatan Instagram: stream, story, explore, explore_home, dan reels. Jika penempatan menyertakan instagram, Anda harus menggunakan destination_ids, bukan destination_id. Kolom destination_ids harus berisi ID Halaman Facebook yang digunakan sebagai destination_id, plus ID akun Instagram.
• Salah satu dari Pemirsa Khusus atau Kategori Mitra, tapi tidak keduanya
• Penargetan Pemirsa Khusus situs web, penggemar atau pengecualian interaksi video tidak diizinkan.
• promoted_object Set iklan harus cocok dengan destination_id prediksi. Untuk postingan halaman, ID halaman tersebut harus ditentukan dan untuk iklan aplikasi, harus cocok dengan ID aplikasi yang ditentukan.
• Pacing Iklan Standar dan Terjadwal didukung, sedangkan penayangan dipacu tidak didukung.

Kami menagih kampanye reservasi atas impresi aktual yang ditayangkan. Jika waktu mulai kampanye sudah terlampaui dan set iklan kekurangan iklan yang aktif, kampanye akan gagal ditayangkan dan tidak akan ditagih. Meta merilis stok yang tersisa, namun kami dapat memberi penalti akun iklan untuk pelanggaran berulang.

Saat Anda membuat kampanye menggunakan jenis pembelian reservasi Meta, Anda setuju membayar biaya yang diajukan untuk stok iklan yang Anda pesan. Jika Anda ingin mengubah ukuran pemirsa atau frekuensi iklan Anda, maka biaya Anda juga akan berubah. Anda dapat membuat perubahan ini kapan pun sebelum kampanye Anda dimulai. Anda dapat mengedit materi iklan Anda sampai kampanye Anda dimulai.

Mengelola Iklan

Set iklan reservasi dapat berisi beberapa iklan; Anda dapat menambahkan lebih banyak iklan kapan saja. Jika set iklan diaktifkan dan tidak ada iklan yang aktif di dalamnya, Anda harus membuat iklan pertama Anda dalam 24 jam untuk set iklan yang berdurasi 3 sampai 30 hari, atau 6 jam untuk set iklan yang berdurasi 1 sampai 2 hari. Jika Anda tidak melakukannya, kami akan menghapus pemesanan tersebut.

Lepaskan Prediksi, Ubah Set Iklan

Anda bisa mengedit atau menjeda kampanye reservasi sebelum dimulai. Setelah kampanye dimulai, Anda hanya bisa mengedit materi iklan, anggaran, atau memperpanjang tanggal berakhir. Jika Anda hanya mengedit materi iklan, prediksi Anda tidak akan berubah.

Jika Anda mengubah anggaran atau tanggal berakhir, ini bisa menghasilkan prediksi baru untuk kampanye Anda yang akan ditampilkan dalam estimasi reservasi.

Anda tidak bisa menjeda kampanye reservasi setelah dimulai, tetapi Anda bisa menghapus kampanye untuk membatalkan kampanye kapan saja.

Untuk menjeda atau mengedit setelah set iklan dimulai, lihat Menjeda atau Memulai Ulang Set Iklan yang Ditayangkan dan Mengedit Set Iklan yang Ditayangkan. Untuk menghapus set yang aktif, lihat Set Iklan, Referensi. Anda akan ditagih untuk impresi yang ditayangkan.

Perhatikan, untuk menghindari potensi kegagalan, hindari menghapus semua iklan saat set iklan reservasi aktif.

Jika Anda menetapkan reservasi ke set iklan sebelum set iklan aktif, Anda tidak dapat mengubah sebagian besar atribut kecuali Anda menghapus reservasi ini. Buat permintaan HTTP POST ke set tersebut dan atur rf_prediction_id ke 0. Anda hanya dapat mengubah atribut name pada objek set iklan.

Untuk menghapus pemesanan:

curl \
-F "rf_prediction_id=0" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

Setelah set iklan aktif, pemesanan tidak dapat dilepaskan dan atribut dari set tidak dapat dimodifikasi, kecuali beberapa atribut iklan yang terdaftar di bawah ini yang ada di daftar diizinkan:

• name
• creative_id
• creative_spec
• conversion_specs
• tracking_specs
• view_tags

Jeda dan Mulai Ulang Set Iklan

Anda dapat menjeda set yang aktif, lihat Set Iklan, Referensi. Jika Anda menjeda set iklan selama lebih dari 30 menit, kami tidak menjamin prediksi untuk set ini.

Untuk mengaktifkan kembali set yang dijeda selama lebih dari 30 menit, Anda membutuhkan prediksi baru. Buat POST ke reachfrequencypredictions. Lihat Membuat Prediksi dan Memesan Prediksi. Anda harus meneruskan existing_campaign_id agar set yang aktif dapat diaktifkan ulang di permintaan tersebut. Setelah Anda membuat dan memesan prediksi baru, lampirkan reachfrequencyprediction ke set iklan dengan HTTP POST ke: https://graph.facebook.com/{ad_set_id} yang menentukan rf_prediction_id untuk prediksi yang ingin Anda gunakan.

Mengedit Set Iklan Aktif

Anda dapat membuat pembaruan ini setelah set dimulai.

• Tingkatkan atau turunkan anggaran dan jangkauan set iklan. Anggaran atau jangkauan harus lebih besar dari pengeluaran atau jangkauan tayangan saat ini.
• Perpanjang jadwal set iklan menjadi 90 hari.

Anda tidak dapat mengedit atau menjeda dan mengatur aktif jika memenuhi salah satu kriteria berikut:

• Mengalami kegagalan penayangan yang besar. Ditayangkan kurang dari 10% prediksi. Set dengan pengeluaran melebihi anggaran
• Set iklan aktif hanya selama satu hari
• Set iklan akan berakhir dalam 24 jam ke depan

Untuk mengedit set iklan aktif, dapatkan prediksi baru. Lihat Membuat Prediksi dan Memesan Prediksi. Anda harus meneruskan existing_campaign_id agar set yang aktif dapat diaktifkan ulang di permintaan tersebut.

Setelah prediksi baru dibuat dan dipesan, Anda dapat melampirkan reachfrequencyprediction ke set iklan dengan membuat permintaan HTTP POST ke: https://graph.facebook.com/{ad_set_id} dengan menentukan rf_prediction_id sebagai id reachfrequencyprediction yang ingin Anda gunakan.

Gunakan ulang Pemirsa yang Dipesan

Jika Anda membatalkan pemesanan, inventaris yang dipesan akan bebas digunakan pengiklan lain. Namun, Anda dapat menggunakan ulang pemirsa dari prediksi yang dipesan sebelumnya jika Anda belum menggunakannya. Dengan ini, kami dapat memperhitungkan stok tambahan untuk membuat prediksi, tanpa Anda harus membatalkan pemesanan yang ada.

Sertakan rf_prediction_id_to_share saat Anda membuat pemesanan. Ini adalah ID prediksi sebelumnya. Ini memvalidasi pemesanan sebelumnya, sehingga Anda dapat menggunakan stok ini untuk pemesanan yang baru Anda buat.

Untuk memesan prediksi baru, Anda juga harus meneruskan parameter rf_prediction_id_to_release tambahan yang merupakan ID pemesanan sebelumnya.

Rotasi dan Rangkaian Iklan

Anda dapat memutar iklan di set iklan yang digunakan. Anda tidak perlu menghapus pemesanan dari set iklan untuk melakukan ini. Tambahkan satu atau beberapa iklan ke set iklan dan tunggu hingga iklan menjadi aktif. Pada titik ini, Anda dapat mengubah status iklan awal ke dijeda. Anda harus memiliki setidaknya satu iklan yang aktif dalam set iklan tersebut.

Anda dapat merancang rangkaian iklan yang ditayangkan secara berurutan. Pertama, buat set iklan dan iklan. Lalu tentukan urutan di level set iklan di creative_sequence. Setiap iklan individual dalam set iklan ini mungkin tidak muncul, muncul sekali, atau muncul beberapa kali secara berurutan.

Jika panjang array creative_sequence adalah nol, maka Anda tidak menggunakan pengurutan. Jika panjangnya tidak nol, kami sarankan Anda membuatnya sama dengan frequency_cap di rf_prediction_id. Jika panjangnya lebih dari frequency_cap, kami dapat memotong beberapa iklan terakhir dalam array. Jika panjangnya kurang dari frequency_cap, kami akan otomatis mengisi array secara berulang dengan mengulang urutan dari awal. Untuk memperjelas hasil, atur panjang creative_sequence ke jumlah yang sama dengan frequency_cap.

Setiap iklan dalam rangkaian memiliki status ACTIVE, PENDING_REVIEW, atau CREDIT_CARD_NEEDED. Iklan tertentu dalam rangkaian hanya akan ditayangkan kepada pengguna jika semua iklan sebelumnya dalam urutan telah ditayangkan. Iklan yang tidak disertakan di creative_sequence tidak akan ditayangkan.

Semua iklan di set iklan yang menggunakan pengurutan iklan, dalam rangkaian atau tidak, tidak dapat dijeda, diarsipkan, atau dihapus.

Fitur ini hanya tersedia untuk set iklan reservasi, yaitu buying_type kampanye iklan induknya adalah RESERVED, dan set iklan ini memiliki set rf_prediction_id.

Detail selengkapnya dapat ditemukan di dokumen set iklan.

Reservasi Instagram

Untuk jangkauan yang dapat diprediksi di Instagram, Anda dapat membuat kampanye Reservasi dengan buying_type diatur ke RESERVED.

Reservasi membantu Anda merencanakan dan memesan kampanye awareness dan interaksi, mengoptimalkan jangkauan, peningkatan ad recall, dan ThruPlay.

Capai estimasi di Pengelola Iklan dan API dapat memberikan panduan kepada mitra tentang apa yang secara wajar dapat mereka harapkan. Komunitas Instagram menjadi yang utama, kami mencoba mencapai tujuan pencapaian secara konservatif, dan berharap untuk berkembang seiring waktu. Semua kebijakan yang berlaku untuk penggunaan estimasi reservasi untuk Facebook juga berlaku untuk Instagram.

Kode Kesalahan

Contoh

Membuat reachfrequencyprediction untuk destination_id aplikasi:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<APP_ID>' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Membuat reachfrequencyprediction untuk destination_id halaman:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<PAGE_ID>' \
-F 'prediction_mode=1' \
-F "objective=POST_ENGAGEMENT" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Membuat reachfrequencyprediction untuk destination_id aplikasi dengan penempatan Instagram:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook","instagram"], "device_platforms":["mobile"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_ids=[<APP_ID>,<INSTAGRAM_ACCOUNT_ID>]' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Lakukan polling pada endpoint berikut melalui permintaan HTTP GET untuk mengambil status hingga berupa nilai selain 2:

https://graph.facebook.com/67890123456?fields=status

Jika statusnya adalah 1 (berhasil), maka ini dapat dilampirkan ke set iklan atau dipesan.

Memesan prediksi:

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
{"id":"9876543210"}

Lakukan polling pada endpoint berikut melalui permintaan HTTP GET untuk mengambil status hingga berupa nilai selain 2:

https://graph.facebook.com/<API_VERSION>/<PREDICTION_ID>?fields=status

Jika statusnya adalah 1 (berhasil), maka ini dapat dilampirkan ke set iklan. Mari menyiapkan struktur kampanye Anda dengan membuat kampanye, set iklan, materi iklan, iklan, dan menetapkan reservasi ke set iklan tersebut.

Membuat kampanye iklan:

curl \
-F "name=Test" \
-F "buying_type=RESERVED" \
-F "status=ACTIVE" \
-F "objective=POST_ENGAGEMENT" \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

{"id":"1122334455"}

Membuat set iklan:

curl  \
-F "name=TestReachSet" \
-F "status=1" \
-F "campaign_id=<CAMPAIGN_ID>" \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets"

{"id":"09876543"}

Membuat materi iklan:

curl \
-F "name=sample creative" \
-F "type=1" \
-F "title=hello world" \
-F "body=hi i'm an ad" \
-F "link_url="https://www.facebook.com/" \
-F "image_hash=4aca812b4eadb72818a2c4124abd121a" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives"

{"id":"1323123123123"}

Membuat iklan:

// Create an ad
curl \
-F "name=my ad" \
-F "adset_id=<AD_SET_ID>" \
-F "creative={'creative_id':<CREATIVE_ID>}" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads"

{"id":"3213213123"}

Menetapkan prediksi baru ke set iklan:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"