Bu rehberde: OrqLabs'taki tüm ölçümleri tek ekranda sorgulamayı öğrenirsiniz. 43 metriğin ne anlama geldiğini ve nereden geldiğini, hazır soru örneklerini ve kendi metriğinizi eklemeyi görürsünüz.
⏱ 15 dakika
İstatistik gezgini
Analitik → İstatistik gezgini tüm ölçümleri tek sorgu ekranında sunar. Veriler günlük toplamlardan gelir.
Nasıl sorgulanır?
- ③'te Metrikler kutusundan bir veya birkaç metrik seçin. Örneğin "Yayınlanan gönderi" ve "Sosyal etkileşim".
- Tarih aralığını seçin.
- Ayrıntı düzeyi: gün (varsayılan), hafta, ay.
- Proje: boşsa organizasyon toplamı.
- Kırılım (isteğe bağlı): platform, kanal, model, ajan türü, iş akışı, kaynak, durum.
- Sonuç grafik ve tablo olarak gelir. CSV indir ile alabilirsiniz.
Her seride toplam ve önceki eşit döneme göre değişim yüzdesi görünür.
Geliştirici notu: Sorgu
POST /orgs/:orgId/stats/query { metrics, from, to, granularity, projectId, groupBy }. Yanıtseries[]: { metric, group, points[], total, changePct }. Panel özetiGET /orgs/:orgId/stats/overview?projectId=&from=&to=(DashboardOverview).
Panel'deki kartlar ve grafikler aynı verilerden beslenir. Ayrıntı: Raporlar ve istatistikleri anlama.
Metrik referansı
Birimler: adet, dolar, token, oran (0-1), saniye.
İş akışları ve ajanlar
| Metrik | Anlamı | Birim | Kırılım |
|---|---|---|---|
workflow.runs | Başlayan çalıştırma | adet | iş akışı, tetikleyici türü |
workflow.runs.succeeded | Başarılı biten | adet | iş akışı |
workflow.runs.failed | Hatalı biten | adet | iş akışı |
agent.runs | Ajan çalıştırması | adet | ajan türü, ajan |
agent.runs.failed | Hata / bütçe aşımı / adım sınırı | adet | ajan türü, durum |
llm.input_tokens | Giriş token | token | model, ajan türü |
llm.output_tokens | Çıkış token | token | model, ajan türü |
llm.cost_usd | Yapay zekâ maliyeti | dolar | model, ajan türü, iş akışı |
İçerik ve sosyal
| Metrik | Anlamı | Birim | Kırılım |
|---|---|---|---|
content.posts.created | Oluşturulan gönderi (taslak dahil) | adet | platform, kaynak |
content.posts.published | Yayınlanan | adet | platform |
content.posts.failed | Yayın hatası | adet | platform, hata kodu |
social.impressions | Gösterim/erişim | adet | platform |
social.engagements | Beğeni + yorum + paylaşım + kayıt | adet | platform |
social.followers | Takipçi (günlük anlık) | adet | platform |
social.clicks | Bağlantı tıklaması | adet | platform |
Mesajlaşma
| Metrik | Anlamı | Birim | Kırılım |
|---|---|---|---|
messages.inbound | Gelen mesaj | adet | kanal |
messages.outbound | Giden mesaj (bot + insan + kampanya) | adet | kanal, gönderen |
messages.bot_replies | Bot yanıtı | adet | kanal |
conversations.opened | Yeni konuşma | adet | kanal |
conversations.handoffs | İnsana devir | adet | kanal, neden |
conversations.resolved_by_bot | Devirsiz kapanan | adet | kanal |
Müşteri adayları
| Metrik | Anlamı | Birim | Kırılım |
|---|---|---|---|
leads.created | Yeni aday | adet | kaynak |
leads.qualified | "Nitelikli"ye geçiş | adet | kaynak, ajan türü |
leads.contacted | "İletişime geçildi"ye geçiş | adet | kanal |
leads.replied | "Yanıtladı"ya geçiş | adet | kanal |
leads.converted | "Dönüştü"ye geçiş | adet | kaynak |
Kampanyalar
| Metrik | Anlamı | Birim | Kırılım |
|---|---|---|---|
campaign.sent | Gönderilen | adet | kanal, kampanya |
campaign.delivered | Teslim edilen | adet | kanal, kampanya |
campaign.read | Okunan/açılan | adet | kanal, kampanya |
campaign.replied | Yanıtlanan | adet | kanal, kampanya |
Google Analytics
| Metrik | GA4 karşılığı | Birim |
|---|---|---|
ga.sessions | sessions | adet |
ga.users | totalUsers | adet |
ga.new_users | newUsers | adet |
ga.pageviews | screenPageViews | adet |
ga.engaged_sessions | engagedSessions | adet |
ga.conversions | conversions / key events | adet |
ga.avg_session_duration | averageSessionDuration | saniye |
ga.bounce_rate | bounceRate | oran |
İlk altısı kanala göre kırılabilir. Oran metriklerinde haftalık/aylık toplama ağırlıklı ortalamadır.
Platform (yalnızca yönetici)
| Metrik | Anlamı |
|---|---|
platform.active_orgs | Dönemde en az bir çalıştırma yapan organizasyon |
platform.new_signups | Yeni kayıt |
platform.mrr_usd | Aylık yinelenen gelir |
platform.api_requests | API istek sayısı |
Bu dördü organizasyon sorgularında görünmez.
Kendi metriğiniz
Özel metrik kaydet kutusu (analytics.recordStat) custom.<ad> anahtarıyla değer yazar. Örnekler: custom.orders, custom.demo_requests, custom.revenue_try. Gezginde diğerleri gibi sorgulanır; KPI kontrolü kutusunda kullanılabilir. Kurallar: küçük harf, nokta ve alt çizgi; organizasyon başına günde 100 farklı anahtar.
Hazır soru örnekleri
| Soru | Nasıl sorgulanır |
|---|---|
| Hangi platform en çok etkileşim getiriyor? | Sosyal etkileşim, kırılım platform, haftalık |
| Bot çözüm oranı | Açılan konuşma ve bot çözümü, kırılım kanal → ikinci / birinci |
| Model başına maliyet | Yapay zekâ maliyeti, kırılım model, aylık |
| Aday hunisi | Yeni, nitelikli, iletişime geçildi, yanıtladı, dönüştü |
| Kampanya okunma oranı | Gönderilen ve okunan, kırılım kampanya |
| Organik sosyal trafik | GA oturumları, kırılım kanal → "Organic Social" |
| Yayın hata oranı | Yayınlanan ve yayın hatası, kırılım platform |
Veriler ne zaman güncellenir?
- Olaylar anında sayılır; her gece 00:15 UTC'de önceki gün toplanır; gün içinde saatlik güncellenir.
- GA4 metrikleri sabah senkron sonrası gelir; son 2 gün yeniden yazılır.
- Gün sınırı proje saat dilimine göredir; organizasyon toplamlarında UTC.
Dikkat: Bugünün değerleri gün bitene kadar eksik görünür.
Sık sorulan sorular
Grafikte neden bugün düşük görünüyor? Gün bitmedi. Değerler saatlik güncellenir ve gece kesinleşir.
Veriyi Excel'e alabilir miyim? Evet. CSV indir düğmesi geçerli görünümü indirir.
Satış gibi kendi verimi ekleyebilir miyim?
Evet. Webhook tetikleyicisi + Özel metrik kaydet kutusuyla custom.orders gibi metrikler yazarsınız.