Segnali Aziendali · EndPoint

EndPoint dei segnali aziendali

Il tuo sito web sa già quanti utenti ha, chi si è registrato oggi, quanti articoli o profili esistono, quanti pagamenti sono andati a buon fine e cosa è in attesa di moderazione. Invia quei numeri a un EndPoint e osserva ogni sito che gestisci in un'unica dashboard — con avvisi di anomalie, obiettivi e un benchmark del portafoglio. È un EndPoint, non un widget: server a server, nessun dato personale, solo conteggi.

01

Cosa puoi inviare

Qualsiasi contatore tu nomini. Raggruppalo in una categoria e noi lo tracciamo, lo scomponiamo e lo monitoriamo per te.

Utenti

utenti totali, registrazioni per giorno, abbonati, eliminazioni

Contenuto

materiali di qualsiasi tipo — articoli, video, profili, elenchi

Entrate

tentativi di pagamento, pagamenti riusciti, rimborsi — più conversione derivata

Moderazione

profili in attesa di eliminazione, elementi segnalati, code di revisione

Feedback

messaggi del modulo di contatto, ticket di supporto, NPS

Qualcos'altro

nomina una metrica e appare — nessuna configurazione da parte nostra

02

L'EndPoint

POSThttps://astrina.io/endpoint/ingestInvia un batch di segnali. Autenticazione: la chiave del tuo sito nell'intestazione X-Astrina-Key.
GEThttps://astrina.io/endpoint/pingHeartbeat — restituisce comandi in sospeso senza inviare dati.
GEThttps://astrina.io/endpoint/insightsRecupera la salute calcolata di questo sito: valori attuali, delta, obiettivi, avvisi e la mediana dei tuoi altri siti.
POSThttps://astrina.io/endpoint/ackRiconosci un comando consegnato dal suo id.
03

Esempi

curl -X POST https://astrina.io/endpoint/ingest \
  -H "X-Astrina-Key: YOUR_SITE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signals": [
      { "metric": "users",              "kind": "gauge", "value": 15230, "category": "users" },
      { "metric": "registrations",      "value": 42,     "category": "users" },
      { "metric": "materials", "kind": "gauge", "value": 842, "dim": "article", "category": "content" },
      { "metric": "materials", "kind": "gauge", "value": 301, "dim": "video",   "category": "content" },
      { "metric": "payment_requests",   "value": 18,     "category": "revenue" },
      { "metric": "payment_success",    "value": 11,     "category": "revenue", "unit": "EUR" },
      { "metric": "feedback",           "value": 3,      "category": "feedback" },
      { "metric": "profiles_to_delete", "kind": "gauge", "value": 5, "category": "moderation",
        "good_dir": "down", "attention": true }
    ]
  }'
<?php
// Run this daily (cron) on your own site. Sends only counts — never personal data.
$key = 'YOUR_SITE_KEY';
$payload = ['signals' => [
    ['metric' => 'users',         'kind' => 'gauge', 'value' => usersTotal(),          'category' => 'users'],
    ['metric' => 'registrations', 'value' => registrationsToday(),                     'category' => 'users'],
    ['metric' => 'payment_requests', 'value' => paymentAttemptsToday(),               'category' => 'revenue'],
    ['metric' => 'payment_success',  'value' => paymentsPaidToday(), 'unit' => 'EUR',  'category' => 'revenue'],
    ['metric' => 'feedback',      'value' => feedbackToday(),                          'category' => 'feedback'],
    ['metric' => 'profiles_to_delete', 'kind' => 'gauge', 'value' => deletionQueue(),
        'category' => 'moderation', 'good_dir' => 'down', 'attention' => true],
]];
$ch = curl_init('https://astrina.io/endpoint/ingest');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['X-Astrina-Key: YOUR_SITE_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true,
]);
$resp = json_decode(curl_exec($ch), true);
// Two-way: act on anything Astrina asks for (e.g. a fresh full snapshot).
foreach ($resp['requests'] ?? [] as $cmd) {
    if ($cmd['cmd'] === 'full_snapshot') { /* push your whole history, then: */ }
    // acknowledge so it is not re-sent:
    // curl https://astrina.io/endpoint/ack  -d '{"id": ' . $cmd['id'] . '}'
}
<?php
// One-off: backfill a year of daily registrations so the charts start full.
$signals = [];
foreach (registrationsByDay('-365 days') as $day => $n) {   // 'YYYY-MM-DD' => int
    $signals[] = ['metric' => 'registrations', 'value' => $n, 'day' => $day, 'category' => 'users'];
}
// up to 2000 points per request
foreach (array_chunk($signals, 2000) as $chunk) {
    postJson('https://astrina.io/endpoint/ingest', ['signals' => $chunk], 'YOUR_SITE_KEY');
}
# Pull this site's computed health BACK (current values, 30-day deltas, target
# progress, open alerts, and the median across YOUR OTHER sites) to show it in-app:
curl "https://astrina.io/endpoint/insights" -H "X-Astrina-Key: YOUR_SITE_KEY"

Sostituisci YOUR_SITE_KEY con la chiave dal tuo dashboard. Ogni sito ha la propria chiave; autorizza solo l'invio dei numeri di quel sito.

04

Campi di segnale

CampoSignificato
metricrichiestoAny key you choose — users, registrations, materials, payment_success… Stored under this key forever.
valuerichiestoThe number. For a gauge it is the current total; for a count it is that period's amount.
kindopzionale"gauge" (a snapshot total, e.g. total users now) or "count" (per-day amount, the default).
dayopzionaleYYYY-MM-DD. Defaults to today. Send past days to backfill; re-sending a day overwrites it.
dimopzionaleA breakdown value, e.g. the material type "article"/"video". One series per dimension.
categoryopzionaleusers · content · revenue · moderation · feedback · engagement · custom — groups the metric.
unitopzionaleA short unit shown next to the number, e.g. "EUR", "GB".
good_diropzionale"up" (default), "down" (lower is better, e.g. a deletion queue) or "none".
attentionopzionaletrue pins the metric to the cross-site cockpit as a "needs clearing" number.
eventopzionaletrue + a count with no day increments today instead of overwriting it.
05

Bidirezionale per design

Comandi di ritorno

Ogni invio restituisce i comandi che hai messo in coda nel dashboard — ad esempio “invio un'istantanea completa”. Il tuo sito li esegue e conferma.

Analisi di ritorno

Chiama /endpoint/insights per mostrare i tuoi numeri live, obiettivi e avvisi all'interno del tuo pannello di amministrazione.

Benchmark del portafoglio

Restituiamo la mediana di ciascun indicatore sui tuoi altri siti, in modo che un sito possa mostrare come si confronta con gli altri.

Monitoraggio delle anomalie

Monitoriamo bruschi cali, picchi, un'integrazione silenziosa e un funnel di pagamento che smette di convertire — e li segnaliamo.

EndPoint dei segnali aziendali

Cosa risponde questa pagina

  • endPoint dei segnali aziendali
  • guida a EndPoint dei segnali aziendali
  • endPoint dei segnali aziendali spiegato
  • tutorial di EndPoint dei segnali aziendali
  • iniziare con EndPoint dei segnali aziendali
  • migliori pratiche per EndPoint dei segnali aziendali
  • endPoint dei segnali aziendali passo dopo passo
  • che cos'è EndPoint dei segnali aziendali
  • endPoint dei segnali aziendali per principianti
  • checklist di EndPoint dei segnali aziendali
  • esempi di EndPoint dei segnali aziendali
  • perché EndPoint dei segnali aziendali è importante