EndPoint des Signaux Commerciaux
Votre site web sait déjà combien d'utilisateurs il a, qui s'est inscrit aujourd'hui, combien d'articles ou de profils existent, combien de paiements ont été effectués et ce qui attend en modération. Envoyez ces chiffres à un EndPoint et regardez chaque site que vous gérez dans un seul tableau de bord — avec des alertes d'anomalies, des cibles et un benchmark de portefeuille. C'est un EndPoint, pas un widget : serveur à serveur, pas de données personnelles, juste des comptes.
Ce que vous pouvez envoyer
Tout compteur que vous nommez. Regroupez-le dans une catégorie et nous le traçons, le décomposons et le surveillons pour vous.
Utilisateurs
total des utilisateurs, inscriptions par jour, abonnés, suppressions
Contenu
matériaux de tout type — articles, vidéos, profils, annonces
Revenu
tentatives de paiement, paiements réussis, remboursements — plus conversion dérivée
Modération
profils en attente de suppression, éléments signalés, files d'attente de révision
Retour d'information
messages de formulaire de contact, tickets de support, NPS
Autre chose
nommez une métrique et elle apparaît — aucune configuration de notre côté
L'EndPoint
Exemples
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"Remplacez YOUR_SITE_KEY par la clé de votre tableau de bord. Chaque site a sa propre clé ; elle n'autorise jamais que l'envoi des chiffres de ce site.
Champs de signal
| Champ | Signification | |
|---|---|---|
metric | requis | Any key you choose — users, registrations, materials, payment_success… Stored under this key forever. |
value | requis | The number. For a gauge it is the current total; for a count it is that period's amount. |
kind | optionnel | "gauge" (a snapshot total, e.g. total users now) or "count" (per-day amount, the default). |
day | optionnel | YYYY-MM-DD. Defaults to today. Send past days to backfill; re-sending a day overwrites it. |
dim | optionnel | A breakdown value, e.g. the material type "article"/"video". One series per dimension. |
category | optionnel | users · content · revenue · moderation · feedback · engagement · custom — groups the metric. |
unit | optionnel | A short unit shown next to the number, e.g. "EUR", "GB". |
good_dir | optionnel | "up" (default), "down" (lower is better, e.g. a deletion queue) or "none". |
attention | optionnel | true pins the metric to the cross-site cockpit as a "needs clearing" number. |
event | optionnel | true + a count with no day increments today instead of overwriting it. |
Bidirectionnel par conception
Commandes de retour
Chaque envoi renvoie toutes les commandes que vous avez mises en file d'attente dans le tableau de bord — par exemple, « envoyer un instantané complet ». Votre site les exécute et accuse réception.
Aperçus de retour
Appelez /endpoint/insights pour afficher vos propres chiffres en direct, cibles et alertes dans votre panneau d'administration.
Référence de portefeuille
Nous renvoyons la médiane de chaque métrique à travers vos autres sites, afin qu'un site puisse montrer comment il se compare aux autres.
Surveillance des anomalies
Nous surveillons les chutes brusques, les pics, une intégration silencieuse et un tunnel de paiement qui cesse de convertir — et nous les signalons.
EndPoint des Signaux Commerciaux
Ce que cette page répond
- endPoint des Signaux Commerciaux
- guide EndPoint des Signaux Commerciaux
- endPoint des Signaux Commerciaux expliqué
- tutoriel EndPoint des Signaux Commerciaux
- commencer avec EndPoint des Signaux Commerciaux
- meilleures pratiques EndPoint des Signaux Commerciaux
- endPoint des Signaux Commerciaux étape par étape
- qu'est-ce que EndPoint des Signaux Commerciaux
- endPoint des Signaux Commerciaux pour les débutants
- liste de contrôle EndPoint des Signaux Commerciaux
- exemples de EndPoint des Signaux Commerciaux
- pourquoi EndPoint des Signaux Commerciaux est important