Ads Insights API

Ads Insights API menyediakan data dan statistik kinerja untuk iklan Meta. Dengan opsi pelaporan yang fleksibel, Anda bisa menyesuaikan permintaan Anda dan mendapatkan hampir semua metrik yang tersedia di Pengelola Iklan Meta.

Sebelum memulai

Untuk mengakses Ads Insights API, Anda akan memerlukan:

aplikasi. (Lihat Pengembangan Aplikasi Meta untuk informasi selengkapnya.)
Izin ads_read. (Lihat Izin dan Otorisasi untuk informasi selengkapnya.)

Anda juga harus menyiapkan iklan untuk melacak tindakan yang Anda minati. Untuk melakukan hal itu, Anda bisa menggunakan fitur seperti Conversions API atau Meta Pixel.

Memanggil Ads Insights API

Ads Insights API tersedia sebagai edge dari semua objek iklan. (Lihat informasi selengkapnya tentang hierarki iklan Meta di sini.)

Sumber Informasi	Menyediakan
`/{ad-account-id}/insights`	Insight dari akun iklan
`/{campaign-id}/insights`	Insight dari kampanye iklan
`/{ad-set-id}/insights`	Insight dari set iklan
`/{ad-id}/insights`	Insight dari iklan

Secara default, permintaan GET akan menampilkan metrik dasar untuk objek iklan, biasanya dari 30 hari terakhir.

Contoh permintaan

curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights

Contoh tanggapan:

{
  "data": [
    {
      "account_id": "<AD_ACCOUNT_ID>",
      "campaign_id": "<CAMPAIGN_ID>",
      "date_start": "2025-03-14",
      "date_stop": "2025-04-12",
      "impressions": "361324",
      "spend": "5339.5"
    }
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

Mengkustomisasi Permintaan Anda

Anda bisa mendapatkan data yang jauh lebih spesifik dengan memanfaatkan tiga komponen utama pada permintaan Anda: parameter (untuk menyatakan hal-hal seperti rentang waktu, jendela atribusi, dsb.), kolom (yaitu metrik), dan perincian. Contoh: untuk mengetahui jumlah klik (semua) berdasarkan jenis kelamin yang terjadi dalam 7 hari terakhir kampanye, Anda bisa menyertakan:

Parameter: date_preset=last_7d
Kolom: clicks
Perincian: gender

Contoh permintaan

curl -G \ -d "date_preset=last_7d" \ -d "fields=clicks" \ -d "breakdowns=gender" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights

Contoh tanggapan

{
  "data": [
    {
      "clicks": "7346",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "female"
    },
    {
      "clicks": "3788",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "male"
    },
    {
      "clicks": "79",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "unknown"
    },
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

Pelajari Selengkapnya

Ads Insights API bisa sangat berguna, jadi pastikan untuk membaca dan mempelajari cara menguasai fiturnya:

Parameter dan Kolom
Metrik
Perincian
Permintaan Asinkron
Batasan dan Praktik Terbaik
Panduan spesifik untuk pelaporan konversi, Pelaporan Level Produk, dan Pemodelan Bauran Marketing

Anda juga bisa menemukan dokumentasi referensi yang dibuat secara otomatis untuk setiap edge insight objek iklan:

Jika Anda berencana untuk menyertakan data dari Ads Insights API dalam solusi, harap tinjau juga Ketentuan Platform Meta dan Kebijakan Developer untuk Marketing API.