Errori ads.txt di Adgora su Shopify

Definizione: cosa significa questo errore su Shopify

“Errore ads.txt Adgora Shopify” significa che Adgora ha controllato il tuo negozio e non è riuscito a leggere il file ads.txt nel modo previsto. Di solito questo indica una di queste quattro cose: il file manca, il file è bloccato, il file si trova sull’host sbagliato oppure la riga del venditore Adgora non è visibile nel file.

L’espressione sembra tecnica, ma il problema reale è semplice. Adgora vuole trovare un file di testo semplice nella root pubblica dello store e, se Shopify mostra qualcos’altro in quel punto, il controllo fallisce. Basta anche solo una riga mancante.

Pensa ad ads.txt come a una breve dichiarazione pubblica. Una sola riga può contare più di una lunga modifica al tema. Se il crawler non riesce a far corrispondere il dominio dello store e la voce Adgora attesa, la piattaforma può segnalare il negozio anche quando la vetrina sembra normale per i clienti.

Ecco perché l’errore può sembrare strano. La homepage si carica, i prodotti si caricano e il checkout funziona, ma Adgora continua a segnalare lo store. Il problema sta nel percorso del file, nell’host o nel testo esatto.

ads.txt su Shopify: come Shopify gestisce il file

Shopify gestisce Shopify ads.txt tramite il proprio meccanismo a livello di store, non tramite una pagina del tema o un post del blog. Questo è importante perché un file di testo nell’editor del tema non è la stessa cosa di un file ads.txt pubblico nella root dello store.

In pratica, Shopify si aspetta che il file ads.txt sia disponibile nella root del dominio, dove i crawler possono richiederlo direttamente. Una pagina come /pages/ads-txt non conta, e neppure uno snippet nascosto nel codice liquid del tema, a meno che Shopify non stia effettivamente pubblicando il file nella posizione pubblica corretta. Se vedi un avviso come ads.txt Shopify non trovato, il problema è quasi sempre legato a questa distinzione.

Questa distinzione manda in confusione molte persone ogni settimana. Un proprietario dello store può incollare la riga di Adgora nel tema, salvare e pensare che il lavoro sia fatto. Ma non lo è.

Shopify presta attenzione anche a quale host è primario. Se lo store usa un dominio personalizzato, il file deve comunque risolvere correttamente sull’host che Adgora controlla, e non solo su un indirizzo di staging o su una versione alternativa della vetrina.

Un piccolo dettaglio può cambiare il risultato. Se il file root è presente su www ma Adgora controlla il dominio senza prefisso, oppure il contrario, il crawler potrebbe non vedere affatto la riga.

Cause comuni su Shopify dietro gli errori ads.txt di Adgora

Diverse scelte di configurazione su Shopify causano lo stesso errore. La più comune è una mancata corrispondenza del dominio: lo store non ha ancora finito di puntare al dominio primario, quindi Adgora controlla un host mentre Shopify serve il file su un altro.

Anche gli host duplicati della vetrina creano problemi. Uno store può apparire sul dominio personalizzato, sulla versione www e talvolta su un indirizzo assegnato da Shopify durante la configurazione, ma solo uno di questi dovrebbe essere l’host canonico. Se Adgora esegue la scansione dell’host sbagliato, può segnalare un file ads.txt mancante anche se il file esiste altrove.

Anche i conflitti con file generati da app sono una fonte di problemi. Alcune app o script cercano di creare o riscrivere file del sito, e questo può sovrascrivere la configurazione di Shopify ads.txt. Un file che a mezzogiorno sembrava corretto può sparire nel pomeriggio.

Anche il comportamento dei redirect conta. Se la richiesta alla root di /ads.txt arriva a una pagina che reindirizza in modo anomalo, restituisce un errore lieve o allontana il crawler dalla root reale dello store, Adgora potrebbe non accettare il risultato. Non è un problema del tema; è un problema di host e di risposta.

C’è poi il caso semplice di una riga incompleta. La riga di relazione del venditore Adgora può mancare, essere incompleta o essere copiata con un identificatore errato. Basta anche un solo carattere sbagliato.

Gli store ancora in migrazione corrono un rischio speciale. Durante un trasferimento di dominio, il vecchio host può continuare a rispondere alle richieste mentre il nuovo host è già attivo per i clienti, e questa separazione può confondere il controllo del file da parte di Adgora.

Correggere ads.txt su Shopify: il percorso più breve e sicuro

Per come correggere ads.txt su Shopify, inizia dal dominio primario. Apri le impostazioni dello store e verifica quale host è canonico, perché il file deve funzionare dove Adgora sta effettivamente guardando.

Poi verifica che Shopify sia il sistema che pubblica il file. Non affidarti a uno snippet del tema, a una pagina del blog o a un blocco di contenuto nascosto. Il file dovrebbe essere accessibile come file di testo a livello root, non come una normale pagina web.

Quindi controlla la riga di Adgora. La riga deve comparire nel file pubblico, esattamente come richiesto, e deve trovarsi solo sull’host corretto. Se lo store usa un dominio personalizzato, prova sia la versione senza www sia quella con www per capire quale delle due punta al file.

Dopodiché ripubblica o ricontrolla la vetrina. A volte l’aggiornamento è immediato; altre volte il crawler ha bisogno di tempo per tornare a leggere il file. Una nuova scansione può eliminare un avviso ormai obsoleto.

Se l’errore persiste dopo un controllo pulito, ispeziona la risposta live del file. Un codice 200 non basta da solo se il contenuto è sbagliato o l’host non è quello che Adgora si aspetta.

Ecco la sequenza pratica in un unico elenco:

1. Conferma il dominio primario.
2. Apri l’URL live /ads.txt.
3. Controlla che Shopify stia servendo il file.
4. Verifica la riga di Adgora.
5. Ricontrolla dopo l’aggiornamento dello store.

Dove inserire la riga di Adgora in uno store Shopify

La riga di Adgora va inserita nel file ads.txt pubblico nella root del dominio. È l’unico punto che conta per i controlli dei crawler.

Non inserirla solo nel codice del tema. Non inserirla solo in una pagina, in una voce di menu o in un articolo del blog. I motori di ricerca possono indicizzare quelle pagine, ma la validazione di ads.txt riguarda un percorso file specifico, non i contenuti generali del sito.

Se lo store usa come primario il dominio senza prefisso, prova prima proprio quel dominio esatto. Se il canonico è www, prova prima www. Una discrepanza tra queste due versioni può generare un falso allarme.

Un’abitudine utile è aprire il file nel browser e leggere con attenzione la barra degli indirizzi. L’indirizzo dovrebbe essere l’host live dello store più /ads.txt, senza altro. Un redirect di troppo può alterare il risultato.

Per gli store con più lingue o varianti regionali, mantieni il file ads.txt sull’host principale che Adgora controlla. Una landing page in francese o un sottopercorso per un mercato alternativo non sostituisce il file root.

Una breve nota: molti merchant si fidano troppo dell’editor del tema. Il tema serve per il design della vetrina. ads.txt è un controllo su un file.

Esempi di voci ads.txt per store Shopify

Ecco un semplice esempio di come può apparire una riga ads.txt valida per Adgora in uno store Shopify:

Usa l’esempio solo come struttura, non come risposta finale. Il valore esatto del publisher o del seller di Adgora deve corrispondere ai dati dell’account.

Un altro errore comune è scrivere una riga senza i separatori corretti. Una virgola mancante o un identificatore rotto possono rendere la voce illeggibile, anche se a occhio sembra quasi giusta.

Esempio di formato sbagliato: una riga incollata come testo normale in un paragrafo della homepage. Quello è contenuto, non ads.txt.

Esempio di host sbagliato: il file esiste su shop-name.myshopify.com, ma ora lo store usa un dominio personalizzato. Adgora potrebbe controllare il dominio personalizzato e non trovare nulla.

Se vuoi una panoramica più ampia dei formati pubblicitari legati a questo tipo di configurazione, la guida ई-कॉमर्स स्टोर्स के लिए क्रिप्टो विज्ञापन mostra come il traffico dello store e i controlli dei file spesso si incontrino nello stesso punto operativo.

Termini correlati e cosa controllare dopo

ads.txt è il file di testo pubblico che elenca i venditori autorizzati. Non è una pagina, non è un banner e non è una nota nascosta del tema.

Dominio primario è l’host principale che Shopify usa per lo store. Se è sbagliato, il controllo del file può puntare nel posto sbagliato.

Host canonico è la versione del dominio che dovrebbe rispondere per prima alla richiesta. Per uno store Shopify, può essere il dominio senza prefisso o www, ma non entrambi come leader concorrenti.

Riga di relazione del venditore è la voce esatta che Adgora si aspetta nel file. Se questa riga manca o è malformata, l’errore può continuare anche quando il file è pubblico.

Crawler è il bot che recupera il file. Non gli interessano le impostazioni del tema; gli interessano l’URL, la risposta e il testo che riesce a leggere.

Sovrascrittura della vetrina avviene quando un’app, uno strumento di sincronizzazione o un passaggio di deploy sostituisce il file dopo che lo hai corretto. Ecco perché il problema può tornare dopo un aggiornamento riuscito.

Se il file è corretto nel browser ma Adgora segnala ancora un problema dopo un nuovo controllo, raccogli due elementi: uno screenshot della pagina live /ads.txt e l’URL esatto che hai testato. Poi contatta l’assistenza con questi dettagli. Più la prova è precisa, più veloce sarà la verifica.

Un controllo finale dovrebbe richiedere meno di 5 minuti. Apri il file live, conferma l’host, leggi la riga di Adgora e fai una nuova prova dopo ogni modifica a Shopify. Se il file si sposta, l’errore può spostarsi con lui.

Per i team che gestiscono anche annunci su altri formati, l’aspetto operativo del traffico dello store è trattato nella guida alle opzioni di targeting della rete pubblicitaria crypto, utile una volta che il file è stabile e lo store è tornato ai controlli normali.