Marketing API

Materi Iklan

Gunakan iklan Facebook untuk menjangkau pelanggan Anda yang sudah ada dan pelanggan baru. Setiap panduan menjelaskan produk iklan Facebook untuk membantu Anda meraih tujuan iklan Anda. Ada sejumlah jenis unit iklan dengan berbagai macam opsi penampilan, penempatan, dan materi iklan. Untuk pedoman mengenai unit iklan sebagai konten materi iklan, lihat Panduan Iklan Facebook.

Materi Iklan

Materi iklan adalah objek yang memuat semua data untuk me-render iklan secara visual. Terdapat berbagai jenis iklan di dalam API yang dapat Anda buat di Facebook, semuanya tercantum di sini.

Jika Anda memiliki kampanye dengan Tujuan Interaksi Postingan Halaman, Anda kini dapat membuat iklan yang mempromosikan postingan yang dibuat oleh halaman. Ini dianggap sebagai iklan postingan Halaman. Iklan kiriman Halaman membutuhkan kolom yang disebut object_story_id, yang merupakan properti id dari postingan Halaman. Pelajari selengkapnya tentang Materi Iklan, Referensi.

Sebuah materi iklan memiliki tiga bagian:

  • Materi iklan itu sendiri ditentukan berdasarkan atribut visual objek materi iklan
  • Penempatan sebagai lokasi iklan dijalankan
  • Pratinjau unit untuk setiap penempatan

Untuk membuat objek materi iklan, buatlah panggilan berikut:

curl -X POST \
  -F 'name="Sample Promoted Post"' \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Tanggapannya kepada panggilan API adalah id dari objek materi iklan. Simpan ini; Anda akan memerlukannya untuk objek iklan:


curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Batas

Terdapat batasan untuk teks, ukuran gambar, rasio aspek gambar, dan aspek lain dari materi iklan. Lihat Panduan Iklan.

Membaca

Di API Iklan, tiap kolom yang ingin Anda dapatkan harus diminta secara eksplisit, kecuali id. Setiap Referensi objek memiliki bagian untuk membaca ulang objek dan mencantumkan kolom-kolom yang dapat dibaca. Untuk materi iklan, kolomnya sama dengan yang ditentukan saat membuat objek, dan id.


curl -G \
  -d 'fields=name,object_story_id' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<CREATIVE_ID>Open In Graph API Explorer

Penempatan

Penempatan adalah tempat iklan Anda ditampilkan di Facebook, seperti Kabar di desktop, Kabar di perangkat seluler, atau di kolom kanan. Lihat Panduan Produk Iklan.

Kami menyarankan Anda untuk menayangkan iklan di seluruh rentang penempatan yang tersedia. Lelang iklan Facebook dirancang untuk menayangkan impresi iklan ke penempatan yang paling berpeluang untuk memberikan hasil kampanye dengan biaya serendah mungkin.

Cara termudah untuk memanfaatkan pengoptimalan ini adalah mengosongi kolom ini. Anda juga dapat memilih penempatan tertentu dalam target_spec sebuah set iklan.

Contoh ini memiliki iklan postingan halaman. Penempatan yang tersedia adalah Kabar Seluler, Kabar Desktop, dan kolom Kanan Facebook. Di dalam API, lihat Opsi Penempatan. Jika Anda memilih desktopfeed dan rightcolumn sebagai page_type, iklan aktif di Kabar Desktop dan penempatan kolom Kanan. Iklan apa pun yang dibuat di bawah set iklan ini hanya memiliki penempatan desktop saja.

curl -X POST \
  -F 'name=Desktop Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=10000' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook","audience_network"] 
  }' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=1000' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  

Open In Graph API Explorer

Melakukan Pratinjau Iklan

Anda melihat pratinjau iklan melalui salah satu dari kedua cara berikut—dengan API pratinjau iklan atau plugin pratinjau iklan.

Terdapat tiga cara untuk membuat pratinjau dengan menggunakan API:

  1. Dengan ID iklan
  2. Dengan ID materi iklan
  3. Dengan menyuplai spesifikasi materi iklan

Menurut dokumen referensi untuk API pratinjau, panggilan API minimum yang diperlukan adalah:


curl -G \
  --data-urlencode 'creative="<CREATIVE_SPEC>"' \
  -d 'ad_format="<AD_FORMAT>"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer

Spesifikasi materi iklan adalah array setiap kolom dan nilai yang diperlukan untuk membuat materi iklan.

Saat ini, panggilan materi iklan kami terlihat seperti ini:


curl -X POST \
  -F 'name="Sample Promoted Post"' \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Ambil object_story_id dan gunakan dalam panggilan API pratinjau:


curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=<AD_FORMAT>' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews


Open In Graph API Explorer

Nilai yang tersedia untuk ad_format sedikit berbeda dengan page_types. Akan tetapi, Kabar Desktop dan kolom Kanan Facebook dipilih di dalam skenario ini. Ini mewajibkan Anda untuk membuat dua panggilan API dalam membuat pratinjau untuk setiap penempatan:



curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer

curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=RIGHT_COLUMN_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews

Open In Graph API Explorer

Tanggapannya adalah iFrame yang berlaku selama 24 jam.

Lihat Selengkapnya