Bir konumun Facebook analizlerini alın

Parametreler

Yol

Ad	Tür	Zorunlu	Açıklama
locationId	string	zorunlu	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.

Sorgu

Ad	Tür	Zorunlu	Açıklama	Varsayılan
fromDate	string	isteğe bağlı	Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted.	—
toDate	string	isteğe bağlı	End of the range (YYYY-MM-DD).	—

Yanıtlar

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.

Bir konum için günlük Facebook Sayfası etkileşim verilerini döndürür. Her metrik, bir startTime (verilerin gruplandığı gün) ve bir value içeren zaman serisi noktalarından oluşan bir dizidir. Konumun Facebook Sayfasının bağlı olmasını gerektirir.

Kullanılabilir metrikler:

views: toplam Sayfa görüntüleme sayısı
ctaAction: Sayfanın eylem çağrısı düğmesine yapılan tıklamalar
directionsAction: Sayfa üzerinden yapılan yol tarifi istekleri
phoneAction: Sayfadan başlatılan aramalar
websiteAction: Sayfadan web sitesine yönlendiren tıklamalar

Yolda her iki id biçimi de kullanılabilir

Diğer analiz uç noktaları gibi facebook-analytics da Base64 Relay id (TG9jYXRpb246MTgwMDI4OQ==) veya ham sayısal id (1800289) kabul eder ve her ikisi de aynı konuma karşılık gelir. Okuma uç noktalarının döndürdüğü Relay id biçimini tercih edin. Bu iki biçimden hiçbirine uymayan bir değer için 200 durumuyla {"data":{"facebookInsights":null},"errors":[...]} döndürülür.

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"

Etkileşimi CTA düğmesiyle ilişkilendirme

Bir konum, Sayfasında "Hemen rezervasyon yapın" veya "Hemen arayın" eylem çağrısını kullandığında, ctaAction ve phoneAction bir kampanya süresi boyunca bu tıklamaların kaçını düğmenin sağladığını ölçmenize olanak tanır. Sayfanın ilgili tarih aralığı için verisi olmadığında veya Sayfa bağlı olmadığında her metriğin (boş bir dizi yerine) null olarak döndüğünü unutmayın; öğeler üzerinde döngüye girmeden önce null olup olmadığını kontrol edin. Birden fazla yayın platformunu kapsayan tek bir performans görünümü oluşturmak için Google ve Bing analizleriyle birleştirin.