PushizoDocs
Analitik & veri

Rapor oluşturucu

Hazır sekmelerde olmayan bir soru için kendi raporunuzu kurun: kaynak, metrik, en çok iki kırılım ve filtre seçin. Panelde Raporlar sayfasında veya API ile kullanılır. Raporu kaydedebilir, CSV olarak…

Hazır sekmelerde olmayan bir soru için kendi raporunuzu kurun: kaynak, metrik, en çok iki kırılım ve filtre seçin. Panelde Raporlar sayfasında veya API ile kullanılır. Raporu kaydedebilir, CSV olarak indirebilirsiniz.

POST /v1/apps/{appId}/analytics/reports/run
Authorization: Bearer <analytics:read kapsamlı anahtar>

{
  "source": "deliveries",
  "metrics": ["sent", "open_rate"],
  "dimensions": ["day", "channel"],
  "filters": { "channel": ["email", "ios_push"] },
  "sort": { "by": "sent", "direction": "desc" },
  "limit": 100,
  "days": 30
}

Kaynaklar

KaynakMetriklerKırılımlarFiltreler
deliveriessent, delivered, failed, opened, clicked, delivery_rate, open_rate, click_rate, failure_rateday, week, month, channel, provider, campaign, statuschannel, provider, campaign, status
eventscount, unique_users, value_sum, value_avgday, week, month, name, sourcename, source
conversionsconversions, revenue, unique_usersday, week, month, campaign, event_name, kindcampaign, event_name, kind

Listede olmayan alan reddedilir. Kişisel veri (kullanıcı kimliği, e-posta) kırılım olamaz; yanıt yalnızca toplam içerir.

Hesap

  • Oranlar hazır raporlarla aynıdır: open_rate = opened / sent, click_rate = clicked / sent, delivery_rate = delivered / sent, failure_rate = failed / (sent + failed).
  • Zaman kırılımları UTC'dir. Hafta pazartesi başlar.
  • Dönem: days (son N gün) veya from ve to. İkisi birlikte verilemez; hiçbiri verilmezse son 30 gün.
  • Varsayılan sıralama: zaman kırılımı varsa kronolojik, yoksa ilk metrik büyükten küçüğe. Boş oran her yönde sonda kalır.

Sınırlar

  • En çok 8 metrik, 2 kırılım, filtre başına 50 değer, 1.000 satır.
  • En çok 5.000 grup okunur. Aşılırsa truncated: true döner ve totals boş gelir, çünkü eksik veri üstünden toplam yanıltır. Satır sınırı aşıldığında da truncated: true döner, ama totals tüm grupları kapsar.
  • unique_users satırlar arasında toplanamaz: totals içinde boş gelir.

Kayıt

UçKapsamAçıklama
GET /v1/apps/{appId}/analytics/reportsanalytics:readKayıtlı raporlar
POST /v1/apps/{appId}/analytics/reportsadmin{ "name": "...", "definition": { ... } }
GET /v1/apps/{appId}/analytics/reports/{id}analytics:readTek rapor
PATCH /v1/apps/{appId}/analytics/reports/{id}adminAd veya tanım
DELETE /v1/apps/{appId}/analytics/reports/{id}adminSiler, veriyi etkilemez

App başına en çok 100 rapor kaydedilir. Yalnızca tanım saklanır; days kullanan rapor her çalıştırmada güncel dönemi okur. Panelde kaydetme ve silme veri dışa aktarma izni ister (analist ve üstü); izleyici çalıştırabilir.

Bu sayfada