PS PrestaShop Intermedio

DataFirefly Google Shopping — Guida completa

Installazione, feed per paese / lingua / valuta, categorie Google, regole, sostituzioni, problemi, Merchant API e suggerimenti IA facoltativi, cron e risoluzione dei problemi del modulo Google Shopping per PrestaShop 1.7.8, 8 e 9.

Aggiornato Versione del modulo 2.0.0

Panoramica

DataFirefly Google Shopping genera i Suoi feed Google Merchant Center da PrestaShop: prodotti, inventario locale e promozioni, un feed per negozio, paese, lingua e valuta. Controlla ogni articolo rispetto alla specifica dei dati di prodotto di Google, mostra ciò che ha rilevato e Le permette di correggerlo con categorie, regole e sostituzioni prima che Google legga il feed. La Merchant API e i suggerimenti IA sono facoltativi.

Il modulo aggiunge un menu Google Shopping sotto Migliora con 10 pagine: Pannello, Feed, Categorie Google, Regole, Prodotti, Problemi, Suggerimenti IA, Analisi, Importa / esporta e Impostazioni. Crea 18 tabelle con prefisso dfgs_, non esegue l’override di alcuna classe PrestaShop e non modifica alcun file del core.

Il modulo segue la specifica di Google, ma solo Google decide sull’approvazione e sulla visualizzazione dei Suoi prodotti. L’indicatore di qualità della dashboard è un controllo interno di completezza, non un punteggio Google.

Requisiti

  • PrestaShop 1.7.8, 8.x o 9.x.
  • PHP da 7.4 a 8.5 con le estensioni xmlwriter e zlib (openssl e curl per la Merchant API e l’IA).
  • Un account Google Merchant Center.

Installazione

  1. Nel back office, apra Moduli → Gestione moduli e clicchi su Carica un modulo.
  2. Selezioni dfexportgoogleshopping-2.0.0.zip. PrestaShop installa il modulo.
  3. Apra Migliora → Google Shopping. L’assistente di configurazione si avvia alla prima visita.

Aggiornamento dalla versione 1.x

Carichi lo zip 2.0.0 sopra il modulo installato (stessa procedura dell’installazione). L’aggiornamento:

  • mantiene i Suoi feed, il loro URL pubblico, il loro token e gli ID articolo della versione 1.x, quindi Merchant Center conserva i Suoi prodotti;
  • riprende le associazioni delle categorie, le sostituzioni dei prodotti e le impostazioni;
  • cifra le chiavi API memorizzate dalla versione 1.x;
  • lascia disattivata la sincronizzazione Merchant API finché non la configura (la Content API for Shopping usata dalla 1.x è stata dismessa da Google);
  • rimuove i vecchi file della 1.x, compresa la cartella feeds/.

La versione 2.0.0 produce solo feed Google. Se un feed 1.x era impostato per Bing, Meta, Kelkoo, Idealo o LeGuide, il suo URL ora fornisce il formato Google: lo verifichi prima di mantenerlo in quel canale.

Dopo l’aggiornamento, apra la Pannello: i feed vengono generati di nuovo alla prima esecuzione del cron o quando clicca su Genera.

Assistente di configurazione

Quattro passaggi: paesi, lingua e valuta, spedizione, poi le categorie Google delle Sue categorie principali. L’assistente crea un feed per ogni paese selezionato. Tutto può essere modificato in seguito in Feed e Categorie Google.

Feed

In Feed, ogni scheda mostra il paese, la lingua, la valuta, gli articoli inviati ed esclusi, l’indicatore di qualità e l’URL del feed (mascherato; Copia URL lo copia). Azioni: Genera, Anteprima, Cronologia, Impostazioni, Disattiva, Duplica.

Le impostazioni del feed hanno cinque schede:

  • Destinazione: tipo di feed (prodotti, inventario locale, promozioni), nome, negozio, paese di destinazione, lingua, valuta, prezzi (automatico: senza imposte per Stati Uniti e Canada, IVA inclusa altrove), formato dell’ID articolo, destinazioni e destinazioni escluse. Mantenga il formato dell’ID articolo di un feed esistente: modificarlo fa vedere a Merchant Center dei nuovi prodotti.
  • Prodotti: solo alcune categorie e marche oppure tutte tranne alcune, prezzo minimo e massimo, ID prodotti esclusi, prodotti esauriti.
  • Titoli e testi: modello di titolo con i token {name}, {brand}, {attributes}, {color}, {size}, {material}, {category}, {reference}, {feature:Name} e un’anteprima dal vivo sui prodotti del feed; valori della combinazione nel titolo; rimozione delle parole promozionali e delle maiuscole enfatiche; origine della descrizione, punti salienti tratti dagli elenchi puntati della descrizione, dettagli del prodotto tratti dalle caratteristiche, marca usata quando un prodotto non ne ha.
  • Spedizione: nessuna, un prezzo fisso con una soglia di spedizione gratuita, o un corriere PrestaShop; nome del servizio e tempi di consegna facoltativi.
  • Avanzate: dimensione dell’immagine inviata, parametri di tracciamento aggiunti ai link e Cambia l’URL pubblico.

Dichiarare il feed in Merchant Center

  1. Clicchi su Copia URL sulla scheda del feed.
  2. In Merchant Center, aggiunga un’origine prodotti da un file con recupero pianificato e incolli l’URL.
  3. Scelga lo stesso paese e la stessa lingua del feed.

L’URL contiene un token di 40 caratteri. Se è stato divulgato, usi Cambia l’URL pubblico nella scheda Avanzate: il vecchio URL smette subito di funzionare e deve essere sostituito in Merchant Center. I file dei feed sono memorizzati in var/dfgs_feeds/ con un nome non indovinabile e vengono serviti solo tramite questo URL, sia su Apache sia su nginx.

Anteprima articolo

Anteprima su un feed calcola, per il prodotto scelto, ciò che questo feed invierebbe in questo momento: una scheda in stile Shopping, il prezzo e il prezzo scontato, i problemi rilevati e ogni attributo. La usi per controllare un prodotto prima o dopo una modifica.

Generazione, cronologia e cron

La generazione avviene per lotti. Se viene interrotta, l’esecuzione successiva riprende dal punto in cui si era fermata; un blocco impedisce due esecuzioni contemporanee dello stesso feed. Al termine, il modulo verifica che l’XML sia ben formato, scrive una copia gzip e confronta gli articoli con la generazione precedente.

Cronologia elenca le ultime 30 generazioni (attivazione, articoli inviati ed esclusi, indicatore, differenze, tempo, memoria, dimensione, controllo XML) e le differenze campo per campo di un articolo.

Per rigenerare automaticamente i feed, chiami l’URL cron indicato in Impostazioni (ad esempio ogni ora); Rigenerare ogni feed al massimo ogni stabilisce ogni quanto un feed deve essere rigenerato (da 1 a 24 ore). Ogni chiamata genera i feed da rigenerare, entro circa 25 secondi, e riprende alla chiamata successiva se necessario; quando la Merchant API è attivata, invia anche le modifiche ai prodotti in coda.

0 * * * * curl -s "https://www.example.com/index.php?fc=module&module=dfexportgoogleshopping&controller=cron&token=YOUR_CRON_TOKEN" > /dev/null

Categorie Google

La tassonomia dei prodotti Google (versione 2021-09-21) è inclusa in 8 lingue: la ricerca avviene in locale, senza chiamate a Google. Per ogni categoria del negozio, digiti alcune parole e scelga la categoria Google. Una sottocategoria eredita la scelta della categoria superiore finché non ne imposta una propria. Per l’abbigliamento, imposti il genere e la fascia d’età: sono obbligatori in diversi paesi.

Regole

Una regola ha delle condizioni (categoria, marca, prezzo, quantità, titolo, riferimento, condizione, GTIN presente, categoria Google presente, in promozione, disponibilità) e un’azione: escludere l’articolo, impostare un’etichetta personalizzata da 0 a 4, aggiungere un prefisso o un suffisso al titolo, sostituire o rimuovere parole. Le regole vengono eseguite dall’alto verso il basso a ogni generazione, per tutti i feed o per un solo feed. Anteprima mostra gli articoli corrispondenti prima e dopo la regola.

Prodotti e sostituzioni

Prodotti elenca i Suoi prodotti con il titolo inviato, GTIN, marca, MPN, condizione, categoria Google e stato. Faccia doppio clic su una cella per modificarla; selezioni dei prodotti per applicare un’azione in blocco (escludere da Google, includere, condizione, genere, fascia d’età, marca, categoria Google, etichetta personalizzata, rimuovere le sostituzioni).

Dettagli apre le sostituzioni di un prodotto, per l’intero prodotto o per una combinazione, e per ogni lingua: titolo, descrizione, punti salienti, colore, taglia, materiale, tipo di prodotto, GTIN, MPN, marca, categoria Google, etichette personalizzate. A destra, l’anteprima mostra ciò che Google riceverà. Le sostituzioni modificano solo il feed, mai il Suo catalogo. Un GTIN viene rifiutato se la lunghezza, la cifra di controllo o il prefisso non sono validi.

Problemi

Problemi elenca ciò che il modulo ha rilevato nell’ultima generazione, per tipo (escluso, avviso, informazione), con le azioni da intraprendere e gli articoli interessati. La Verifica GTIN del catalogo controlla ogni GTIN del catalogo. Quando la Merchant API è attivata, i problemi segnalati da Google compaiono in una sezione a parte.

Merchant API (facoltativa)

  1. In Google Cloud, crei un progetto, attivi la Merchant API e crei un account di servizio con una chiave JSON.
  2. In Merchant Center, aggiunga l’indirizzo e-mail dell’account di servizio come utente.
  3. In Impostazioni → Merchant API, inserisca l’ID del Suo account Merchant Center e la chiave JSON (memorizzata cifrata, mai più visualizzata), poi clicchi su Verifica la connessione, Registra il progetto (una volta) e Crea l’origine dati API.
  4. Attivi Inviare le modifiche ai prodotti tramite la Merchant API (con il cron).

Il salvataggio di un prodotto lo aggiunge solo a una coda; il cron invia la coda e legge gli stati degli articoli. Gli errori di quota vengono ritentati più tardi con un intervallo crescente.

Suggerimenti IA (facoltativi)

In Impostazioni → IA, scelga il fornitore (Anthropic, OpenAI o Mistral), inserisca la Sua chiave API (memorizzata cifrata), il modello e un limite mensile. In Suggerimenti IA, scelga titoli, categorie Google o attributi, i prodotti e la lingua: il costo viene stimato prima dell’esecuzione.

Ogni suggerimento passa in In attesa di convalida con il valore attuale e il valore suggerito, che può modificare prima di cliccare su Applica. Nulla viene applicato senza il Suo clic. I titoli IA vengono inviati come contenuto generato dall’IA, come richiesto da Google. All’IA non viene mai chiesto un GTIN.

Analisi

  • Test dei titoli: due titoli si alternano per periodo per un prodotto. Inserisca le impressioni e i clic dai Suoi report Merchant Center o Google Ads. Un risultato è considerato significativo solo con almeno 1.000 impressioni per titolo, 30 clic in totale e p < 0.05; anche in questo caso, altri fattori (stagione, concorrenza, offerte) possono spiegare la differenza.
  • Query di ricerca: importi il CSV delle Sue query di Search Console; il modulo abbina ogni query a un prodotto e mostra le query le cui parole mancano nel titolo.
  • Stagionalità: prodotti le cui vendite passate si concentrano nei due mesi successivi, che può contrassegnare con un’etichetta personalizzata.
  • Verifica immagini: immagini dei prodotti troppo piccole (meno di 100 o 500 pixel sul lato corto), troppo allungate o più pesanti di 16 MB.

Avvisi

In Impostazioni → Avvisi, inserisca un indirizzo e-mail e/o un webhook Slack e scelga gli eventi: generazione non riuscita, calo dell’indicatore di qualità, nuovi problemi segnalati da Google.

Importa / esporta

Esporti e importi le sostituzioni in CSV (punto e virgola, UTF-8). Le celle che iniziano con =, +, - o @ vengono neutralizzate nell’esportazione. Questa pagina contiene anche l’elenco dei punti vendita del feed inventario locale e le promozioni del feed promozioni.

Dati strutturati (JSON-LD)

Disattivati per impostazione predefinita. In Impostazioni, Dati strutturati nelle pagine prodotto in modalità automatica aggiunge un blocco Product alla pagina prodotto solo quando la pagina non ne contiene già uno (tema, modulo SEO o di recensioni), con il prezzo mostrato nella pagina. Se il Suo tema ne genera già uno, lasci l’opzione disattivata.

Altri moduli DataFirefly

Quando sono installati, il feed tiene conto di: il prodotto confezione regalo (mai inviato), i prodotti bloccati da un’asta, i lotti con data di scadenza superata, la condizione e il grado dei ricondizionati, il prezzo unitario e i gruppi di prodotti del product linker (item_group_id).

Multistore e permessi

Ogni feed appartiene a un negozio e vede solo i suoi prodotti e le sue sostituzioni; in un contesto negozio, i feed degli altri negozi non possono essere aperti. Le azioni di scrittura richiedono il permesso di modifica sulla pagina: un dipendente con il solo permesso di visualizzazione può consultare ma non modificare nulla.

Risoluzione dei problemi

  • Il feed è vuoto: controlli le categorie e i filtri del feed, e che i prodotti siano attivati, visibili e disponibili per l’ordine nel negozio del feed. La pagina Problemi indica il motivo di ogni esclusione.
  • L’URL restituisce 404: il feed è disattivato, il token è stato rinnovato o il modulo è disattivato.
  • I prezzi sono diversi da quelli del negozio: controlli il paese e la valuta del feed e l’opzione delle imposte in Avanzate; Google si aspetta prezzi senza imposte per Stati Uniti e Canada.
  • Merchant API: errore di autenticazione: verifichi che l’account di servizio sia un utente dell’account Merchant Center e che il progetto sia registrato.
  • IA: non succede nulla: controlli la chiave, il modello e il limite mensile in Impostazioni → IA; il registro mostra la causa di ogni chiamata non riuscita.

Disinstallazione

La disinstallazione rimuove le 18 tabelle dfgs_, le impostazioni DFGS_, le pagine di amministrazione e i file dei feed generati. Esporti prima le Sue sostituzioni se desidera conservarle.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza