Marketing API

Memulai

Buat iklan pertama Anda dengan Marketing API dengan mengikuti langkah-langkah berikut.

Sebelum Memulai

Anda harus mengenal Graph API dan Struktur Kampanye Iklan Facebook. Setelah siap mulai melakukan panggilan, Anda memerlukan:

Setelah itu, Anda dapat memulai. Jangan lupa untuk memeriksa praktik terbaik umum untuk menggunakan Marketing API.

Langkah 1: Buat Kampanye

Mulai proses membuat objek kampanye baru dari kelas Campaign. Pada tahap ini, Anda perlu menetapkan target iklan Anda, yang merupakan tujuan keseluruhan kampanye. Sebaiknya Anda membuat kampanye PAUSED di awal, jadi Anda tidak akan ditagih saat pengujian.

curl -X POST \
  -F 'name="My campaign"' \
  -F 'objective="OUTCOME_TRAFFIC"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

Jika berhasil, kami meretur ID untuk kampanye iklan yang baru Anda buat. Jangan lupa untuk menyimpan ID ini. Anda juga dapat memverifikasikan bahwa kampanye Anda telah dibuat di pengelola iklan.

Sumber Informasi:

Langkah 2: Tentukan Penargetan

Dokumen Referensi

Sebelum bergerak untuk membuat set iklan, Anda perlu menentukan pemirsa target. Pada langkah berikutnya, Anda membuat set iklan dan menentukan atribut pemirsa.

Anda memiliki banyak opsi penargetan. Dalam contoh ini, kita menggunakan penargetan pencarian untuk menemukan nilai yang telah ditentukan sebelumnya yang dapat digunakan untuk menyiapkan pemirsa.

Pertama-tama, kita cari negara yang tersedia termasuk kata "united" (serikat):

curl -G \
  -d 'location_types=["country"]' \
  -d 'type=adgeolocation' \
  -d 'q=united' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Lalu, kita bisa mencari minat termasuk kata "movie" (film):

curl -G \
  -d 'type=adinterest' \
  -d 'q=movie' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Berdasarkan nilai-nilai yang dikembalikan dari panggilan di atas, kita tahu bahwa kita dapat membuat pemirsa dari orang-orang di Amerika Serikat yang tertarik dengan film. Spesifikasi penargetan terlihat seperti ini:

targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "interests": [{id: 6003139266461, 'name': 'Movies'}]
}

Langkah 3: Membuat Set Iklan dan Menentukan Anggaran, Penagihan, Pengoptimalan, dan Durasi

Set iklan yaitu grup iklan yang sama-sama menggunakan data anggaran harian atau anggaran sepanjang masa promosi, jadwal, tagihan, pengoptimalan, dan penargetan yang sama. Dalam langkah ini, Anda perlu membuat objek baru dari kelas AdSet dan menentukan:

  • Durasi: Berapa lama iklan akan berjalan. Atur menggunakan start_time dan end_time.
  • Anggaran: Berapa banyak uang yang ingin Anda keluarkan. Gunakan daily_budget atau lifetime_budget.
  • Pengoptimalan: Apa hasil yang ingin Anda capai dengan iklan. Siapkan menggunakan optimization_goal.
  • Tagihan: Cara Anda ingin membayar. Gunakan billing_event.
  • Tawaran: Apa nilai yang Anda tempatkan pada terjadinya peristiwa pengoptimalan. Gunakan kolom bid_amount.
  • Penargetan: Gunakan spesifikasi penargetan yang dibuat di Langkah 2.

Untuk membuat set iklan, Anda juga memerlukan ID kampanye iklan yang Anda simpan dari Langkah 1:

curl \
  -F 'name=My Ad Set' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}, "interests": [{id: 6003139266461, "name": "Movies"}]}' \
  -F 'start_time=2024-10-06T04:45:17+0000' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

Sebaiknya pembuatan set iklan dengan status PAUSED untuk menghindari biaya saat pengujian.

Langkah 4: Sediakan Materi Iklan

Dokumen Referensi

Dalam langkah ini, Anda akan menggunakan objek AdCreative untuk menyediakan elemen visual iklan Anda. Informasi yang perlu Anda berikan tergantung tujuan Anda, tetapi atribut umumnya adalah:

  • Gambar dan video
  • Judul dan deskripsi
  • Tautan
  • Tombol Ajakan Bertindak

Tergantung tujuan, Anda mungkin harus menyediakan kolom tingkat lanjut. Contoh: iklan untuk aplikasi iOS memerlukan URL App Store.

Anda dapat mendefinisikan materi iklan sebagai bagian dari set iklan atau iklan mandiri. Dalam kedua kasus tersebut, kami menyimpan materi iklan Anda di pustaka materi iklan akun iklan Anda untuk digunakan dalam iklan.

Contoh

Contoh ini menunjukkan cara menyediakan gambar dan membuat objek AdCreative.

Pertama-tama, buat objek AdImage dari file gambar:

curl \
  -F 'filename=@<IMAGE_PATH>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/adimages

Lalu, gunakan hash gambar untuk membuat AdCreative:

curl -X POST \
  -F 'name="Sample Creative"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "image_hash": "<IMAGE_HASH>",
         "link": "https://facebook.com/<PAGE_ID>",
         "message": "try it out"
       }
     }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_IN"
        }
      }
    }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

Verifikasi unggahan gambar Anda dengan membuka Galeri Media di dalam pengelola iklan.

Pada titik ini, AdCreative dengan tautan Anda belum terlihat di Pengelola Iklan. Anda melihat data ini setelah memesan iklan. Anda dapat melakukan debug materi iklan dengan Graph API Explorer dan menentukan kolom apa pun yang ingin Anda baca:

GET /{my-creative-id} HTTP/1.1
Host: graph.facebook.com/?fields=object_story_spec

Langkah 5: Jadwalkan Penayangan

Terakhir, buat benda Iklan untuk menautkan AdCreative dan AdSet. Atur status dari Ad ke paused agar tidak langsung melakukan pemesanan.

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="&lt;AD_SET_ID&gt;"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

Verifikasikan iklan Anda ada di pengelola iklan. Klik di kampanye yang baru saja Anda buat, lalu di set iklan, dan di iklan.

Jika merasa sudah nyaman memesan iklan dengan API, atur statusnya menjadi active. Pertama-tama, iklan menjalani tinjauan iklan, dan memiliki status PENDING_REVIEW. Setelah tinjauan selesai, akan kembali ke status ACTIVE.

Menyalin Iklan

Alternatifnya, Anda dapat menyalin iklan, aset, atau kampanye yang ada. Ini membantu Anda menduplikasi kampanye dengan cepat untuk mengubah konfigurasi atau membuat grup uji guna memperoleh informasi kinerja. Untuk detail selengkapnya, lihat: