Reporting API Versi 2

Panduan ini menunjukkan cara menerapkan Audience Network Reporting API versi 2 (v2) untuk mendapatkan data kinerja bagi bisnis Anda.

Prasyarat

• Kasus penggunaan Aplikasi Meta dengan Facebook Login dan izin `read_audience_network_insights`
• Facebook Login di aplikasi Anda
• Kueri uji yang berhasil untuk endpoint Graph API dan izin read_audience_network_insights
• Berhasil menyelesaikan Tinjauan Aplikasi Meta
• Token Akses Pengguna yang berdurasi lama

Rekomendasi

• Karena banyaknya data yang ditampilkan di setiap kueri, penggunaan paginasi berbasis kursor direkomendasikan. Hasil paginasi diberikan segera untuk permintaan penyinkronan dan merupakan metode yang disukai untuk mengambil perincian.

Batasan

• Semua data ditampilkan dalam zona waktu GMT
• Metrik pendapatan ditampilkan berdasarkan jumlah impresi

  • Jika data tidak tersedia, kami merekomendasikan kueri total impresi dan pendapatan
• Token akses pengguna yang dibuat di Pengelola Monetisasi atau Pengelola Bisnis tidak dapat digunakan

Pembaruan untuk Agregasi

Impresi dan Pendapatan Harian

Kueri impresi dan pendapatan untuk penempatan tanggal 1-4 Mei 2022 dengan perincian harian.

Yang mungkin berubah: Anda mungkin melihat bahwa beberapa data tidak tersedia setelah perubahan.

Poin pendapatan dan data CPM yang tidak tersedia karena jumlah impresi tidak mencukupi tidak akan disertakan dalam kolom results di tanggapan API. Sebagai gantinya, entri yang sesuai akan ditambahkan ke kolom omitted_results. Entri akan menyertakan kolom waktu, metrik, dan perincian, tetapi tidak akan menyertakan nilainya - silakan baca contoh tanggapan di bagian bawah halaman ini.

Sintaksis Permintaan

Gunakan endpoint GET ID > adnetworkanalytics untuk mendapatkan insight Audience Network bagi bisnis, properti, atau aplikasi.

GET /<ID>/adnetworkanalytics

Contoh Permintaan GET

Untuk mendapatkan insight, kirim permintaan GET ke endpoint /<ID>/adnetworkanalytics dengan daftar metrik yang dipisahkan koma dan daftar perincian opsional yang dipisahkan koma dengan <ID> adalah ID bisnis Meta Anda, ID properti, atau ID aplikasi Anda. Contoh berikut mendapatkan metrik selama periode 24 jam tunggal dan membatasi hasilnya menjadi 2 tanggapan per metrik.

curl -X GET https://graph.facebook.com/v19.0/BUSINESS_ID/adnetworkanalytics
  ?metrics=["fb_ad_network_request","fb_ad_network_imp","fb_ad_network_click","fb_ad_network_revenue"]
  &breakdowns=["placement","country"]
  &since=2021-08-06
  &until=2021-08-06
  &limit=2

Contoh Tanggapan

{
  "data": [
    {
      "query_id": "531234567890123456789012345683d6",
      "results": [
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_imp",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "1200"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_imp",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AU"
            }
          ],
          "value": "35"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_revenue",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "21.212345"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_request",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AD"
            }
          ],
          "value": "1"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_request",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "12"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_click",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "1"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_click",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "CA"
            }
          ],
          "value": "2"
        }
      ],
      "omitted_results": [
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_revenue",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AU"
            }
          ]
        }
      ]
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MQZDZD"
    },
    "next": "https://graph.facebook.com/v10.0/142440604406900/adnetworkanalytics?access_token=<ACCESS_TOKEN>&since=2021-08-06&until=2021-08-06&breakdowns=%5B%22placement%22%2C%22country%22%5D&limit=2&metrics=%5B%22fb_ad_network_request%22%2C%22fb_ad_network_imp%22%2C%22fb_ad_network_click%22%2C%22fb_ad_network_revenue%22%5D&after=MQZDZD"
  }
}

Referensi

Parameter Kueri

Metrik yang Tersedia

Pemecahan Masalah

Debugger Token Akses

Gunakan Debugger Token Akses untuk mendapatkan informasi mendetail untuk token akses, termasuk izin, validitas, akses properti, dan ID Aplikasi yang terkait dengan token.

Pesan Kesalahan