# dfaimetagen — Generatore IA massivo di meta title, descrizioni e ALT

> Panoramica dfaimetagen genera in massa i tuoi meta title, meta description e tag ALT delle immagini tramite IA (Anthropic Claude, OpenAI GPT o Mistral) su PrestaShop 8 e 9. Il…

- Pagina: <https://www.datafirefly.com/it/documentation/dfaimetagen/>
- Lingua: it
- Aggiornato il: 2026-07-02
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfaimetagen/index.md), [en](https://www.datafirefly.com/en/documentation/dfaimetagen/index.md), [es](https://www.datafirefly.com/es/documentation/dfaimetagen/index.md), [de](https://www.datafirefly.com/de/documentation/dfaimetagen/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfaimetagen/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfaimetagen/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfaimetagen/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## Panoramica

dfaimetagen genera in massa i tuoi meta title, meta description e tag ALT delle immagini tramite IA (Anthropic Claude, OpenAI GPT o Mistral) su PrestaShop 8 e 9. Il modulo copre 6 tipi di entità (prodotti, categorie, pagine CMS, produttori, fornitori, immagini prodotto), applica pattern CTR collaudati, produce varianti A/B, controlla le lunghezze SERP e rifiuta i duplicati tramite similarità di Jaccard.

## Requisiti

- PrestaShop 8.0 a 9.x
- PHP 8.1, 8.2, 8.3 o 8.4
- Estensioni PHP: curl, json, iconv
- MySQL 5.7+ o MariaDB 10.3+
- Una chiave API presso almeno un provider: [Anthropic](https://console.anthropic.com), [OpenAI](https://platform.openai.com) o [Mistral](https://console.mistral.ai)

## Installazione

1. Scarica `dfaimetagen.zip` dal tuo account cliente.
2. Nel back-office di PrestaShop, vai su **Moduli > Gestore moduli > Carica un modulo**.
3. Carica lo ZIP e clicca su **Installa**.
4. Il modulo crea 6 tabelle nel database (prefisso `df_aimeta_`), installa 11 pattern CTR predefiniti e genera un token CRON casuale.
5. Una nuova scheda **AI Meta Generator** appare sotto il menu **Catalogo**.

## Configurazione del provider IA

1. Vai su **Catalogo > AI Meta Generator > Impostazioni**.
2. Seleziona il tuo provider attivo: Anthropic, OpenAI o Mistral.
3. Incolla la tua chiave API nel campo corrispondente.
4. Clicca sul pulsante **Test** accanto al campo per verificare la connettività — dovresti ricevere la risposta «OK».
5. I modelli predefiniti sono `claude-sonnet-4-5`, `gpt-4o-mini` e `mistral-large-latest`. Puoi modificarli se preferisci un altro modello dello stesso provider.

Le chiavi API sono memorizzate nella tabella Configuration di PrestaShop e mai esposte lato front-office. Il modulo non include crediti IA: ogni generazione consuma la tua quota presso il provider (circa 0,0005 a 0,003 € per generazione).

## Impostazioni di generazione

Sempre in **Impostazioni**, puoi regolare:

- **Limiti di lunghezza** — allineati per impostazione predefinita alle raccomandazioni Google SERP: meta title 35–60 caratteri, meta description 120–158, ALT 25–125. Se l'IA supera, il testo viene troncato in modo pulito su un confine di parola.
- **Varianti A/B per elemento** — da 1 a 5 alternative generate per entità e per lingua.
- **Soglia anti-duplicazione** — percentuale di similarità di Jaccard oltre la quale una variante viene rifiutata (85 % per impostazione predefinita). Il confronto è insensibile agli accenti.
- **Dimensione del lotto** — numero di elementi elaborati per tick AJAX o CRON (10 per impostazione predefinita, fino a 100).
- **Timeout HTTP** — attesa massima di una risposta del provider (60 s per impostazione predefinita).
- **Sovrascrivi / Ignora non vuoti** — comportamento predefinito verso i meta già compilati.

## Avviare una generazione in massa

1. Vai su **Catalogo > AI Meta Generator > Bulk Generation**.
2. **Entità**: prodotti, categorie, pagine CMS, produttori, fornitori o immagini prodotto.
3. **Campo**: meta title, meta description o ALT immagine (gli ALT si applicano alle immagini prodotto).
4. **Pattern CTR**: scegli un pattern specifico o lascia _Auto_ per usare il pattern predefinito del campo.
5. **Lingue**: selezione multipla — la generazione si moltiplica (elementi × lingue).
6. **Ambito**: tutte le entità, per elenco di ID, o per filtro categoria / produttore.
7. **Limite**: imposta 10 o 20 per un test, 0 per elaborare tutto.
8. Clicca su **Crea job**.

Inizia sempre con un job limitato a 10–20 elementi per validare il tono e il formato dei testi generati, regola il pattern o il template se necessario, poi rilancia senza limite.

## Monitorare ed eseguire i job

La pagina **Jobs** elenca tutti i job con il loro avanzamento, le statistiche (riusciti / falliti / ignorati) e lo stato. Tre modalità di esecuzione:

- **Esegui fino al completamento** (pagina di dettaglio del job) — elabora i lotti in loop via AJAX con barra di avanzamento in tempo reale. Tieni la scheda aperta.
- **Esegui un lotto** — elabora un singolo lotto e ricarica la pagina.
- **CRON** — elaborazione in background, consigliata per cataloghi di grandi dimensioni (vedi sotto).

Un job può essere annullato in corso, riavviato dall'inizio o eliminato. La cronologia completa di ogni generazione (stato, token in ingresso/uscita, eventuale errore) è conservata nella scheda Cronologia del dettaglio del job.

## Configurare il CRON

1. In **Impostazioni**, sezione CRON, copia l'URL visualizzato. Ha la forma: `https://il-tuo-negozio.com/modules/dfaimetagen/cron.php?token=IL_TUO_TOKEN`
2. Aggiungilo al crontab del tuo server, ad esempio ogni 5 minuti: `*/5 * * * * curl -s "https://il-tuo-negozio.com/modules/dfaimetagen/cron.php?token=IL_TUO_TOKEN" >/dev/null`
3. Ogni passaggio elabora fino a 5 lotti del job in attesa più vecchio. Parametri opzionali: `&batch=20` (dimensione del lotto) e `&loops=10` (lotti per passaggio).

Il token protegge l'endpoint: non condividerlo. In caso di dubbio, rigeneralo dalle Impostazioni (pulsante «Rigenera token») — ricordati poi di aggiornare il crontab.

## Varianti A/B e attivazione

Ogni generazione produce il numero di varianti configurato (1 a 5). La prima variante valida viene scritta sull'entità e contrassegnata come **Attiva**. Le altre restano in riserva nella pagina di dettaglio del job:

- Clicca su **Attiva** accanto a una variante per scriverla immediatamente sull'entità.
- Le altre varianti dello stesso triplo (entità, campo, lingua) vengono disattivate automaticamente.
- Il contatore di caratteri di ogni variante permette di verificare la conformità SERP a colpo d'occhio.

## Pattern CTR

Gli 11 pattern preinstallati coprono tre famiglie:

- **Meta title**: beneficio + anno, lista numerata, USP tra parentesi, domanda gancio, parole di potere.
- **Meta description**: accumulo di benefici, prova sociale, problema-soluzione, CTA diretto.
- **ALT immagini**: descrittivo, contestuale.

Per creare i tuoi pattern, vai su **Catalogo > AI Meta Generator > Patterns**. Il template accetta token dinamici:

- `{NAME}`, `{BRAND}`, `{CATEGORY}`, `{PRICE}`, `{YEAR}`, `{NUMBER}`, `{LANG_NAME}` — compilati automaticamente dal modulo;
- `{BENEFIT}`, `{USP}`, `{CONTEXT}` — compilati dall'IA al momento della generazione.

I pattern contrassegnati come «sistema» sono forniti con il modulo e conservati durante gli aggiornamenti.

## Template di prompt avanzati

Per un controllo totale del comportamento dell'IA, crea template in **Catalogo > AI Meta Generator > Prompt Templates**. Ogni template mira a un triplo (entità, campo, lingua — o tutte le lingue) e definisce:

- il **system prompt** — ruolo, tono, vincoli globali;
- lo **user prompt** — con i token `{NAME}`, `{BRAND}`, `{CATEGORY}`, `{DESCRIPTION}`, `{PRICE}`, `{PATTERN}`, `{LANG_NAME}`, `{MIN_LENGTH}`, `{MAX_LENGTH}`, `{AB_VARIANTS}`, `{EXISTING}`.

Contrassegna un template come «predefinito» affinché si applichi automaticamente al suo triplo.

## Anti-duplicazione

Prima di conservare una variante, il modulo la confronta con le varianti già memorizzate:

1. **Hash esatto** (sha1 della versione normalizzata) — rifiuto immediato in caso di duplicato perfetto.
2. **Similarità di Jaccard** sugli insiemi di parole normalizzate (minuscole, senza accenti) — rifiuto se la similarità supera la soglia configurata.

Una variante rifiutata viene rigenerata automaticamente dall'IA (entro il limite di tentativi del lotto).

## Dashboard

La pagina **Dashboard** aggrega: numero di job (totale, in attesa, completati), varianti generate e attive, generazioni riuscite / fallite, token consumati (ingresso + uscita), ultimi job e ultime generazioni. Usala per monitorare il budget IA e rilevare gli errori del provider.

## Multi-negozio

Il modulo legge e scrive i valori tenendo conto del contesto negozio quando la tabella `*_lang` interessata possiede una colonna `id_shop`. Seleziona il negozio di destinazione nel modulo di generazione in massa se la tua installazione è multi-negozio.

## Risoluzione dei problemi

- **«FAIL» al test di connettività** — verifica la chiave API, il saldo crediti del provider, e che il tuo server permetta connessioni HTTPS in uscita (cURL) verso api.anthropic.com, api.openai.com o api.mistral.ai.
- **Job bloccato in «running»** — rilancia un lotto manualmente dalla pagina di dettaglio, o attendi il prossimo passaggio CRON. Un job può sempre essere annullato e rilanciato.
- **Varianti vuote o troncate** — aumenta il timeout HTTP nelle Impostazioni, o scegli un modello più veloce.
- **403 sull'URL CRON** — il token dell'URL non corrisponde più (potrebbe essere stato rigenerato). Copia di nuovo l'URL dalle Impostazioni.
- **Nulla viene generato per alcune entità** — se «Ignora non vuoti» è attivo, le entità già compilate vengono saltate di proposito. Spunta «Sovrascrivi» per forzare.

## Disinstallazione

La disinstallazione elimina le 6 tabelle del modulo e le sue chiavi di configurazione. I meta generati e già scritti sui tuoi prodotti, categorie e immagini vengono conservati: fanno parte del tuo catalogo.