Analizler

Her profil analizi endpoint'i için bir cURL, Python ve Node örneği: bir konumun günlük Google ve Facebook metrikleri ile haftalık Bing görüntülemeleri.

Profil analizleri, bir konumun her yayın platformunda ne sıklıkla görüntülendiğini ve o konumla ne sıklıkla etkileşime geçildiğini gösterir: gösterimler, sayfa görüntülemeleri, yol tarifi istekleri, aramalar ve web sitesi tıklamaları. Her yayın platformu için bir tane olmak üzere üç endpoint vardır ve üçü de okuma işlemi yapar; bu nedenle bir Read (okuma) anahtarı yeterlidir. Her metrik, { startTime, value } noktalarından oluşan bir zaman serisidir; API skaler toplamlar döndürmez, dolayısıyla gösterdiğiniz toplamları sizin hesaplamanız gerekir.

Endpoint'lere genel bakış

Üçü de aynı parametreleri kullanır. fromDate ve toDate, YYYY-MM-DD türündedir ve ikisi de isteğe bağlıdır; bunları belirtmezseniz yayın platformunun yakın geçmişi kapsayan varsayılan zaman aralığı kullanılır. Yol, base64 Relay id'sini veya düz sayıyı kabul eder. Bu iki biçimden birine uymayan bir değer kullanıldığında, insights nesnesi null olarak ayarlanmış ve bir errors dizisi içeren 200 döner; bu durum bağlantısı kesilmiş bir profil gibi göründüğünden önce errors değerini kontrol edin.

Bir tarih aralığı için Google metriklerini okuyun

GET /locations/{locationId}/google-analytics, her metrik için bir günlük seri içeren data.googleInsights döndürür. total, profil gösterimlerini ifade eder ve search ile maps toplamıdır; eylem metriklerini içermez. Bir veri değişikliğinin öncesini ve sonrasını karşılaştıran bir görünürlük raporu için bunu kullanın.

curl "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/google-analytics?fromDate=2026-08-01&toDate=2026-08-31" \-H "Authorization: API $LISTINGSAPI_KEY"

{  "data": {    "googleInsights": {      "total": [        { "startTime": "2026-08-01T00:00:00+00:00", "value": 412 },        { "startTime": "2026-08-02T00:00:00+00:00", "value": 388 }      ],      "search": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 300 }],      "maps": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 112 }],      "directionsAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 24 }],      "phoneAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 8 }],      "websiteAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 41 }],      "businessBookings": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 0 }],      "businessFoodOrders": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 0 }],      "businessFoodMenuClicks": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 0 }]    }  }}

Her noktanın startTime değeri, sayımın hangi güne göre gruplandığını belirtir. Örnekte, ilk günün total değeri 412'dir; bu, 300 search ile 112 maps toplamıdır.

Konumun ilgili zaman aralığında Google verisi yoksa veya Google profili bağlı değilse metrik, boş bir dizi yerine null olur. Toplamları hesaplarken null ve [] değerlerini aynı şekilde ele alın.

Bir tarih aralığı için Facebook metriklerini okuyun

GET /locations/{locationId}/facebook-analytics, data.facebookInsights altında günlük veriler içeren beş seriyle aynı yapıya sahiptir. Konumun Facebook Sayfasının bağlı olmasını gerektirir. Bir kampanya dönemi boyunca "Şimdi rezervasyon yap" veya "Şimdi ara" düğmesinin performansını ctaAction ile ölçebilirsiniz.

curl "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/facebook-analytics?fromDate=2026-08-01&toDate=2026-08-31" \-H "Authorization: API $LISTINGSAPI_KEY"

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

Sayfa beğenilerine ilişkin bir metrik yoktur. Sayfanın ilgili tarih aralığında verisi yoksa veya Sayfa bağlı değilse her seri null olarak döner; bu nedenle döngüye girmeden önce null olup olmadığını kontrol edin.

Bir tarih aralığı için Bing görüntülemelerini okuyun

GET /locations/{locationId}/bing-analytics, gün yerine haftaya göre gruplandırılmış tek bir seri olan data.bingInsights.views döndürür. Her nokta, startTime tarihinde başlayan bir haftanın görüntüleme sayısıdır. Veriler her pazartesi bir önceki hafta için yenilenir, bu nedenle görebileceğiniz en güncel veriler tamamlanmış son haftaya aittir. Bir eğilim çizgisi için birkaç aylık bir aralığı getirin; bu veriler gün düzeyinde ilişkilendirmeye uygun değildir.

curl "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/bing-analytics?fromDate=2026-06-01&toDate=2026-08-31" \-H "Authorization: API $LISTINGSAPI_KEY"

{  "data": {    "bingInsights": {      "views": [        { "startTime": "2026-06-01T00:00:00+00:00", "value": 73 },        { "startTime": "2026-06-08T00:00:00+00:00", "value": 58 }      ]    }  }}

Google ve Facebook'tan farklı olarak Bing, veri bulunmadığını null olarak değil, 200 ile birlikte boş bir views dizisi olarak bildirir. Her iki durumu da "gösterilecek bir şey yok" olarak ele alın ve "veri yok" etiketi istiyorsanız length == 0 koşulunu kontrol edin, çünkü boş bir dizinin toplamı 0 olur.

Karşılaşacağınız hatalar

Referans sayfalarında analitik için kaynağa özgü hata kodları belirtilmez. Karşılaşacağınız durumlar:

Tam liste Hata kodları bölümündedir.

Sonraki adımlar

• Profil analitik verilerini getirin: null koruma kontrollerini kullanarak bir serinin değerlerini toplayıp aylık toplamı hesaplayın ve iki dönemi karşılaştırın.
• Yorum analitiği: yerleşik dönem farklarıyla birlikte aynı konum için puan, yorum sayısı ve yanıt oranı.
• Yorumlar: yorum kaynağının geri kalanıyla birlikte yorum analitiği uç noktaları.
• Referans ana sayfası: Analitik. SDK'lar: Python analitiği, Node analitiği.