Siteye göre yorum analitiğini alın

Parametreler

Yol

Ad	Tür	Zorunlu	Açıklama
locationId	string	zorunlu	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

Sorgu

Ad	Tür	Zorunlu	Açıklama	Varsayılan
startDate	string	isteğe bağlı	Start of the comparison period (`YYYY-MM-DD`). The `delta` fields compare this period against the previous equivalent one.	—
endDate	string	isteğe bağlı	End of the comparison period (`YYYY-MM-DD`).	—

Yanıtlar

200One entry per review source configured for the location. Response key `interactionsSitesStats`.

Response

{  "data": {    "interactionsSitesStats": {      "stats": [        {          "key": "google",          "siteUrl": "maps.google.com",          "averageRating": { "value": 4.6, "delta": 2.2 },          "totalInteractions": { "value": 412, "delta": 6.1 },          "newInteractions": { "value": 24, "delta": 33.3 },          "recency": "2026-09-06T14:12:00Z",          "baseRating": 4.5,          "baseInteractions": 388,          "humanizedRecency": "3 days ago"        },        {          "key": "facebook",          "siteUrl": "facebook.com",          "averageRating": { "value": 4.1, "delta": -1.4 },          "totalInteractions": { "value": 57, "delta": 0 },          "newInteractions": { "value": 0, "delta": -100 },          "recency": null,          "baseRating": 4.16,          "baseInteractions": 57,          "humanizedRecency": null        }      ]    }  }}

401Unauthenticated, missing or invalid API key.

403The key is valid but not permitted to read this location (`SY90003`).

Hangi platformun değişime yol açtığını görebilmeniz için bir konumun yorum performansını kaynaklara göre ayırır. Etkileşim analitiğini alın (genel KPI'lar) ve Yorum analitiği zaman çizelgesini alın (günlük seri) işlemlerinin site bazındaki karşılığıdır.

stats içindeki her öğe bir yorum kaynağını açıklar:

key / siteUrl: kaynağın kısa anahtarı ve site URL'si. siteUrl, Bir konumun yorum kaynaklarını listeleyin işlemindeki siteSettings[].name ile eşleşir.
averageRating, totalInteractions, newInteractions: her biri, istenen döneme ait bir value ve önceki eşdeğer döneme göre yüzde değişimi gösteren bir delta içeren bir nesnedir.
baseRating / baseInteractions: dönemin başlangıcındaki karşılık gelen değerlerdir; delta bu değerler temel alınarak ölçülür.
recency: bu kaynaktan gelen en son yorumun zaman damgasıdır; kaynak hiç yorum döndürmemişse null olur.
humanizedRecency: aynı anın görüntüleme için biçimlendirilmiş hâlidir ("3 gün önce").

Kullanım senaryosu: ortalamayı hangi platformun değiştirdiğini bulma

Bir konumun genel puanı düştüğünde, bu uç nokta düşüşün nerede olduğunu gösterir. Her kaynak için averageRating.delta değerini okuyun: diğer kaynaklar sabit kalırken tek bir kaynağın negatif yönde ayrışması bir platforma işaret ederken, kaynakların genel olarak negatif olması mağazaya işaret eder. recency değeri aylar öncesine ait olan bir kaynakta newInteractions.value değerinin 0 olması, genellikle müşterilerin yorum yazmayı bıraktığı değil, bağlantının güncelliğini yitirdiği anlamına gelir; bu nedenle Bir konumun yorum kaynaklarını listeleyin işlemiyle çapraz kontrol yapın.

Yukarıdaki yanıt bir örnektir.