Rapor Özeti API

Rapor özeti ucu, bir kanalın panel ana sayfasındaki özet rakamlarını kendi arka ofisinize verir: Akinon Omnitron içindeki Selwise uzantısı bunu kullanır, kendi yönetim ekranınız da kullanabilir. Bu sayfa HTTP sözleşmesidir.

{
  "channel": {
    "name": "string",
    "platform": "akinon"
  },
  "days": 30,
  "generatedAt": "2026-10-21T09:12:00.000Z",
  "lookbackHours": 0,
  "current": {
    "startDate": "2026-10-21T09:12:00.000Z",
    "endDate": "2026-10-21T09:12:00.000Z",
    "orders": 0,
    "revenueByCurrency": [
      {
        "currency": "TRY",
        "orders": 0,
        "revenue": 0
      }
    ],
    "attributed": {
      "orders": 0,
      "revenueByCurrency": [
        {
          "currency": "TRY",
          "orders": 0,
          "revenue": 0
        }
      ]
    },
    "visitors": 0
  },
  "previous": {
    "startDate": "2026-10-21T09:12:00.000Z",
    "endDate": "2026-10-21T09:12:00.000Z",
    "orders": 0,
    "revenueByCurrency": [
      {
        "currency": "TRY",
        "orders": 0,
        "revenue": 0
      }
    ],
    "attributed": {
      "orders": 0,
      "revenueByCurrency": [
        {
          "currency": "TRY",
          "orders": 0,
          "revenue": 0
        }
      ]
    },
    "visitors": 0
  },
  "comparison": {
    "orders": true,
    "events": true,
    "reason": "channel_created"
  },
  "modules": [
    {
      "module": "recommendation",
      "orders": 0,
      "revenueByCurrency": [
        {
          "currency": "TRY",
          "orders": 0,
          "revenue": 0
        }
      ]
    }
  ],
  "connection": {
    "status": "connected",
    "lastError": "string",
    "streams": [
      {
        "stream": "orders",
        "lastSuccessAt": "2026-10-21T09:12:00.000Z",
        "lastError": "string"
      }
    ]
  }
}

curl -X GET 'https://api.selwise.com/api/v1/public/sites/{siteKey}/reports/summary' \
  -H "x-selwise-api-key: $SELWISE_API_KEY"

GET /api/v1/public/sites/SITE_KEY/reports/summary?days=30
x-selwise-api-key: swpk_live_...

Kimlik doğrulama

Uç her istekte reports_read kapsamlı bir site API anahtarı ister; tarayıcının alan adı yetki sayılmaz. Anahtarı Channels ekranında kanalın satırındaki ⋮ menüsünden API keys'i açıp Purpose (Kullanım amacı) olarak Reporting (Raporlama) seçerek oluşturun. Ayrıntı: API Anahtarları.

Kapsam yalnız bu ucu açar ve hiçbir şey yazamaz. Ayrı olmasının sebebi: kanalın cirosu bir vitrin sayfasının, bir SSR anahtarının ya da bir uygulama dosyasının okuyabileceği bir rakam değildir. Anahtarı sunucunuzda tutun.

Yanıt

Rakamların hepsi panel ana sayfasının aynı ölçümüdür; bu uç hiçbir rakamı kendisi türetmez, yani arka ofisiniz panelin çelişeceği bir sayı gösteremez.

• Para birimi başına. İki para biriminde sipariş alan bir kanalın cirosu tek sayıya toplanamaz; her para birimi ayrı satırdır.
• attributed etkidir, kazanç değil. Siparişin son Selwise dokunuşuna yazılan cirodur. "Selwise'ın kazandırdığı" demek için kontrol grubu ölçümü gerekir; bu uç onu vermez.
• Ölçülmeyen sıfır değildir. Pencerenin olayları artık saklanmıyorsa attributed null gelir; bunu 0 olarak göstermeyin, "—" gösterin.
• Kampanya adlarıyla yüzey tablosu, sepet terk sayısı ve günlük seri bu uçta yoktur; onlar panelin ekranlarıdır.

Cache-Control: private, max-age=60 ile gelir; aynı sayfayı bir dakika içinde iki kez açmak iki ölçüm maliyeti doğurmaz.

{
  "channel": { "name": "Ardisa", "platform": "akinon" },
  "days": 30,
  "generatedAt": "2026-11-05T10:00:00.000Z",
  "lookbackHours": 168,
  "current": {
    "startDate": "2026-10-06T00:00:00.000Z",
    "endDate": "2026-11-05T00:00:00.000Z",
    "orders": 1240,
    "revenueByCurrency": [{ "currency": "TRY", "orders": 1240, "revenue": 1873400.5 }],
    "attributed": { "orders": 310, "revenueByCurrency": [{ "currency": "TRY", "orders": 310, "revenue": 402115.2 }] },
    "visitors": 48210
  },
  "previous": null,
  "comparison": { "orders": false, "events": false, "reason": "channel_created" },
  "modules": [{ "module": "recommendation", "orders": 140, "revenueByCurrency": [{ "currency": "TRY", "orders": 140, "revenue": 180200 }] }],
  "connection": {
    "status": "connected",
    "lastError": null,
    "streams": [{ "stream": "orders", "lastSuccessAt": "2026-11-05T09:52:00.000Z", "lastError": null }]
  }
}