Résultats
Résultats répond à « est-ce que Skoup marche ? » en un appel : pour une marque sur un marché, semaine par semaine, si les assistants IA la voient (visibilité), lui envoient des visiteurs (visites IA) et si ces visites la choisissent — commandes IA pour une boutique, abonnements IA pour un SaaS, événements clés des visites IA (réservations, appels, inscriptions) sinon. Des repères posent sur le même axe le début de Skoup, les correctifs prouvés par la mesure, les intégrations et les write-backs.
Je veux…
| Je veux… | Appel |
|---|---|
| Les trois étages des 90 derniers jours | GET /v1/brands/{brand}/results/timeline?market=FR |
| Tout depuis le début de Skoup, avec le mois d’avant | GET /v1/brands/{brand}/results/timeline?market=FR&period=since |
| L’avant / après Skoup en trois chiffres | le même appel — lire since |
| Les correctifs sur la courbe | le même appel — markers de kind: fix, puis GET /v1/brands/{brand}/tasks/{task} pour chaque task_ids |
| Ce que « choisi » compte pour cette marque | le même appel — lire outcome_kind (orders, subscriptions, key_events) |
| Une catégorie du catalogue (boutique) | GET /v1/brands/{brand}/results/timeline?market=FR&category=Gravel — noms dans categories |
| Les pages que les assistants lisent pour répondre | le même appel — weeks[].ai_reads et ai_reads_pages ; le détail dans GET /v1/brands/{brand}/agent-reads |
Scope : revenue:read. Tous les plans. Un assistant lit la même frise avec l’outil MCP get_results_timeline.
Comment c’est construit
- Un seul axe. Les semaines sont celles de la tendance de visibilité (lundi → dimanche, UTC), la plus ancienne d’abord ;
completevaut false pour la semaine en cours.period=sincedémarre 4 semaines avant le début de Skoup pour montrer l’historique de trafic avant la première mesure. - Le début de Skoup (
started_at) est la fin du premier sampling de la marque sur le marché.nulltant que le marché n’a jamais été mesuré —period=sinceretombe alors sur 90 jours. - « Choisi » suit la marque : commandes et CA IA pour une boutique, abonnements et nouveau MRR IA pour un SaaS dont Stripe est connecté, événements clés des visites IA sinon (SaaS sans Stripe compris) —
by_eventles nomme sur une semaine mesurée par le script seul,selected_eventsliste les événements que le site compte (null= tous les événements nommés). - Lu par les assistants (
ai_reads) : les pages que ChatGPT, Perplexity, Claude… ont lues pour répondre à quelqu’un, telles que votre serveur les transmet (Skoup Analytics › Lectures par les assistants) —fetches, la partverifiedpar les plages d’IP de l’éditeur, etsurfaces(par éditeur). Les lectures sont celles du site, quel que soit le marché ;ai_reads_pagesliste les pages les plus lues sur l’axe. - Une catégorie restreint la visibilité (réponses citant un de ses produits) et les commandes (ses lignes de commande) — jamais les visites, qui restent celles du site.
- La visibilité reste brute :
hits/runspar modèle, plus lasharetous modèles. Ré-agrégez sur les modèles qui vous intéressent. sinceest là quelle que soit la période. Il compare la première semaine mesurée de visibilité à la dernière (by_modelbruts, plusdelta_pointsavec sonintervalà 95 % tous modèles :interval_contains_zero: trueveut dire que le mouvement est dans le bruit), et la moyenne hebdo (per_week) des 4 semaines complètes avant le début aux 4 dernières, pour les visites et le résultat. Visites et événements clés y sont comparés avec le même outil des deux côtés : Google Analytics s’il a mesuré les deux fenêtres (même quand le script Skoup mesure les semaines récentes), sinon le script ; chaque côté fait la moyenne des seules semaines que cet outil a mesurées en entier. Si aucun outil ne couvre les deux fenêtres, chaque côté garde la source de la frise et la nomme.
Pièges
nulln’est jamais 0. Une semaine que personne n’a mesurée asessions: null(oucount: null) etsource: null; une semaine sans sampling avisibility: null.0est une semaine mesurée sans rien.- Une source par jour, jamais additionnée. Les visites IA viennent du script Skoup à partir de son premier jour, de Google Analytics avant ; chaque semaine dit laquelle (
script,google_analytics,mixedpour la semaine de la bascule). Les commandes disent leur boutique (shopify,woocommerce), les abonnementsstripe. sincepeut citer une autre source que la frise.since.visits.after.sourcepeut valoirgoogle_analyticsalors que les dernières semaines deweeksdisentscript: Google Analytics ne compte que les visiteurs qui acceptent ses cookies, le script tout le monde, et un avant / après entre les deux montrerait une fausse hausse. Comparez toujoursbeforeetafterd’un même bloc entre eux, jamais à une semaine de la frise.- Une lecture n’est pas une visite.
ai_readsest à côté deai_visits, jamais additionné.nulltant que votre serveur n’a transmis aucune lecture (et pour les semaines d’avant),0une semaine sans lecture après. - L’avant peut être vide. Sans historique Google Analytics, les visites d’avant Skoup sont
null:since.visits.beforevautnull, pas un 0 à comparer. - Pas d’event. La frise est calculée à l’appel ; suivez
sampling.completedpour savoir quand une nouvelle semaine de visibilité arrive. google,google_ai(etgoogle,google_ai_impressionsde chaque semaine) sont réservés aux séries Search Console :nullpour l’instant.- Une arrivée directe n’est pas une visite IA.
direct_on_citedcompte les visites sans provenance arrivées sur une page que les IA citent, à côté des visites IA, jamais additionnées. Chaque semaine ditdays, les jours que le script a comptés :7pour une semaine entière, moins pour la semaine où il a été posé et la semaine en cours. Une moyenne hebdomadaire ne lit que les semaines àdays: 7.
Last updated on