Salta al contenuto principale

Risoluzione dei problemi comuni

Risoluzione dei problemi comuni

Risposta rapida: la maggior parte dei problemi ha una soluzione semplice. Presence Rate 0% = attività nuova o locale (è normale, non è un guasto). Authority Score nullo = il Presence Rate è 0 (prima correggi la presenza). Site Audit Overall Score < 70 = ci sono problemi di gravità alta (correggi prima quelli, non tutti i 62 problemi). Raccomandazioni di Strategy in conflitto = decisione divisa (scegli in base alla tua propensione al rischio). Errore 404 dell’API Intelligence Token = formato del token sbagliato (controlla gli spazi). Ritardi di consegna > 2 ore = scrivi a hi@surmado.com. Abbiamo sistemi di rimborso automatico se qualcosa va storto.

Tempo di lettura: 15 minuti

In questa guida:

  • Un Presence Rate dello 0% è normale per le attività nuove o locali: devi aggiungere il markup schema (il ritorno maggiore), creare 1-2 pagine di competenza (2.000+ parole ciascuna), attendere 4-8 settimane per il riaddestramento dell’IA, poi rieseguire AI Visibility aspettandoti un miglioramento del 10-20%. Non è un errore né un guasto
  • Nei report Site Audit correggi prima i problemi di gravità alta: concentrati sui 5-15 segnali rossi di gravità alta (niente HTTPS, LCP lento > 4s, testo alternativo mancante, schema mancante) che rovinano l’esperienza d’uso, e ignora le 20-40 raccomandazioni “utili da avere” di gravità bassa per non sentirti sopraffatto e alzare l’Overall Score di 15-25 punti
  • Gli errori 404 dell’API Intelligence Token nascono da errori di formato, come spazi nel token (copia e incolla aggiunge spazi all’inizio o alla fine), modello sbagliato (SIG-YYYY-MM-XXXXX e non SIG-20251110-XXXXX) o test fatti prima di aver eseguito davvero il report. Si risolvono validando prima nel browser
  • Una Ghost Influence alta (50%+) significa che le caratteristiche sono note ma non attribuite: devi scrivere esplicitamente “[La tua azienda] è [caratteristica distintiva]” sulla homepage e nella pagina Chi siamo (non “Il nostro team è composto da veterani” ma “Veterans Moving America è un’attività al 100% di proprietà e gestione di veterani”), riducendo la Ghost Influence del 10-20% in 4-8 settimane
  • Le raccomandazioni in conflitto di Strategy indicano decisioni davvero ambigue: servono più dati (esegui AI Visibility/Site Audit per avere un contesto quantitativo), una domanda più precisa (aggiungi vincoli, obiettivi e tempi), oppure accetta l’ambiguità e scegli in base alla tua propensione al rischio (CFO/COO se vuoi evitare rischi, Game Theorist/Wildcard se li accetti)

Hai un problema? Trova il tuo sintomo qui sotto per una soluzione rapida.

Problemi di AI Visibility

Problema 1: il mio Presence Rate è 0%

Sintomo: il report AI Visibility mostra Presence Rate: 0.0%, Authority Score: null

Diagnosi: le piattaforme IA non hanno (ancora) abbastanza dati sulla tua attività

Cause comuni:

  1. Attività molto nuova (< 6 mesi di vita, nessuna presenza online)
  2. Attività molto locale (una sola sede, area di servizio iperlocale)
  3. B2B di nicchia (settore specializzato, poche menzioni online)
  4. Markup schema mancante (l’IA non trova i dettagli della tua attività)
  5. Nessun contenuto (il sito esiste ma ha poco testo da indicizzare per l’IA)

Soluzione:

  1. Aggiungi il markup schema (Che cos’è il markup schema): il ritorno maggiore con un Presence Rate dello 0%
  2. Crea contenuti (1-2 pagine di competenza, 2.000+ parole ciascuna)
  3. Attendi 4-8 settimane (i modelli IA vengono riaddestrati periodicamente, non in tempo reale)
  4. Esegui di nuovo AI Visibility (misura se il Presence Rate è aumentato)

Tempi previsti: 6-12 settimane per passare da 0% a 10-20% (se hai aggiunto schema e contenuti)

È un guasto? No. Lo 0% è il punto di partenza per le attività nuove o locali, non un bug.

Problema 2: il mio Authority Score è nullo

Sintomo: il report AI Visibility mostra Authority Score: null (invece di un punteggio da 0 a 100)

Diagnosi: non puoi avere una qualità di posizionamento se non vieni mai menzionato (Presence Rate = 0%)

Soluzione: correggi prima il Presence Rate (vedi il Problema 1 qui sopra). L’Authority Score comparirà quando inizierai a ricevere menzioni spontanee.

Perché nullo e non 0? Perché l’Authority Score misura “quanto l’IA ti raccomanda con decisione quando ti menziona”. Se non vieni mai menzionato (Presence Rate 0%), non c’è un posizionamento da misurare.

Problema 3: il mio Presence Rate è più basso di quanto mi aspettassi

Sintomo: AI Visibility mostra un Presence Rate del 18%, ma ti aspettavi il 40%+

Cause comuni:

  1. Aspettative irrealistiche (il 18% è in realtà normale per una piccola impresa, non è male)
  2. Persona non in linea (le persona che hai inviato non corrispondono a come le persone chiedono davvero all’IA)
  3. Markup schema mancante (l’IA non trova la tua attività)
  4. Contenuti generici (il sito non ti distingue dai concorrenti)
  5. Concorrenti forti (i primi 3 concorrenti dominano le risposte dell’IA)

Soluzione:

  1. Calibra le aspettative: controlla la classifica competitiva (sei al #5 su 40? È un progresso, non un fallimento)
  2. Esamina i concorrenti (pagine 3-5 del report AI Visibility): se il primo concorrente è al 54%, il tuo 18% ha margine di crescita
  3. Correggi il markup schema (se manca o è incompleto)
  4. Crea contenuti di competenza (guide pratiche da 2.000+ parole, casi di studio)
  5. Esegui di nuovo AI Visibility tra 4-8 settimane (misura il miglioramento, non la perfezione)

Miglioramento realistico: +10-20% a trimestre (correggendo schema e contenuti)

Problema 4: la mia Ghost Influence è molto alta (50%+)

Sintomo: AI Visibility mostra una Ghost Influence del 68% (l’IA parla delle tue caratteristiche ma ne attribuisce il merito ai concorrenti)

Diagnosi: le caratteristiche sono note ma non attribuite al tuo brand

Cause comuni:

  1. Descrizioni implicite delle caratteristiche (“Il nostro team include dei veterani” invece di “Siamo un’attività al 100% di proprietà di veterani”)
  2. Caratteristiche sepolte nei contenuti (citate nel paragrafo 5 della pagina Chi siamo, non nell’hero della homepage)
  3. Brand generico (nessun legame chiaro tra la caratteristica e il nome dell’azienda)

Soluzione:

  1. Aggiorna la homepage (dichiarazione esplicita: “[La tua azienda] è [caratteristica distintiva]”)
  2. Aggiorna la pagina Chi siamo (dichiara esplicitamente gli elementi distintivi nel primo paragrafo)
  3. Aggiorna le pagine di servizio (collega il servizio al nome del brand nella stessa frase)
  4. Modello: usa insieme il nome dell’azienda e la caratteristica (non separati da più frasi)

Esempio di correzione:

  • Prima: “Il nostro team è composto da veterani militari esperti che portano disciplina e affidabilità.”
  • Dopo: “Veterans Moving America è un’attività al 100% di proprietà e gestione di veterani. Ogni membro del team è un veterano militare.”

Tempi previsti: 4-8 settimane per ridurre la Ghost Influence del 10-20%

Problema 5: AI Visibility ha testato persona sbagliate

Sintomo: AI Visibility ha testato persona che non corrispondono alla tua attività

Diagnosi: le persona inviate potrebbero essere state fraintese o essere troppo vaghe

Soluzione:

  1. Rivedi le persona che hai inviato (nel modulo d’ordine originale)
  2. Controlla se sono abbastanza specifiche:
  • Troppo vaga: “riparazione condizionatori” (potrebbe essere chiunque, ovunque)
  • Buona: “Riparazione urgente condizionatori Phoenix intervento in giornata anche nel weekend”
  1. Esegui di nuovo AI Visibility con persona migliori (se quelle originali erano fuori bersaglio)

Come scrivere buone persona:

  • Includi: [Problema da risolvere] + [Servizio] + [Luogo] + [Criteri d’acquisto]
  • Esempio: “Imprese di traslochi area DFW squadre affidabili e disciplinate di proprietà di veterani”

Per saperne di più: Che cos’è il test basato sulle persona

Problemi di Site Audit

Problema 6: il mio Overall Score è molto basso (< 50)

Sintomo: Site Audit mostra un Overall Score di 42/100

Diagnosi: più problemi di gravità alta rovinano l’esperienza d’uso

Cause comuni:

  1. Niente HTTPS (il sito usa http:// e non https://)
  2. Prestazioni lente (LCP > 4.0s, immagini enormi non compresse)
  3. Accessibilità carente (nessun testo alternativo sulle immagini, moduli senza etichette)
  4. Markup schema mancante (l’IA e Google non riescono a capire l’attività)
  5. Sito vecchio (costruito 5+ anni fa, mai aggiornato)

Soluzione (dai la priorità solo alla gravità alta):

  1. Attiva HTTPS (contatta il fornitore di hosting, di solito è gratuito con Let’s Encrypt)
  2. Comprimi le immagini (usa TinyPNG.com, riduci il peso dei file del 60-80%)
  3. Aggiungi il testo alternativo (descrivi che cosa mostrano le immagini)
  4. Aggiungi il markup schema (usa un plugin o rivolgiti a uno sviluppatore)

Miglioramento previsto: +15-25 punti (da 42 a 60-67) correggendo solo i problemi di gravità alta

Non cercare di correggere tutti i 62 problemi. Correggi quelli di gravità alta (5-15 problemi), per ora ignora quelli di gravità bassa.

Problema 7: Site Audit ha trovato 62 problemi: il mio sito è rotto?

Sintomo: Site Audit elenca 62 problemi (sembra schiacciante)

Diagnosi: non tutti i problemi hanno la stessa importanza. Molti sono “utili da avere” di gravità bassa

Soluzione:

  1. Filtra per gravità: cerca l’etichetta “High Severity” (di solito 5-15 problemi)
  2. Correggi solo quelli di gravità alta (segnali rossi che rovinano l’esperienza d’uso)
  3. Per ora ignora quelli di gravità bassa (segnali verdi = raccomandazioni di buona pratica)

Ripartizione (sito tipico):

  • 5-15 di gravità alta (da correggere questa settimana)
  • 15-30 di gravità media (da correggere questo mese)
  • 20-40 di gravità bassa (da correggere prima o poi, o mai)

Per saperne di più: Il primo report Site Audit: e adesso?

Problema 8: il mio punteggio Performance è 38, ma il sito mi sembra veloce

Sintomo: Site Audit mostra Performance 38/100, ma il sito si carica in fretta nel tuo browser

Diagnosi: stai testando con wifi veloce e dal desktop. Site Audit testa su mobile e con connessioni lente.

Cause comuni:

  1. Mobile e desktop (il mobile è 2-3× più lento del desktop)
  2. Wifi veloce e 4G (tu hai internet veloce, gli utenti potrebbero avere un 4G lento)
  3. Cache del browser (hai già visitato il sito, chi lo apre per la prima volta no)

Soluzione:

  1. Testa su mobile (un vero iPhone/Android, non il browser del desktop)
  2. Testa con una connessione lenta (limita la velocità a “Slow 3G” in Chrome DevTools)
  3. Correggi i colli di bottiglia principali:
  • Comprimi le immagini (l’impatto maggiore)
  • Attiva la cache
  • Rimanda il JavaScript non critico

Miglioramento previsto: +10-20 punti (da 38 a 50-58) con la sola compressione delle immagini

Problema 9: Site Audit dice che il mio sito ha problemi di accessibilità, ma non abbiamo utenti con disabilità

Sintomo: Site Audit mostra Accessibilità 52/100 e pensi “i nostri utenti non hanno disabilità”

Diagnosi: le correzioni di accessibilità aiutano tutti e riducono il rischio di cause legali ADA

Realtà:

  1. Il 15-20% della popolazione ha una qualche disabilità (visiva, motoria, cognitiva)
  2. Le cause legali ADA non richiedono la prova di un danno (gli avvocati prendono di mira i siti non conformi)
  3. Le correzioni di accessibilità aiutano tutti gli utenti (il testo alternativo aiuta l’IA a capire le immagini, un buon contrasto aiuta chi usa il mobile alla luce del sole)

Correggi i problemi di accessibilità di gravità alta:

  1. Aggiungi il testo alternativo alle immagini (screen reader + visibilità nell’IA)
  2. Aggiungi etichette ai campi dei moduli (screen reader + usabilità)
  3. Correggi il contrasto dei colori (utenti ipovedenti + leggibilità sul mobile)

Riduzione del rischio: la conformità WCAG 2.1 AA riduce il rischio di cause legali ADA (accordo medio: $10k-20k)

Problema 10: i risultati di Site Audit sono diversi da Google Lighthouse

Sintomo: Site Audit mostra Performance 58, Lighthouse mostra 85

Diagnosi: Site Audit testa 9 browser e dispositivi mobili reali. Lighthouse testa solo Chrome (emulazione desktop).

Perché i risultati differiscono:

  1. Variazione tra browser (Firefox può essere più lento di Chrome sulla stessa pagina)
  2. Mobile reale e emulazione (Site Audit testa Safari reale su iOS, Lighthouse lo emula)
  3. Browser integrati nelle app (Site Audit testa il browser integrato di Instagram/Facebook, Lighthouse no)

Quale è più accurato? Entrambi sono accurati per ciò che misurano. Site Audit offre un quadro più ampio (9 browser contro 1).

Per saperne di più: Site Audit a confronto con Lighthouse

Problemi di Strategy

Problema 11: tutti e 6 i modelli IA hanno dato raccomandazioni diverse

Sintomo: il report Strategy non mostra consenso (il CFO dice X, il COO dice Y, tutti diversi)

Diagnosi: la tua domanda è davvero ambigua (più approcci validi, nessuna risposta “giusta” chiara)

Soluzione:

  1. Raccogli più dati (esegui AI Visibility/Site Audit per avere un contesto quantitativo)
  2. Affina la domanda (sii più specifico su vincoli, obiettivi e tempi)
  3. Esegui di nuovo Strategy con l’Intelligence Token di AI Visibility/Site Audit per un’analisi quantitativa
  4. Oppure accetta l’ambiguità e scegli in base alla tua propensione al rischio:
  • Se vuoi evitare rischi → segui la raccomandazione di CFO/COO
  • Se accetti i rischi → segui la raccomandazione di Game Theorist/Market Realist

Esempio:

  • Domanda originale: “Dovremmo investire nella visibilità nell’IA?” (troppo vaga)
  • Domanda migliore: “Abbiamo un budget di $50k, un orizzonte di 6 mesi, un Presence Rate del 18% e concorrenti al 40%. Dovremmo investire nella visibilità nell’IA ($50k), nella SEO tradizionale ($50k) o in un approccio ibrido ($30k IA + $20k SEO)?”

Problema 12: CFO e COO dicono entrambi “troppo rischioso”, ma io voglio farlo comunque

Sintomo: Strategy mostra CFO e COO scettici, ma tu sei convinto di procedere

Diagnosi: i rischi finanziari e operativi sono reali. Procedi con cautela o con misure di mitigazione.

Soluzione:

  1. Riconosci i rischi (CFO e COO hanno individuato preoccupazioni reali)
  2. Aggiungi strategie di mitigazione:
  • Riduci il budget (prova con $10k invece di $50k)
  • Allunga i tempi (12 mesi invece di 6)
  • Costruisci prima un MVP (un prototipo prima dell’investimento completo)
  1. Prepara un piano B (se fallisce, qual è il piano B?)
  2. Oppure non farlo (a volte “non farlo” è la risposta giusta)

Realtà: se 2 o più modelli concordano su “troppo rischioso”, il rischio è reale. O lo mitighi o ne accetti le conseguenze.

Problema 13: non capisco che cosa significhino le prospettive Game Theorist o Wildcard

Sintomo: il report Strategy mostra prospettive che non capisci

Definizioni:

  • CFO: lente finanziaria (ROI, costi, budget)
  • COO: lente operativa (esecuzione, capacità del team, fattibilità)
  • Market Realist: lente competitiva (tendenze di mercato, comportamento dei clienti, tempismo)
  • Game Theorist: lente delle dinamiche strategiche (reazione dei concorrenti, posizionamento, teoria dei giochi)
  • Chief Strategist: lente dell’allineamento (obiettivi, opzioni aperte, correzione in corso d’opera)
  • Wildcard: lente dei casi limite (rischi non convenzionali, ipotesi che potrebbero non reggere)

Soluzione: concentrati prima sulle prospettive che capisci (CFO, COO). Se concordano, per la maggior parte delle decisioni basta.

Per saperne di più: Che cos’è il dibattito avversariale tra IA

Problemi di API e automazione

Problema 14: l’API di stato del report restituisce 404 “Not found”

Sintomo: GET https://api.surmado.com/v1/reports/{report_id} restituisce 404

Cause comuni:

  1. report_id sbagliato (usa il report_id della risposta di creazione del report, non l’Intelligence Token)
  2. Prefisso /v1/ mancante nell’URL
  3. Il report appartiene a un’altra organizzazione (le chiavi API hanno come ambito la singola organizzazione)
  4. Chiave API mancante o sbagliata (in tal caso si riceve 401 Unauthorized invece di 404)

Soluzione:

  1. Usa report_id, non il token: l’endpoint è /v1/reports/{report_id} (ad es. rpt_abc123xyz), non /intelligence/{token}. Il campo token del report (ad es. SIG-2025-11-A1B2C) è un identificativo, non un percorso URL.
  2. Includi Authorization: Bearer sur_live_YOUR_API_KEY (oppure X-API-Key: sur_live_...)
  3. Controlla i prefissi dei token quando concateni i report:
    • AI Visibility: SIG-YYYY-MM-XXXXX
    • Site Audit: SCN-YYYY-MM-XXXXX
    • Strategy: SOL-YYYY-MM-XXXXX
  4. Verifica nell’app di Surmado che il report esista nella tua organizzazione

Endpoint corretto: GET https://api.surmado.com/v1/reports/{report_id} con autenticazione Bearer. Vedi la Guida all’integrazione API.

Problema 15: l’integrazione con Zapier/Make/n8n non si attiva

Sintomo: l’automazione non parte quando un report Surmado è completato.

Cause comuni:

  1. webhook_url non incluso nella chiamata API di creazione del report
  2. L’endpoint del webhook restituisce un codice non 2xx (Surmado riprova 3 volte, poi rinuncia)
  3. HTTPS non usato per l’endpoint del webhook (è obbligatorio)
  4. Soluzione di ripiego con il trigger Gmail: filtro email troppo specifico (l’oggetto è cambiato, l’indirizzo del mittente è diverso)

Soluzione:

  1. Consigliato: usa i trigger basati su webhook. Includi webhook_url quando crei il report: il trigger “Catch Hook” (Zapier) / “Custom Webhook” (Make) / “Webhook” (n8n) della piattaforma riceve direttamente il payload di completamento.
  2. Usa webhook.site come URL di prova per confermare che Surmado invii la struttura di payload attesa prima di collegare l’automazione.
  3. Verifica la regex del token se lo estrai da un’email di ripiego:
    • AI Visibility: SIG-\d{4}-\d{2}-[A-Z0-9]{5}
    • Site Audit: SCN-\d{4}-\d{2}-[A-Z0-9]{5}
    • Strategy: SOL-\d{4}-\d{2}-[A-Z0-9]{5}
  4. Controlla le condizioni del filtro: il payload del webhook include event (ad es. report.completed) e report.product (signal, scan o solutions): filtra su questi.

Per saperne di più: Zapier, Make, n8n.

Problema 16: l’analisi del JSON non riesce nel codice o nell’automazione

Sintomo: l’API restituisce JSON ma il tuo parser non trova i campi attesi.

Cause comuni:

  1. Livello di annidamento sbagliato (il public_intelligence di AI Visibility e Site Audit ha sia un riepilogo summary sia un albero data)
  2. Valori null (alcuni campi sono null finché il report non è completato o quando i dati non sono disponibili)
  3. Aspettarsi che Strategy esponga public_intelligence: non lo fa; i dati di Strategy sono nel PDF

Soluzione:

  1. Usa i percorsi dei campi corretti:

    • Riepilogo curato: public_intelligence.summary.presence_score, public_intelligence.summary.seo_score
    • Albero completo: public_intelligence.data.visibility_metrics.ghost_influence_percentage, public_intelligence.data.audit_data.lighthouse.performance_score

  2. Gestisci i null in modo difensivo:

    summary = report.get("public_intelligence", {}).get("summary", {})
authority_score = summary.get("authority_score") or 0

  3. Controlla la risposta grezza con curl o con gli strumenti di sviluppo del browser prima di scrivere il parser

Per saperne di più: Dati strutturati e Intelligence Token, Guida all’integrazione API

Problemi di consegna e fatturazione

Problema 17: la consegna del report sta richiedendo più del previsto

Sintomo: hai ordinato AI Visibility/Site Audit/Strategy 30 minuti fa e il report non è ancora arrivato

Tempi di consegna previsti:

  • AI Visibility: circa 15 minuti (tipico)
  • Site Audit: circa 15 minuti (tipico)
  • Strategy: circa 15 minuti (tipico)

Se il ritardo supera 1 ora:

  1. Controlla la cartella spam (hi@surmado.com potrebbe essere filtrato)
  2. Controlla l’indirizzo email (verifica che la conferma d’ordine sia arrivata all’indirizzo giusto)
  3. Attendi 2 ore in tutto (dipende dal carico, alcuni report richiedono più tempo)

Se il ritardo supera 2 ore: scrivi a hi@surmado.com con i dettagli dell’ordine

E se qualcosa è andato storto? Abbiamo sistemi di rimborso automatico. Se non funzionano, scrivi a hi@surmado.com e rimedieremo.

Problema 18: addebito sbagliato

Sintomo: l’importo addebitato non corrisponde a quello che ti aspettavi

Soluzione: scrivi subito a hi@surmado.com indicando:

  • Data e ora dell’ordine
  • Indirizzo email usato
  • Livello ordinato e livello addebitato

Faremo: rimborso della differenza entro 1-2 giorni lavorativi

Problema 19: l’Intelligence Token non è incluso nel report

Sintomo: hai ricevuto il report PDF ma senza Intelligence Token

Soluzione:

  1. Controlla l’oggetto dell’email (il token è nell’oggetto: “Your AI Visibility Report - SIG-2025-11-A1B2C”)
  2. Controlla la pagina 1 del PDF (di solito il token è indicato in alto o in basso)
  3. Cerca nel PDF (Ctrl+F / Cmd+F per “SIG-”, “SCN-” o “SOL-”)

Se continua a mancare: scrivi a hi@surmado.com con i dettagli dell’ordine

Quando contattare l’assistenza

Scrivi a hi@surmado.com se:

  1. La consegna è in ritardo di oltre 2 ore
  2. Hai un problema di fatturazione (importo sbagliato, doppio addebito)
  3. Manca l’Intelligence Token nel report
  4. L’API restituisce 404 ma il formato del token è corretto
  5. Il report contiene errori (le metriche non hanno senso, i dati sembrano sbagliati)
  6. Vuoi un rimborso (entro 7 giorni dall’ordine)
  7. Ti serve aiuto con un’integrazione tecnica (configurazione di Zapier, Make, n8n)

Cosa includere nell’email all’assistenza:

  • Intelligence Token (se ce l’hai)
  • Data e ora dell’ordine
  • Indirizzo email usato per l’ordine
  • Descrizione precisa del problema
  • Schermate (se utili)

Tempi di risposta previsti: 1-2 giorni lavorativi (di solito meno)

Soluzioni fai da te (provale per prime)

Prima di contattare l’assistenza, prova a:

Per AI Visibility:

  1. Leggere Il primo report AI Visibility: e adesso?
  2. Controllare se un Presence Rate dello 0% è normale (attività nuova o locale)
  3. Verificare che un Authority Score nullo sia previsto (se il Presence Rate è 0%)

Per Site Audit:

  1. Leggere Il primo report Site Audit: e adesso?
  2. Filtrare solo i problemi di gravità alta (non cercare di correggerli tutti e 62)
  3. Verificare che un Overall Score < 70 sia correggibile (non è un guasto)

Per Strategy:

  1. Leggere Il primo report Strategy: e adesso?
  2. Cercare il consenso (4+ modelli concordi)
  3. Concentrarti sulle prospettive di CFO/COO se le altre non sono chiare

Per l’API:

  1. Testare l’endpoint del report con curl: curl https://api.surmado.com/v1/reports/{report_id} -H "Authorization: Bearer sur_live_YOUR_API_KEY"
  2. Controllare il formato del token (nessuno spazio, prefisso corretto: SIG-, SCN- o SOL-)
  3. Leggere Dati strutturati e Intelligence Token e la Guida all’integrazione API

Equivoci comuni

“Il mio Presence Rate è del 18%: significa che sto fallendo?”

No. Il 18% è il punto di partenza di molte piccole imprese. Significa che l’IA ti menziona nel 18% delle domande dei clienti. Il tuo obiettivo: migliorare al 25%, 35%, 45% nel tempo. Non è un fallimento, è un punto di partenza.

“Site Audit ha trovato 62 problemi: significa che il mio sito è pessimo?”

No. La maggior parte dei siti ha 40-80 problemi (se li testi a fondo). 5-15 sono di gravità alta (correggi quelli). 20-40 sono di gravità bassa (utili da avere, non urgenti). Niente panico.

“Strategy mi ha dato 3 raccomandazioni diverse: quale è giusta?”

Sono tutte valide. La raccomandazione #1 ha il consenso più alto. La #2 e la #3 sono alternative (profili di rischio e rendimento diversi). Scegli in base alle tue priorità (propensione al rischio, budget, tempi).

“Il mio concorrente è #1 ma offre un servizio peggiore: perché?”

L’IA vede ciò che è pubblicato, non la realtà. Se il concorrente ha un markup schema migliore, più contenuti e un posizionamento più chiaro sul suo sito, l’IA lo raccomanderà anche se il tuo servizio è oggettivamente migliore. Correggi ciò che l’IA vede (il tuo sito).

“Il mio Intelligence Token è una password?”

No. Il token è un identificativo, non una chiave. Per leggere i dati di un report serve la tua chiave API (Authorization: Bearer sur_live_YOUR_API_KEY), quindi un token da solo non apre nulla. Tieni privata la tua chiave API.

Sei ancora bloccato? Scrivi a hi@surmado.com con il tuo Intelligence Token e il problema specifico. Ti aiuteremo. Se qualcosa è andato storto con il tuo report, rimedieremo.

Continua a imparare con queste guide correlate

SEO Tecnico

Surmado API Integration Guide

Everything an external developer needs to create an API key, generate reports, and plug Surmado into automated workflows.

Leggi articolo
Strategy

Maximizing ROI with Strategy Board

Learn how to use Surmado Strategy to turn AI visibility findings into concrete strategy. Six AI advisors debate your decision and build a 90-day action plan.

Leggi articolo
Guide ai Prodotti

How to Read Your Surmado Site Audit SEO Report

Decode every section of your $50 Surmado Site Audit -- performance, accessibility, security, and SEO -- so you can assign fixes that actually raise your score.

Leggi articolo