Dapatkan analitik Facebook untuk suatu lokasi

Parameter

Path

Nama	Tipe	Wajib	Deskripsi
locationId	string	wajib	Location ID, either the Base64 Relay id (e.g. TG9jYXRpb246MTgwMDI4OQ==) or the raw numeric database id (e.g. 1800289). Both forms resolve to the same location.

Query

Nama	Tipe	Wajib	Deskripsi	Default
fromDate	string	opsional	Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted.	—
toDate	string	opsional	End of the range (YYYY-MM-DD).	—

Respons

200Daily Facebook Page interaction metrics. Each metric is a time-series array; a metric is `null` when no data exists for the range or the Page is not connected.

Response

{  "data": {    "facebookInsights": {      "views": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 120 }      ],      "ctaAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 5 }      ],      "directionsAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 3 }      ],      "phoneAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 2 }      ],      "websiteAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 9 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

Mengembalikan data interaksi harian Halaman Facebook untuk suatu lokasi. Setiap metrik berupa array titik deret waktu dengan startTime (hari yang menjadi interval pengelompokan) dan value. Halaman Facebook lokasi tersebut harus terhubung.

Metrik yang tersedia:

views: total tayangan Halaman
ctaAction: klik pada tombol ajakan bertindak di Halaman
directionsAction: permintaan petunjuk arah melalui Halaman
phoneAction: panggilan yang dimulai dari Halaman
websiteAction: klik menuju situs web dari Halaman

Kedua bentuk id dapat digunakan dalam path

Seperti endpoint analitik lainnya, facebook-analytics menerima id Relay Base64 (TG9jYXRpb246MTgwMDI4OQ==) atau id numerik mentah (1800289), dan keduanya merujuk ke lokasi yang sama. Utamakan id Relay, yang dikembalikan oleh endpoint baca. Jika nilainya tidak sesuai dengan salah satu bentuk tersebut, endpoint mengembalikan {"data":{"facebookInsights":null},"errors":[...]} dengan status 200.

Shell

curl -s 'https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/facebook-analytics?fromDate=2025-06-01&toDate=2025-06-30' \  -H "Authorization: API $LISTINGSAPI_KEY"

Mengatribusikan interaksi ke tombol CTA

Saat suatu lokasi menggunakan ajakan bertindak "Pesan sekarang" atau "Telepon sekarang" di Halamannya, ctaAction dan phoneAction memungkinkan Anda mengukur berapa banyak klik tersebut yang dihasilkan oleh tombol itu selama periode kampanye. Perhatikan bahwa setiap metrik dikembalikan sebagai null (bukan array kosong) jika Halaman tidak memiliki data untuk rentang tersebut atau tidak terhubung; periksa null sebelum melakukan iterasi. Gabungkan dengan analitik Google dan Bing untuk membuat satu tampilan performa yang mencakup beberapa platform publikasi.