Kitle ve şehir
Ne ölçülür
- Kitle: en çok 3 müşteri tipi. Her biri bir ad ve soranı anlatan bir cümledir ("Bütçesi kısıtlı bir üniversite öğrencisiyim"). Her hafta aynı promptlar o müşteri gibi sorulur ve sonucu kendi ölçümünüzle yan yana görürsünüz.
- Şehir: panelin ülkesinde en çok 3 şehir. Her hafta aynı promptlar Google AI Mode ve AI Overviews'ta her şehirden sorulur. Panelde bu iki motordan en az biri olmalıdır.
Varsayılan olarak en yeni promptlar kullanılır (kitlede 20, şehirde 15). Promptları kendiniz de seçebilirsiniz.
Çağrılar
| Çağrı | Etkisi |
|---|---|
GET /panels/{panel_id}/audiences | Ayarlar ve müşteri tipi başına son haftalık karşılaştırma: report[].base_mentioned (kendi ölçümünüz) ve variant_mentioned (o müşteri gibi sorulunca), kaynak gösterilme oranları, en çok anılan rakipler, geçmiş ve alıntılı her prompt |
PATCH /panels/{panel_id}/audiences | enabled, personas ([{id, name, text}], en çok 3) ve prompts (prompt kimlikleri, en çok 20; en yeni promptlar için null). Göndermediğiniz alan aynı kalır. Bir müşteri tipinin geçmişini korumak için id'yi koruyun; çıkarmak geçmişini siler |
POST /panels/{panel_id}/audiences/suggest | Sitenizden ve promptlarınızdan müşteri tipi önerir. Kaydetmez. Panel başına saatte en çok 10, panelle ortak |
GET /panels/{panel_id}/locations | Ayarlar ve şehir başına son haftalık karşılaştırma; kitleyle aynı biçimde, city_id ile |
PATCH /panels/{panel_id}/locations | enabled, cities ([{id, name}], en çok 3) ve prompts (en çok 15) |
GET /panels/{panel_id}/locations/cities?q=İzmir | Kaydetmeden önce panelin ülkesinde bir şehir adını kontrol eder. ambiguous: true aynı adlı birden fazla şehir olduğunu gösterir: bölgeyi ekleyin |
İlk sonuç bir sonraki haftalık turda gelir (first_result: "next_weekly_cycle"). Bütün yazmalar dry_run: true kabul eder.
Nedenler
Bir yazma reddedilirse yanıt 422 validation_error olur ve şu reason değerlerinden birini taşır:
| Neden | Anlamı |
|---|---|
aud_persona_short | Müşteri tipinin bir adı ve en az 15 karakterlik bir cümlesi olmalı |
aud_persona_max | 3'ten fazla müşteri tipi |
aud_persona_none | Kitle ölçümünü açmak için en az bir müşteri tipi gerekir |
aud_prompts_max, loc_prompts_max | Çok fazla prompt seçildi |
aud_prompts_none | Seçilen promptların hiçbiri ölçülemiyor (kapalı ya da marka sorusu) |
unknown_prompt | Bir prompt kimliği bu panele ait değil |
loc_no_google | Şehir ölçümü için panel motorları arasında Google AI Mode ya da AI Overviews olmalı |
loc_not_found, loc_ambiguous | Şehir panelin ülkesinde yok ya da aynı adlı birden fazla şehir var |
loc_max, loc_none | 3'ten fazla şehir ya da açarken hiç şehir yok |
MCP
get_audiences, update_audiences, suggest_audiences, get_locations, update_locations ve find_city. Yazmalar varsayılan olarak ön izleme yapar.